DataPathModule

PackageReified.Data
Helpers for constructing, parsing, and rendering structured data paths.

Summary

NameSignatureSynopsis
emptyDataPath.empty The root structured data path.
nameDataPath.name nameCreates a one-segment path for a named source field.
indexDataPath.index indexCreates a one-segment path for a zero-based collection index.
appendNameDataPath.appendName name pathAppends a named source field segment to an input path.
appendIndexDataPath.appendIndex index pathAppends a zero-based collection index segment to an input path.
ofSegmentsDataPath.ofSegments segmentsCreates a path from validated segments.
segmentsDataPath.segments pathReturns the segments in an input path.
toStringDataPath.toString pathRenders a structured data path using names, dot separators, and bracketed indexes.
tryParseDataPath.tryParse textAttempts to parse a structured data path such as contacts[1].value.
parseDataPath.parse textParses a structured data path or raises when the text is invalid.

empty

DataPath.empty
Member
The root structured data path.

Returns

DataPath

name

DataPath.name name
Member
Creates a one-segment path for a named source field.

Parameters

NameTypeDescription
namestring

Returns

DataPath

index

DataPath.index index
Member
Creates a one-segment path for a zero-based collection index.

Parameters

NameTypeDescription
indexint

Returns

DataPath

appendName

DataPath.appendName name path
Member
Appends a named source field segment to an input path.

Parameters

NameTypeDescription
namestring
pathDataPath

Returns

DataPath

appendIndex

DataPath.appendIndex index path
Member
Appends a zero-based collection index segment to an input path.

Parameters

NameTypeDescription
indexint
pathDataPath

Returns

DataPath

ofSegments

DataPath.ofSegments segments
Member
Creates a path from validated segments.

Parameters

NameTypeDescription
segmentsDataPathSegment seq

Returns

DataPath

segments

DataPath.segments path
Member
Returns the segments in an input path.

Parameters

NameTypeDescription
pathDataPath

Returns

DataPathSegment list

toString

DataPath.toString path
Member
Renders a structured data path using names, dot separators, and bracketed indexes.

Parameters

NameTypeDescription
pathDataPath

Returns

string

tryParse

DataPath.tryParse text
Member
Attempts to parse a structured data path such as contacts[1].value.

Parameters

NameTypeDescription
textstring

Returns

DataPath option

parse

DataPath.parse text
Member
Parses a structured data path or raises FormatException when the text is invalid.

Parameters

NameTypeDescription
textstring

Returns

DataPath