The import report

How to read the report the Pine importer shows: verdicts, numbers, the five groups of items, line links and the copied text.

Every file you convert gets a report card. It answers three questions: does the converted script run, did anything change meaning, and what is missing? Read it before you save, and keep it at hand while you check the script on a chart.

The converted script is printed in ChartScript's syntax (braces, const / let, state, &&, options objects). Those changes of form are not listed item by item: they never change a value. The report lists what can matter: changed meaning, missing output, substituted data and renamed built-ins.

#What is on the card

From top to bottom:

1. The file name (or Pasted script) and the verdict chip.
2. The numbers: how many of the original's statements, plots, drawings, alert conditions and inputs are still there, written as kept / total (for example Plots 12 / 12). A kind the script does not use is left out.
3. The license found in the header (License: MPL-2.0), or a plain warning for a non-commercial license.
4. The rights box, only when no license line was found: This is my own script or I have the right to use it. Save stays off until you tick it.
5. The items, in five groups that fold open and closed. Each group shows how many items it has. Blocking is open by default; open the others yourself.
6. The actions: Save to My scripts, Open in editor and Copy report as text. The first two appear only when the import produced a script.

#Verdicts

The verdict is worked out from the groups that have items:

#The five groups

The group names below are the exact labels on the card, in the order the card shows them.

#Blocking

Something stops the script from compiling or being imported at all.

#Meaning changed

The script runs, but on some bars it can give a different value from the original. These are the items to read carefully.

#Not drawn yet

Part of the script uses something ChartScript does not have yet. Those lines are kept as comments marked // [import], so the rest runs.

#Data substituted

The script asks for data ChartDeck does not have, or has under another name. The value is replaced, usually by na.

#Renamed (FYI)

The importer changed a name or a form, and the meaning is the same. You do not need to act on these; they are there so you can find your way around the converted text. Examples: alertcondition is alert.on in ChartScript., varip is live state in ChartScript (same meaning)., input(...) became input.int (typed input)., request.security became request.tf with at: request.close., Your name market is used by ChartScript; it became market_., the license line, and warnings that the original script had too.

#Line links

An item tied to a line starts with Line 14 → 17. The first number is the line in your original file; the second is the line in the converted script. The two drift apart as you go down the file, because the header adds a line and every block gains a closing } line, so always use the second number in the editor. Click it to open the converted script in the editor with the cursor on that line. The dialog closes, and the editor holds the converted script as a new, unsaved script.

Items about the whole file (the license, a missing library) have no line.

When the same compiler warning appears in many places, the report shows it once: The same warning appears 16 times (lines 40, 52, …). The link goes to the first place.

#What commented-out lines look like

Here is a strategy after import. Its strategy() became indicator(), the order line is a comment, and the emptied if block got an na so it still has a statement:

//@chartscript 1
// (imported) @version=5
indicator("Range breakout", { overlay: true })
const lookback = input.int(20, "Lookback")
const hi = ta.highest(high, lookback)[1]
const lo = ta.lowest(low, lookback)[1]
plot(hi, "High", color.green)
plot(lo, "Low", #FF5252)
const breakUp = ta.crossover(close, hi)
if (breakUp) {
    na  // [import] strategy.entry("L", strategy.long)
}
alert.on(breakUp, "Break up", "Range broken upward")

The #FF5252 is the importer keeping the version 5 shade of color.red, so the line looks as it did before.

#Copy report as text

Copy report as text puts the report on your clipboard as plain text: the verdict, the numbers, then each group under its short key ([blocking], [meaning], [notYet], [data], [fyi]) with the original line numbers. It is handy for keeping notes or asking for help:

Runs with changes
statements: 16 / 16
plots: 3 / 3
alerts: 1 / 1
inputs: 1 / 1

[meaning]
Line 2: This is a strategy. Strategies are not supported yet: it is imported as an indicator. ...
Line 6: The original looked into the future on past bars (lookahead on); ...

[fyi]
Line 3: input(...) became input.int (typed input).
Line 15: alertcondition is alert.on in ChartScript.

#When saving fails

Save to My scripts saves the libraries first, then the script. If the server refuses, the message says why, for example The converted script has 2.3 MB of code; a script can hold up to 2 MB. Comments and blank lines do not count., or The server could not compile it, line 40: … with an Open in editor button that goes to that line.