stage-left

[x]it! is a plain-text file format for todos and check lists. Stage-left parses [x]it! documents into rich python objects.

Installation

pip install stage-left

Usage

Parse checklist from file

from stage_left import parse_file, ParseError

with open("/path/to/checklist.xit") as fp:
    try:
        checklist = parse_file(fp)
        print(checklist)
    except ParseError:
        raise

Parse checklist from string

from stage_left import parse_text, ParseError

text = """
[ ] Open
[x] Done
"""

try:
    checklist = parse_text(text)
    print(checklist)
except ParseError:
    raise

Implementation notes

Due dates specified using the numbered week syntax e.g: 2022-W01 are parsed assuming Monday is the first day of the week. All days in a new year preceding the first Monday are considered to be in week 0 (W00).