jots-rs-py

Python bindings for Jot Syntax.

The normative specification lives at jotsyntax.org. This package is a thin PyO3 binding over the Rust parser in jots-rs. For a pure-Python parser with no Rust/FFI dependency, see the sibling jots-py.

Install

pip install jots-rs-py

Usage

import jots

result = jots.parse("..meeting ::work::q2 ??buy milk")
# {
#   "tags": ["meeting"],
#   "categories": ["work::q2"],
#   "todos": [{"importance": 1, "action": "buy", "description": "milk", ...}],
#   "diagnostics": [],
#   ...
# }

Optional config flags (see SPEC §2.2) are passed via the config keyword:

jots.parse(text, config={"parse_hashtags_as_tags": True, "emit_loc": False})

Iota Syntaxis (Unicode variant)

The Iota Syntaxis variant widens the identifier and filename character classes to Unicode XID_Start/XID_Continue: jots.parse(text, unicode=True) — one wheel serves both variants.

Status

Tracks Jot Syntax 1.0 RC1 (2026-03-18). Current scope is the parser only (Part II of the spec); the processor (Part III) will live in a future jotr-py repo.

The parsed output currently uses byte-offset loc units, matching the underlying Rust parser. A future release may switch the Python surface to char offsets — see TODO.md.