mtparser - v0.4.1

mtparser/helper

Shared construction and manipulation functions for the AST types: spans, lines, interpolated text, expressions, and the text/token utilities the statement parsers build on.

Values

all_but_last

</> 
pub fn all_but_last(items: List(a)) -> List(a)

arg_offset

</> 
pub fn arg_offset(
  span: ast.Span,
  full: String,
  arg: String,
) -> Int

Absolute offset of arg (a trim_start’ed suffix of full whose span is span).

comma_segments

</> 
pub fn comma_segments(arg: String) -> List(#(String, Int))

Comma-separated segments of arg, each trimmed (with its UTF-16 offset within arg); empty segments are kept.

drop_token

</> 
pub fn drop_token(s: String) -> String

drop_word

</> 
pub fn drop_word(s: String) -> String

dummy_span

</> 
pub fn dummy_span() -> ast.Span

Placeholder span for tests or unknown positions.

first_word

</> 
pub fn first_word(s: String) -> String

Leading identifier chars [a-zA-Z0-9_-] of a string.

gs_len

</> 
pub fn gs_len(gs: List(String)) -> Int

Total UTF-16 length of a list of graphemes.

is_alnum

</> 
pub fn is_alnum(g: String) -> Bool

is_digit

</> 
pub fn is_digit(g: String) -> Bool

is_ident

</> 
pub fn is_ident(g: String) -> Bool

is_literal

</> 
pub fn is_literal(text: List(ast.TextPart)) -> Bool

True if the text contains no variable references.

leading_ws

</> 
pub fn leading_ws(line: ast.Line) -> Int

line_span

</> 
pub fn line_span(line: ast.Line) -> ast.Span

Span of a line’s trimmed content.

merge_span

</> 
pub fn merge_span(a: ast.Span, b: ast.Span) -> ast.Span

Merge two spans into one covering both.

nth

</> 
pub fn nth(items: List(a), n: Int) -> Result(a, Nil)

The n-th element of a list.

prefix_len

</> 
pub fn prefix_len(s: String, n: Int) -> String

The first n UTF-16 units of a string.

span_to_string

</> 
pub fn span_to_string(span: ast.Span) -> String

“line L col C”

split_lines

</> 
pub fn split_lines(source: String) -> List(ast.Line)

Split source into lines.

\n separates lines; a trailing \r (CRLF files) stays in the text and is handled as trailing whitespace by consumers. The empty region after a final \n produces no line.

sub_span

</> 
pub fn sub_span(
  base: ast.Span,
  body: String,
  start: Int,
  len: Int,
) -> ast.Span

Span of a range inside body, which starts at base.offset (with base.line/base.column pointing at that position). Counts newlines so the line/column are real even when the command spans lines.

take_till_any

</> 
pub fn take_till_any(
  gs: List(String),
  stops: List(String),
) -> List(String)

take_till_list

</> 
pub fn take_till_list(
  gs: List(String),
  stop: String,
) -> Result(#(List(String), List(String)), Nil)

Graphemes before the first stop; Error when stop never occurs.

take_token

</> 
pub fn take_token(s: String) -> String

The first whitespace-delimited token of a string.

take_while_list

</> 
pub fn take_while_list(
  gs: List(String),
  pred: fn(String) -> Bool,
) -> #(List(String), List(String))

to_raw_string

</> 
pub fn to_raw_string(text: List(ast.TextPart)) -> String

Raw string form: variable references rendered with their $ prefix.

trim_start_list

</> 
pub fn trim_start_list(gs: List(String)) -> #(List(String), Int)

utf16_size

</> 
pub fn utf16_size(s: String) -> Int

Length of a string in UTF-16 code units — the unit JS string indexing (String.prototype.length, substring) and editors (VS Code/LSP) use for offsets. Supplementary-plane codepoints count as 2. All span offsets and lengths in this library are in these units.

variable_names

</> 
pub fn variable_names(text: List(ast.TextPart)) -> List(String)

All variable names referenced in this text, in order.

ws_tokens

</> 
pub fn ws_tokens(arg: String) -> List(#(String, Int))

Whitespace-separated tokens of arg, each with its UTF-16 offset within arg (which must be trim_start’ed — the first token starts at 0).

✨ Search Document