This is a logging library for Pinescript. It is aimed to help developers testing and debugging scripts with a simple to use logger function. Pinescript lacks a native logging implementation. This library would be helpful to mitigate this insufficiency. This library uses table to print outputs into its view. It is simple, customizable and robust. You can start using it's .log() method just like any other logging method in other languages.
////////////////// USAGE //////////////////
-- Recommended: Please Read The Documentation From Source Code Below. It Is Much More Readable There And Will Be Updated Along With Newer Versions. --
Importing the Library ---------------------
import paragjyoti2012/LoggerLib/<version_no> as Logger
.init() : Initializes the library and returns the logger pointer. (Later will be used as a function parameter)
.initTable: Initializes the Table View for the Logger and returns the table id. (Later will be used as a function parameter)
parameters: logger: The logger pointer got from .init() max_rows_count: Number of Rows to display in the Logger Table (default is 10) offset: The offset value for the rows (Used for scrolling the view) position: Position of the Table View Values could be: left right top-right (default is left)
size: Font Size of content Values could be: small normal large (default is small) hide_date: Whether to hide the Date/Time column in the Logger (default is false)
returns: Table
example usage of .initTable()
import paragjyoti2012/LoggerLib/1 as Logger
var logger=Logger.init() var logTable=Logger.initTable(logger, max_rows_count=20, offset=0, position="top-right")
logger: pass the logger pointer from .init() table_id: pass the table pointer from .initTable() message: The message to log type: Type of the log message Values could be: message warning error info success (default is message)
returns: void
/////////////////////////////////////// Full Boilerplate For Using In Indicator ///////////////////////////////////////
P.S: Change the | (pipe) character into square brackets while using in script (or copy it from the source code instead)
offset=input.int(0,"Offset",minval=0) size=input.string("small","Font Size",options=|"normal","small","large"|) rows=input.int(15,"No Of Rows") position=input.string("left","Position",options=|"left","right","top-right"|) hide_date=input.bool(false,"Hide Time")
import paragjyoti2012/LoggerLib/1 as Logger
var logger=Logger.init() var logTable=Logger.initTable(logger,rows,offset,position,size,hide_date)
//////////////////////////// // For Scrolling the Table View ////////////////////////////
There is a subtle way of achieving nice scrolling behaviour for the Table view. Open the input properties panel for the table/indicator. Focus on the input field for "Offset", once it's focused, you could use your mouse scroll wheel to increment/decrement the offset values; It will smoothly scroll the Logger Table Rows as well.
///////////////////// For any assistance using this library or reporting issues, please write in the comment section below. I will try my best to guide you and update the library. Thanks :) /////////////////////
Release Notes
v2 Bug Fixes and improvements.
Release Notes
v3
Updated: initTable()
log()
// Added Sticky Logs // --------------------------------- // Some logs could be sticked at the bottom of the logs. This type of of logs will be updated without adding more to the list of logs. // These kind of logs will be helpful to log at the last bar or logs that needs constant attention. // Maximum recommended rows is 5. Default is set to 0, so it won't show sticky logs without explicitly setting it. // To log a sticky log, you need to pass the stickPosition parameter (ranging from 1 to 5) in the .log() method.
In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in a publication is governed by House rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.