jots 0.1.0

Jot Syntax 1.0 RC1 parser — pure Python (https://jotsyntax.org)

jots-py

Pure-Python parser for Jot Syntax.

The normative specification lives at jotsyntax.org. This package is a from-scratch Python implementation of the spec — no Rust, no FFI, no compiled extension. For a faster parser backed by the Rust implementation (jots-rs), see the sibling PyO3 bindings (jots-rs-py); both expose the same jots.parse() API.

Install

pip install jots

Usage

import jots

result = jots.parse("..meeting ::work::q2 ??buy milk")
# {
#   "tags": ["meeting"],
#   "categories": ["work::q2"],
#   "todos": [{"importance": 0, "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.

Conformance is verified against the shared vector suite in jots-tests — the same suite used by jots-rs and jots-rs-py.