How upstandinghackers/hammer works
Hammer is a C parsing library: users define grammars with parser combinators, select a parsing backend, parse bit-oriented input, and receive a parse result/AST. The README documents Packrat, LL(k), GLR, LALR, and regular-expression backends, plus language bindings; the tree contains source for C++, Java, Python, Ruby, and .NET bindings. The graph captures the documented backend choices, but sampled implementation excerpts do not establish their dispatch wiring or all binding call paths, so those links are omitted where uncertain.
Main entry points: hammer.h C API · parsers Parser combinators · com_upstandinghackers_hammer_Parser.c JNI bridge · parser.rb Ruby binding
Components 21
Grammar API
- C API
src/hammer.h - Parser combinators
src/parsers - Parser registry
src/registry.c
Parsing runtime
- Grammar desugaring
src/desugar.c - Bit input
src/bitreader.c - Parse results
src/parsers/parser_internal.h - Parse memory
src/allocator.c
Parsing backends
Language bindings
- C++ binding
src/bindings/cpp/hammer/hammer.hpp - Java JNI binding
jni/com/upstandinghackers/hammer/Parser.java - JNI bridge
jni/com_upstandinghackers_hammer_Parser.c - Python binding
src/bindings/python - Ruby binding
src/bindings/ruby/lib/hammer/parser.rb - Ruby grammar DSL
src/bindings/ruby/lib/hammer/parser_builder.rb - .NET binding
src/bindings/dotnet/ext/hammer.cs
Other components
- Grammar author
Connections 19
- Grammar author → C API: defines grammar
- C API → Parser combinators: constructs parsers
- Parser combinators → Parser registry: registers parsers
- Parser combinators → Grammar desugaring: desugars grammar
- Bit input → Parse results: provides parse bits
- Parse memory → Parse results: allocates results
- C API → Packrat
- C API → LL(k)
- C API → GLR
- C API → LALR
- C API → Regular expressions
- C API → LR
- Ruby grammar DSL → Ruby binding: builds parsers
- Ruby binding → C API: calls native API
- Java JNI binding → JNI bridge: calls native bridge
- JNI bridge → C API: calls native API
- C++ binding → C API
- Python binding → C API
- .NET binding → C API