clj-antlr.static — d0x-mike/clj-antlr 0.2.5-SNAPSHOT

Interacts with statically compiled antlr classes.

->class clj

(->class sym)

Converts symbols and strings into classes.

degenerate-visitor-spec clj

(degenerate-visitor-spec sig)

A reify spec for a particular visitor method. Returns code which, when used in a visitor, handles that node by returning a hashmap of its children. When a node has only one children, returns that child's value instead.

lexer clj/s macro

(lexer lexer-class s)

Given a lexer class, returns a lexer over a string or stream.

method-signatures clj

(method-signatures class)

Returns a list of method signatures for a class.

method? clj

(method? member)

Is a reflection member a method?

parser clj/s macro

(parser parser-class tokens)

Constructs a parser over a token stream.

signature clj

(signature meth)

The signature of a reflected method.

unique-methods clj

(unique-methods class)

Given a class, returns specs for methods which are defined in that class and are not defined in its supers.

visit-string clj/s macro

(visit-string lexer-class parser-class visitor root-node string)

Given a lexer class, parser class, a visitor, and a string, tokenizes, parses, and visits the string, returning the result of the visitor.

Example:

(visit-string JsonLexer JsonParser (JsonInitBaseVisitor.) .json "[1,2,3]"

visitor clj/s macro

(visitor interface-name & specs)

Helps compile a visitor for an antlr grammar. Takes the name of a visitor interface, followed by several method bodies. Given a grammar with a node like

json: object # JsonObject | array # JsonArray ;

Antlr will compile an interface to traverse the parse tree like:

public interface JsonVisitor<T> extends ParseTreeVisitor<T> { T visitJsonObject(JsonParser.JsonObjectContext ctx); T visitJsonArray(JsonParser.JsonArrayContext ctx); }

You might want to define a function to handle each of these branches. Here 'this refers to the visitor itself, and 'context refers to the parser context at the current node. You can traverse the tree by calling (.visit this node).

(visitor JsonVisitor (JsonObject [this context] (prn :got (.getText .object c))) (JsonArray [this context] (.visit this (.array context))))

visitor-method-children clj

(visitor-method-children sig)

Given a visitor method, returns a map of children to forms which visit those children, e.g.

{:kittens (map (partial visit this (.kittens ctx)))}

visitor-spec clj

(visitor-spec sig & args)

Helps compile reify functions pecs for a particular visitor method. In its two-arity form, generates one of a few common parse helpers. In its n-arity form, passes through user-specified code.