Skip to main content

Task managment via CLI

Project description

Task Tracker CLI

Python Version License

A command-line task manager that stores tasks in JSON format. Perfect for personal productivity tracking.

Features

  • ✅ Add, update, and delete tasks
  • 📌 Mark tasks as todo/in-progress/done
  • 📋 List tasks with status filtering
  • 💾 Automatic JSON storage
  • ⏱️ Timestamp tracking

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/task-tracker.git
    cd task-tracker
    
  2. (Optional) Create virtual environment:

    python -m venv venv
    source venv/bin/activate  # Linux/Mac
    venv\Scripts\activate     # Windows
    

Usage

Add a new task

task-cli add "Buy groceries"

Update a task

task-cli update 1 "Buy groceries and cook dinner"

Delete a task

task-cli delete 1

Change task status

task-cli mark-in-progress 1
task-cli mark-done 1

List tasks

task-cli list
task-cli list done
task-cli list in-progress
task-cli list todo

Data Structure

Tasks are stored in data/tasks.json with this format:

{
  "1": {
    "title": "Buy groceries",
    "status": "todo",
    "time": "2023-07-15T10:30:00.000000"
  }
}

Development Setup

  1. Install dependencies:
pip install -e .
  1. Run tests:
pytest tests/
  1. Code quality checks:
mypy taskcli/
flake8 taskcli/

Configuration

Customize storage location by setting environment variable:

export TASKCLI_DATA_PATH="/custom/path/data.json"

Roadmap

  • Add due dates and priorities
  • Implement task categories
  • Add search functionality
  • Develop a web interface

Contributing

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Made with ❤️ by Nemkov

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

task_cli_nemkov-0.1.0.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

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

task_cli_nemkov-0.1.0-py3-none-any.whl (3.8 kB view details)

Uploaded Python 3

File details

Details for the file task_cli_nemkov-0.1.0.tar.gz.

File metadata

  • Download URL: task_cli_nemkov-0.1.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.13.3 Darwin/24.4.0

File hashes

Hashes for task_cli_nemkov-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0e5bcd3ef049143172b54359db5aa1f5449b4973fd2ece4ff1a27f6ac3840627
MD5 e73e93fa3680a4f42e537e05fcb5166c
BLAKE2b-256 bd60f3b1ee22500de4aca343d7aa594c8c9faf8aa3006c5d5ebdede3f5473ad9

See more details on using hashes here.

File details

Details for the file task_cli_nemkov-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: task_cli_nemkov-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.13.3 Darwin/24.4.0

File hashes

Hashes for task_cli_nemkov-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 78cc36971f9c3e637eb38c384d5b1a30dd2734a7ff669468b1853c5bd5c72455
MD5 189bcf645a988ae91aaf31c0ebe68211
BLAKE2b-256 73f9850d7fd2fb7a2f8741980977a15be9700182f34904b5a8ee58ba940e6c9b

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