Metadata-Version: 2.4
Name: raztodo
Version: 0.1.1
Summary: A fast, zero-dependency command-line todo/task manager using SQLite.
Project-URL: Homepage, https://github.com/razbuild/raztodo
Project-URL: Repository, https://github.com/razbuild/raztodo
Project-URL: issues, https://github.com/razbuild/raztodo/issues
Author-email: Raz <real.raz.dev@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,command-line,python,task,todo
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Utilities
Requires-Python: >=3.13
Requires-Dist: raztint
Provides-Extra: coverage
Requires-Dist: coverage; extra == 'coverage'
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: coverage; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: formatter
Requires-Dist: black; extra == 'formatter'
Provides-Extra: lint
Requires-Dist: ruff; extra == 'lint'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Provides-Extra: typecheck
Requires-Dist: mypy; extra == 'typecheck'
Description-Content-Type: text/markdown

![Logo](https://raw.githubusercontent.com/razbuild/raztodo/master/assets/logo.png)

![GitHub License](https://img.shields.io/github/license/razbuild/raztodo?logo=license&logoSize=auto&label=License&labelColor=3b3b3b&color=0055ff&cacheSeconds=3600&link=https%3A%2F%2Fgithub.com%2Frazbuild%2Fraztodo%2Fblob%2Fmaster%2FLICENSE)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/razbuild/raztodo/ci.yml?branch=master&event=push&logo=githubactions&logoColor=&logoSize=auto&label=Build&labelColor=3b3b3b&cacheSeconds=3600&link=https%3A%2F%2Fgithub.com%2Frazbuild%2Fraztodo%2Factions%2Fworkflows%2Fci.yml)
![Codecov (with branch)](https://img.shields.io/codecov/c/github/razbuild/raztodo/master?logo=codecov&logoColor=&logoSize=auto&label=Coverage&labelColor=3b3b3b&cacheSeconds=3600&link=https%3A%2F%2Fcodecov.io%2Fgh%2Frazbuild%2Fraztodo)
![PyPI - Version](https://img.shields.io/pypi/v/raztodo?pypiBaseUrl=https%3A%2F%2Fpypi.org&logo=pypi&logoColor=&logoSize=auto&label=PyPi&labelColor=3b3b3b&color=yellow&cacheSeconds=3600&link=https%3A%2F%2Fpypi.org%2Fproject%2Fraztodo%2F)
![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Frazbuild%2Fraztodo%2Fmaster%2Fpyproject.toml&logo=python&logoColor=&logoSize=auto&label=Python&labelColor=3b3b3b&color=orange&cacheSeconds=3600&link=https%3A%2F%2Fwww.python.org%2F)

---

RazTodo is a lightweight and cross-platform CLI tool for efficient todo and task management, using SQLite as its storage backend.

| Preview |
|:-------:|
| <img src="https://raw.githubusercontent.com/razbuild/raztodo/master/assets/preview.gif" alt="Preview"> |

## Features

- **Task Management** — Add, update, remove, list, and mark tasks as done
- **Tags & Projects** — Organize tasks with tags and project names
- **Search** — Full-text search across all tasks
- **Due Dates & Priority** — Set deadlines and priority levels L | M | H
- **Import/Export** — Backup and restore tasks via **JSON**
- **Colored Output** — Beautiful **ANSI** colors and icons
- **SQLite Storage** — No external services required
- **Cross-Platform** — Works on **Linux**, **macOS**, and **Windows**

---

## Quick Start

### Installation

```bash
pip install raztodo
```

> For more installation options, see [Installation Guide](https://github.com/razbuild/raztodo/blob/master/docs/INSTALLATION.md)

### Basic Usage

```bash
# Create a task
rt add "Buy groceries" --priority H --due 2024-12-31

# List all tasks
rt list

# Mark as done
rt done 1

# Search
rt search "groceries"
```

> For complete command reference, see [Usage Guide](https://github.com/razbuild/raztodo/blob/master/docs/USAGE.md)

---

## Commands

| Command | Description |
|---------|-------------|
| `add` | Create a new task |
| `list` | List tasks with filters |
| `update` | Update a task |
| `done` | Mark task as done/undone |
| `remove` | Delete a task |
| `search` | Search tasks |
| `export` | Export to JSON |
| `import` | Import from JSON |
| `migrate` | Run database migration |

```bash
# Get help for any command
rt --help
rt add --help
```

---

## Configuration

| Variable | Description | Default |
|----------|-------------|---------|
| `RAZTODO_DB` | Database path | `tasks.db` |
| `LOG_LEVEL` | Logging level | `ERROR` |

> For detailed configuration, see [Configuration Guide](https://github.com/razbuild/raztodo/blob/master/docs/CONFIGURATION.md)

---

## Documentation

- [Installation Guide](https://github.com/razbuild/raztodo/blob/master/docs/INSTALLATION.md) — Install via pip, pipx, or from source
- [Usage Guide](https://github.com/razbuild/raztodo/blob/master/docs/USAGE.md) — Complete command reference
- [Configuration](https://github.com/razbuild/raztodo/blob/master/docs/CONFIGURATION.md) — Environment variables and options
- [Architecture](https://github.com/razbuild/raztodo/blob/master/docs/ARCHITECTURE.md) — Project structure and design
- [Testing](https://github.com/razbuild/raztodo/blob/master/docs/TESTING.md) — Running tests and contributing

---

## Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Run tests: `pytest && ruff check src/ && black --check src/`
4. Submit a pull request

---

## License

MIT License
