Skip to main content

Module source_map

Module source_map 

Source
Expand description

Source positions of the values in a workflow document.

A SourceMap maps document paths (graph.nodes[1].template, see DocPath) to the line and column of the YAML or JSON node they came from, so validation errors can point at the offending text. It is built by a second, span-aware parse of the same text and is best effort: when the text cannot be parsed, or the yaml feature (which provides the span-aware parser, also used for JSON) is disabled, the map is empty and diagnostics carry a path but no position.

Structs§

DocPath
Path of a value inside a workflow document, e.g. graph.nodes[1].template.
SourceMap
Positions of keys and values, by document path.
SourceSpan
A position in the source text. Lines and columns are 1-based and count characters, not bytes.

Enums§

PathSegment
One segment of a DocPath.