Skip to main content

Todoosy Python Library

Python implementation of the Todoosy format parser, formatter, linter, and query engine.

Installation

pip install -e .

For development:

pip install -e ".[dev]"

Usage

from todoosy import parse, format, lint, query_upcoming, query_misc, parse_scheme

# Parse a document
result = parse('''
# Work

- Task (due 2026-01-15 p1 2h)

# Misc
''')

# Access the AST
for item in result.ast.items:
    print(f"{item.title_text}: due={item.metadata.due}")

# Format a document
formatted = format(input_text)

# Lint a document
warnings = lint(input_text)
for w in warnings.warnings:
    print(f"{w.code}: {w.message}")

# Query upcoming items
scheme = parse_scheme(scheme_text)
upcoming = query_upcoming(input_text, scheme)
for item in upcoming.items:
    print(f"{item.path}: {item.due}")

# Query misc items
misc = query_misc(input_text)
for item in misc.items:
    print(item.title_text)

Running Tests

pytest

Metadata

Release files for todoosy 0.3.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for todoosy 0.3.7
File Size Uploaded
todoosy-0.3.7.tar.gz 25.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for todoosy 0.3.7
File Interpreter ABI Platform
todoosy-0.3.7-py3-none-any.whl Python 3 none any Details

Total release size: 54.9 kB

Release files / todoosy-0.3.7.tar.gz

Download URL todoosy-0.3.7.tar.gz
Size 25.5 kB
Tags Source
SHA-256 checksum
How to use checksums
24a2dabb97d0cbc7e08a0df53d41da58deaea0e41f56a0ffb5abcff89928259e
BLAKE2b-256 checksum
How to use checksums
238805226cf49ff8ef4ea7be376223e2e61598f257c723ceba93348dd08b866f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / todoosy-0.3.7-py3-none-any.whl

Download URL todoosy-0.3.7-py3-none-any.whl
Size 29.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c00ec6a7aead6aa0b6e4699dc31ad1af25ebd7f24033e5716bcce567b7cbe436
BLAKE2b-256 checksum
How to use checksums
434aee9ce051ead70db321e3d746679242706c707d4be3d262dc47f4f37fce74
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.3.7 This release

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page