taskforge-rasti 0.1.0

A clean minimal task tracking engine with layered architecture.

Taskforge

A clean, minimal task tracking engine built with layered architecture, UUID identity, JSON persistence, and pytest-driven development.

---

Features

• Clean layered architecture:
  • domain
  • services
  • storage
  • cli
• Stable UUID-based task identity
• JSON persistence
• Backward compatible data loading
• CLI with subcommands
• Pytest test suite
• GitHub Actions CI
• 79%+ test coverage

---

Architecture Overview

CLI
  ↓
Tracker (Application Service)
  ↓
Task (Domain Model)
  ↓
Repository Interface
  ↓
JSON Repository

---

Desing Principles Used

• Single Responsibility Principle
• Dependency Inversion
• Encapsulation
• Backward Compatibility
• Separation of Concerns

---

Installation

git clone https://github.com/itsar-t/taskforge.git
cd taskforge

Create virtual environment:

python -m venv venv
venv\Scripts\activate   # Windows

Install editable:

pip install -e .

---

Usage

Add a task:

taskforge add "Learn architecture"

List tasks:

taskforge list

List pending tasks:

taskforge list --pending

List done tasks:

taskforge list --done

Mark done (using short UUID prefix):

taskforge done a1b2c3d4

Mark undone (using short UUID prefix):

taskforge undone a1b2c3d4

Switch done (using short UUID prefix):

taskforge switch a1b2c3d4

Remove:

taskforge rm a1b2c3d4

Remove ALL tasks:

taskforge rm --all

Remove ALL tasks without confirmation:

taskforge rm --all --yes

Remove ALL PENDING tasks:

taskforge rm --pending

Remove ALL PENDING tasks without confirmation:

taskforge rm --pending --yes

Remove ALL DONE tasks (No confirmation on this one):

taskforge rm --done 

Example Output

1. [Undone] (a1b2c3d4) Learn architecture
2. [Done] (f8e9d123) Build portfolio project

---

Running Tests

Install pytest

pip install -e .[dev]

Run:

pytest

Example output:

7 passed in 0.24s
Coverage: 79%

---

Project Structure

taskforge/
│
├── src/
│   └── taskforge/
│       ├── domain/
│       │   └── task.py
│       ├── services/
│       │   └── tracker.py
│       ├── storage/
│       │   ├── repository.py
│       │   └── json_repo.py
│       ├── cli.py
│       └── __main__.py
│
├── tests/
│   ├── test_task.py
│   ├── test_tracker.py
│   └── test_json_repo.py
│
├── pyproject.toml
└── README.md

---

Persistence

Tasks are stored in:

data/tasks.json

The system is backward compatible:

• Missing id fields are automatically generated.
• Missing done fields default to False.

---

Future Improvements

• SQLite backend
• Rich CLI formatting (rich library)
• Sorting & filtering
• Export / import
• REST API wrapper
• Packaging for PyPI

---

License

MIT License
Copyright (c) 2026 Rasti

---

Author

Rasti
Built as a learning project in clean Python architecture and testing discipline.