https://github.com/mawigh/taskl
Simple python library for communicating with TaskWarrior 3
https://github.com/mawigh/taskl
taskwarrior3
Last synced: 19 days ago
JSON representation
Simple python library for communicating with TaskWarrior 3
- Host: GitHub
- URL: https://github.com/mawigh/taskl
- Owner: mawigh
- License: mit
- Created: 2024-07-30T11:08:33.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-07T12:06:08.000Z (over 1 year ago)
- Last Synced: 2025-02-26T11:16:01.902Z (over 1 year ago)
- Topics: taskwarrior3
- Language: Python
- Homepage:
- Size: 88.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# taskl
Simple python library for communicating with [TaskWarrior](https://taskwarrior.org/) > v3
## Installation
### Install via pip
work in progress
### Install via git
```
$ git clone https://github.com/mawigh/taskl.git
$ python3 -m pip install ./taskl/
```
## Quick start
```python
from taskl import TaskWarrior
from taskl import Task
taskw = TaskWarrior()
pending_tasks = taskw.get_pending_tasks()
project_tasks = taskw.get_project_tasks('shopping')
# Add a new task
new_task = taskw.add_task(description='My new task', project='Shopping', due='tomorrow')
print(new_task)
# [Taskl.Task(id=1), Taskl.Task(id=2), Taskl.Task(id=3), Taskl.Task(id=4)]
# [Taskl.Task(uuid=b59ba870-cd29-4707-873e-4d3ba41bfb97), Taskl.Task(uuid=0a047015-1087-4e16-8778-8267cb8f4a6f)]
# Taskl.Task(id=30)
```
## Current status
- [x] Add a new task
- [x] Get pending tasks
- [x] Get project specfic tasks
- [ ] Complete a task
- [ ] Set the task priority
- [x] Get tasks without a project
- [x] Handling with custom exceptions
- [ ] Get all recurring tasks
- [ ] get custom statistics
- [ ] Publish package on pip
**Feel free to add issues**
## Documentation
taskl documentation: https://mawigh.github.io/taskl/taskl.html