| """Rules for ANTLR 3.""" |
| |
| def _generate(ctx): |
| return None |
| |
| antlr = rule( |
| implementation = _generate, |
| doc = "Runs [ANTLR 3](https://www.antlr3.org//) on a set of grammars.", |
| attrs = { |
| "debug": attr.bool(default = False, doc = "Generate a parser that emits debugging events."), |
| "depend": attr.bool(default = False, doc = "Generate file dependencies; don't actually run antlr."), |
| "deps": attr.label_list( |
| default = [Label("@antlr3_runtimes//:tool")], |
| doc = """ |
| The dependencies to use. Defaults to the most recent ANTLR 3 release, |
| but if you need to use a different version, you can specify the |
| dependencies here. |
| """, |
| ), |
| "dfa": attr.bool(default = False, doc = "Generate a DFA for each decision point."), |
| "dump": attr.bool(default = False, doc = "Print out the grammar without actions."), |
| "imports": attr.label_list(allow_files = True, doc = "The grammar and .tokens files to import. Must be all in the same directory."), |
| "language": attr.string(doc = "The code generation target language. Either C, Cpp, CSharp2, CSharp3, JavaScript, Java, ObjC, Python, Python3 or Ruby (case-sensitive)."), |
| "message_format": attr.string(doc = "Specify output style for messages."), |
| "nfa": attr.bool(default = False, doc = "Generate an NFA for each rule."), |
| "package": attr.string(doc = "The package/namespace for the generated code."), |
| "profile": attr.bool(default = False, doc = "Generate a parser that computes profiling information."), |
| "report": attr.bool(default = False, doc = "Print out a report about the grammar(s) processed."), |
| "srcs": attr.label_list(allow_files = True, mandatory = True, doc = "The grammar files to process."), |
| "trace": attr.bool(default = False, doc = "Generate a parser with trace output. If the default output is not enough, you can override the traceIn and traceOut methods."), |
| "Xconversiontimeout": attr.int(doc = "Set NFA conversion timeout for each decision."), |
| "Xdbgconversion": attr.bool(default = False, doc = "Dump lots of info during NFA conversion."), |
| "Xdbgst": attr.bool(default = False, doc = "Put tags at start/stop of all templates in output."), |
| "Xdfa": attr.bool(default = False, doc = "Print DFA as text."), |
| "Xdfaverbose": attr.bool(default = False, doc = "Generate DFA states in DOT with NFA configs."), |
| "Xgrtree": attr.bool(default = False, doc = "Print the grammar AST."), |
| "Xm": attr.int(doc = "Max number of rule invocations during conversion."), |
| "Xmaxdfaedges": attr.int(doc = "Max "comfortable" number of edges for single DFA state."), |
| "Xmaxinlinedfastates": attr.int(doc = "Max DFA states before table used rather than inlining."), |
| "Xminswitchalts": attr.int(doc = "Don't generate switch() statements for dfas smaller than given number."), |
| "Xmultithreaded": attr.bool(default = False, doc = "Run the analysis in 2 threads."), |
| "Xnfastates": attr.bool(default = False, doc = "For nondeterminisms, list NFA states for each path."), |
| "Xnocollapse": attr.bool(default = False, doc = "Collapse incident edges into DFA states."), |
| "Xnoprune": attr.bool(default = False, doc = "Do not test EBNF block exit branches."), |
| "Xnomergestopstates": attr.bool(default = False, doc = "Max DFA states before table used rather than inlining."), |
| "XsaveLexer": attr.bool(default = False, doc = "For nondeterminisms, list NFA states for each path."), |
| "Xwatchconversion": attr.bool(default = False, doc = "Don't delete temporary lexers generated from combined grammars."), |
| "_tool": attr.label( |
| executable = True, |
| cfg = "host", |
| ), |
| }, |
| ) |
