# jots-rs
A Rust implementation of [Jot Syntax](https://jotsyntax.org).
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](https://iotasyntaxis.org) 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`](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`](https://gitlab.com/jot-syntax/jotr-rs).
Passes the full conformance suite at
[gitlab.com/jot-syntax/jots-tests](https://gitlab.com/jot-syntax/jots-tests).