jots 0.2.0

Jot Syntax 1.0 RC6 parser (https://jotsyntax.org)
Documentation

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.