jots-rs-py 0.1.0

Jot Syntax 1.0 RC1 parser — PyO3 bindings over the Rust implementation (https://jotsyntax.org)

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})

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.