easydone
Your terminal-based task manager — simple, fast, and safe.
easydone is a lightweight CLI tool to keep your to‑do list in check.
Create, update, mark done, delete, and filter tasks with a few keystrokes.
All your data is stored as plain JSON, with atomic writes, automatic backups, and corruption quarantine so you never lose a task.
pip install easydone
📚 About this Project
This project was built as a solution to the Task Tracker project on roadmap.sh.
The goal was to practice building a real-world CLI tool with:
- A clean, user-friendly interface
- Robust data storage with atomic writes and automatic backups
- A well-tested, maintainable codebase
✨ Why you'll like it
- Instant workflow – no mouse, no distractions.
- Smart statuses:
not-done,in-progress,done. - Priority levels:
low,normal,high,urgent. - Filter tasks by status, priority, or both.
- Human‑readable JSON – inspect your data anytime.
- Bulletproof storage – atomic writes,
.bakbackups, and quarantined corrupt files. - Beautiful output with Rich – optional, falls back to plain text if not installed.
- Consistent tag colors – the same tag gets a stable color in Rich output. The palette has ten styles, so different tags can still share a color when their hash values map to the same style.
- Clean architecture – business logic separated from CLI, making the core testable and reusable.
📦 Installation
Basic install (no extras)
pip install easydone
This installs the core tool with plain‑text output. Works perfectly for everyday use.
With Rich (pretty output)
pip install easydone[pretty]
This installs Rich for colored tables, styled text, and a more polished terminal experience.
💡 Note: Rich is completely optional. If you install the basic version, easydone automatically falls back to clean plain‑text output. No functionality is lost – it just looks different.
🚀 Quick Start
# Create a task
easydone new "Read a book"
# Add details
easydone new "Finish report" --status in-progress --priority high
# List everything
easydone list
# Focus on urgent, unfinished tasks
easydone list --status not-done --priority urgent
# Mark complete
easydone mark 123 done
# Delete (with confirmation)
easydone delete 123
# Delete without confirmation
easydone delete 123 -f
# Delete multiple tasks
easydone delete 123 456 789 -f
📋 Command Reference
| Command | Description |
|---|---|
easydone new DESCRIPTION [--status STATUS] [--priority PRIORITY] [--due-date DATE] |
Create a task. Due dates accept YYYY-MM-DD, Tomorrow, +N, or -N. |
easydone update TASK_ID [--description NEW] [--priority NEW] [--due-date DATE] [--add-tag TAG ...] [--remove-tag TAG ...] |
Change task fields and add or remove tags. Use Clear to remove a due date. |
easydone mark TASK_ID [TASK_ID ...] new-status |
Set status to not-done, in-progress, or done for one or more tasks. |
easydone delete TASK_ID [TASK_ID ...] [-f] |
Delete one or more tasks. Use -f to skip confirmation. |
easydone list [--status STATUS] [--priority PRIORITY] [--tag TAG ...] [--no-dates] |
Show tasks. Multiple tags use AND semantics. |
💡 Pro tip: Delete multiple IDs at once:
easydone delete 123 456 789. All IDs are validated before anything is removed – no partial deletions. PressCtrl+Cat any prompt to cancel the entire operation.
🛡️ Safety first
easydone takes care of your data:
- Atomic writes – a crash mid‑save never corrupts your file.
- Automatic backups – each save creates a
tasks.json.bakin the same directory. - Corruption quarantine – if a file is unreadable, it's copied to
tasks.corrupted-<timestamp>.jsoninstead of being discarded.
Your tasks live in a user‑specific folder:
| Platform | Location |
|---|---|
| Windows | %APPDATA%\easydone\tasks.json |
| macOS | ~/Library/Application Support/easydone/tasks.json |
| Linux | ~/.local/share/easydone/tasks.json |
You can override the storage path by setting the EASYDONE_DATA_FILE environment variable.
📁 Project Structure
easydone/
├── easydone/
│ ├── __init__.py # Package metadata
│ ├── __main__.py # Application entry point
│ ├── cli.py # CLI interface (argparse, handlers, user prompts)
│ ├── logic.py # Pure business logic (CRUD, validation, filtering)
│ ├── storage.py # JSON persistence with atomic writes, backup & quarantine
│ └── format.py # Output formatting (Rich / plain text)
├── tests/
│ ├── test_integration.py # CLI + Logic integration tests
│ ├── test_storage.py # Storage layer tests
│ └── test_format.py # Output formatting tests
├── LICENSE
├── pyproject.toml
└── README.md
Architecture Overview
logic.py– Core business logic. Knows nothing about the CLI. Accepts only plain Python types (str,list,bool, etc.).cli.py– CLI interface. Parses arguments, extracts values, calls the manager, handles user prompts.storage.py– Persistence layer. Handles loading, saving, atomic writes, backups, and quarantine.format.py– Presentation layer. Renders tables and messages with Rich or plain‑text fallback.
This design makes the core reusable in other contexts (API, TUI, GUI) and easy to test.
🔧 Development
Install in editable mode with dev dependencies:
git clone https://github.com/prares-dev/easydone.git
cd easydone
python -m venv .venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
pip install -e ".[dev]"
Run the complete test suite:
pytest
Run a specific test file:
pytest tests/test_integration.py
pytest tests/test_storage.py
pytest tests/test_format.py
Test Structure
| Test File | What It Tests |
|---|---|
test_integration.py |
CLI + Logic integration (argument parsing, handlers, user interaction, output) |
test_storage.py |
Storage layer (loading, saving, atomic writes, backups, quarantine) |
test_format.py |
Output formatting (Rich availability, plain‑text fallback) |
📄 License
MIT – see LICENSE.
Made with ❤️ by Pedro Rosquete — feedback and contributions are always welcome!
Metadata
Release files for easydone 1.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| easydone-1.3.3.tar.gz | 29.3 kB | Without provenance | Details for easydone-1.3.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| easydone-1.3.3-py3-none-any.whl | Python 3 | none | any | Details for easydone-1.3.3-py3-none-any.whl |
Total release size: 48.3 kB
Release files / easydone-1.3.3.tar.gz
| Download URL | easydone-1.3.3.tar.gz |
|---|---|
| Size | 29.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d566d11797a6a03a7757f41873ccf60ef897b20cd51e0a40e0decc1e0de0020a
|
|
BLAKE2b-256 checksum How to use checksums |
99190cf76c63e3ec7dfdf749fec46832ada39a33f867d30155803de8c7dfb9a0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / easydone-1.3.3-py3-none-any.whl
| Download URL | easydone-1.3.3-py3-none-any.whl |
|---|---|
| Size | 19.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d1ad5eb11be218d7150e055765618054da403d4afa4ebaaebe4707019316ac2c
|
|
BLAKE2b-256 checksum How to use checksums |
6f6f9eabc786a3b2b1fd6c902dd39fc51e2aa433a3c3703da361325e4f3c386f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Security for easydone 1.3.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.