How jqlang/jq works
jq is a command-line JSON processor: users provide JSON input and a jq filter, which the CLI compiles, evaluates, and emits as JSON output. The graph separates input handling, filter compilation, execution/built-ins, and value representation/serialization. The README establishes the product workflow; source-index references support the internal module links. Some CLI and runtime details are summarized from API boundaries because the corresponding source was not excerpted.
Main entry points: jv.c JSON values · main.c jq CLI · compile.c Bytecode compiler · execute.c Filter evaluator
Components 19
CLI and input
- jq CLI
src/main.c - Input handling
src/util.c
Filter compilation
- Filter lexer
src/lexer.c - Filter parser
src/parser.c - Bytecode compiler
src/compile.c - Module linker
src/linker.c - Source locations
src/locfile.c
Evaluation runtime
- Bytecode format
src/bytecode.c - Filter evaluator
src/execute.c - Built-in filters
src/builtin.c - jq runtime API
src/jq.h - Date-time filters
src/iso8601.c
JSON values
- JSON parser
src/jv_parse.c - JSON values
src/jv.c - Value allocation
src/jv_alloc.c - Unicode support
src/jv_unicode.c - Number conversion
src/jv_dtoa.c - JSON printer
src/jv_print.c
Other components
- User
Connections 21
- User → jq CLI: runs filters
README.md - jq CLI → Input handling: reads input
src/main.c - jq CLI → jq runtime API: uses runtime API
src/main.c - Input handling → JSON parser: parses JSON
- Filter parser → Filter lexer: requests tokens
src/lexer.c - Filter parser → Bytecode compiler: builds filter blocks
src/parser.c - Bytecode compiler → Bytecode format: compiles bytecode
src/compile.c - Bytecode compiler → Source locations: records locations
src/compile.c - Module linker → Bytecode compiler: binds modules
src/linker.c - jq runtime API → Filter parser: compiles filters
- jq runtime API → Filter evaluator: starts evaluation
src/execute.c - Filter evaluator → Bytecode format: interprets instructions
src/execute.c - Filter evaluator → Built-in filters: dispatches functions
src/execute.c - Built-in filters → Date-time filters: uses date routines
src/builtin.c - Built-in filters → JSON values: operates on values
src/builtin.c - JSON values → Value allocation: allocates storage
src/jv.c - JSON values → Unicode support: uses UTF-8 helpers
src/jv.c - JSON values → Number conversion: converts numbers
src/jv.c - jq CLI → JSON printer: writes results
- JSON parser → JSON values: creates values
src/jv_parse.c - JSON printer → JSON values: serializes values
src/jv_print.c