module

Analyzer::Clojure::Helper

Shared helpers for the Clojure framework analyzers (CLI, Compojure, Pedestal, Reitit, Ring). Every one of them walks s-expressions the same way, so the scanning primitives live here instead of being copied per analyzer.

The primitives themselves belong to the parser layer, so this is only a thin adapter over Noir::ClojureScanner (src/miniparsers/). Keeping a second copy here is what let a reader bug — \( counted as a real open paren — live on in the analyzers after it was fixed in the miniparser.

All of them operate on byte offsets into the raw source (byte_at), never on character indices, so the offsets they return stay usable with String#byte_slice on sources containing non-ASCII text.

Instance methods

find_matching_delimiter(source : String, index : Int32, open_char : Char, close_char : Char, limit : Int32) : Int32

Find the offset of the delimiter closing the one at index, skipping over comments, strings and character literals so a ) inside ";)" or a \( never closes a form. Returns index unchanged when no match is found.

Source

line_number_for(source : String, index : Int32) : Int32

1-based line number of a byte offset.

Source

skip_char_literal(source : String, index : Int32, limit : Int32) : Int32

Advance from the \ opening a character literal (\a, \", \(, \newline, \uXXXX, …) to the literal's last byte.

Source

skip_comment(source : String, index : Int32, limit : Int32) : Int32

Advance past a ; line comment, stopping on the newline that ends it.

Source

skip_string(source : String, index : Int32, limit : Int32) : Int32

Advance from the opening " of a string literal to its closing quote, honouring \ escapes. Returns the last in-range offset when the literal is unterminated so callers still make progress.

Source