jots-rs
A Rust implementation of Jot Syntax.
The normative specification lives at https://jotsyntax.org. Anything in this crate is implementation; the spec is the source of truth.
Usage
jots [FILE]
Reads from FILE or stdin and emits parsed Jot metadata as JSON.
Iota Syntaxis (Unicode variant)
The Iota Syntaxis variant widens the
identifier and filename character classes to Unicode
XID_Start/XID_Continue. It is runtime config: --unicode on
the CLI, or Config::unicode on the API. The sibling
iotas crate in this repo wraps jots with the
variant preset and ships the iotas binary.
Category root
--category-root WORD (config key category_root, env
JOTS_CATEGORY_ROOT; SPEC §9.1) requires every category path to
start with WORD. A path that does not — ::title when the root
is cat — is ordinary text, both free-standing and as an
annotation suffix, so host-language :: tokens (Rust ::std::fmt,
C++ ::std::vector, Quarb ::title) stop parsing as categories.
Rooted paths are emitted unchanged, root segment included.
Status
Tracks Jot Syntax 1.0 RC6 (2026-10-08). Scope is the parser
only; the renderer (a separate peer spec) lives in the sibling
jotr-rs.
Passes the full conformance suite at gitlab.com/jot-syntax/jots-tests.