Registry / productivity / taskchampion3-py-dev

taskchampion3-py-dev

JSON →
library3.0.1.3pypypi✓ verified 80d ago

Python bindings for TaskChampion 3.x, a replicated task database supporting Taskwarrior. Current version 3.0.1.3 (fork). Release cadence: irregular.

pip install taskchampion3-py-dev
INSTALL
IMPORT
SIG · TASKCHAMPION3-PY-D
T
taskchampion3-py-dev
productivitypythonv3.0.1.3
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

TaskDb
from taskchampion import Replica
from taskchampion import TaskDb
Task
from taskchampion import Task
Replica
from taskchampion import Replica

Create an in-memory TaskChampion database, create a task, modify it, and delete it.

from taskchampion import TaskDb, Task import os # Initialize database (in-memory for demo) db = TaskDb.in_memory() # Create a task task = Task.new(db, "Buy groceries") # Modify priority task.set_urgency(10.0) print(f"Task created: {task.summary()}") # Delete task task.delete(db)
Debug
Known issues
breakingThe native library (taskchampion) must be installed separately (e.g., via conda or system package) for the Python bindings to work. Missing library leads to import error.
fix
Install TaskChampion native library using 'conda install -c conda-forge taskchampion' or build from source.
affects: >=3.0.0
breakingClass names changed from 'Database' to 'TaskDb' and 'UDA' (user-defined attributes) API is significantly different from TaskChampion 2.x.
fix
Update imports to 'from taskchampion import TaskDb, Task, UdaField' and refer to new UDA documentation.
affects: >=3.0.0
gotchaIn-memory databases are not persistent. If you open a database path that does not exist, it creates a new empty replica, not an error.
fix
Be explicit: use 'TaskDb.on_disk(path)' for persistent storage and check existence if needed.
affects: all
Upgrade
Version history
3.0.1.3latest on PyPI · released May 22, 2026
Audit
Dependencies
taskchampionrequiredCore TaskChampion library (cffi bindings require dynamically linked native library)
Agent activity
28 hits · last 30 days
node
26
OpenAI (training)
1
Resources

No resource links recorded.

taskchampion3-py-dev — pip install taskchampion3-py-dev · libregistry