Skip to main content

A fast, zero-dependency command-line todo/task manager using SQLite.

Project description

Logo

GitHub License GitHub Actions Workflow Status Codecov (with branch) PyPI - Version Python Version from PEP 621 TOML


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

Preview
Preview

Features

  • Task Management — Add, update, remove, list, and mark tasks as done, clear tasks
  • 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
  • Fast Performance — Lazy loading and optimized architecture
  • Clean Architecture — Maintainable and testable codebase

Quick Start

Installation

pip install raztodo

For more installation options, see Installation Guide

Basic Usage

# 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


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
clear Delete all tasks
# 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


Documentation


Contributions are welcome! Please:

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

For detailed guidelines, see Contributing Guide.


License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

raztodo-0.2.0.tar.gz (180.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

raztodo-0.2.0-py3-none-any.whl (44.3 kB view details)

Uploaded Python 3

File details

Details for the file raztodo-0.2.0.tar.gz.

File metadata

  • Download URL: raztodo-0.2.0.tar.gz
  • Upload date:
  • Size: 180.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for raztodo-0.2.0.tar.gz
Algorithm Hash digest
SHA256 fd6442ef8785ee743eaba0efec33c579d2cfa9660a802e687362422400b15f09
MD5 af559203ede49b178623c42b1997cd31
BLAKE2b-256 ed76e98b3166d3b5461b59d050971e81fbb72c5686b02bde803f5a7a91697600

See more details on using hashes here.

File details

Details for the file raztodo-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: raztodo-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 44.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for raztodo-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 da00193caadd18c5d3833f929908252bfc200ef155e5a4e86aa559a86ba5182e
MD5 7636b997200d5cb5091126edbaa6b11f
BLAKE2b-256 0fe3325718a477229f48d930ec3c704b57ae23a0227cc7a54b03d79227f5c4f4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page