Skip to main content

A simple CLI tool for managing tasks.

Project description

Task Tracker CLI

Task Tracker CLI is a simple command-line interface (CLI) application for managing tasks. You can add, update, delete, and list tasks with various statuses. This tool is perfect for keeping track of your to-do items right from your terminal.

Features

  • Add Tasks: Easily add new tasks to your list.
  • Update Tasks: Modify the description of existing tasks.
  • Delete Tasks: Remove tasks that are no longer needed.
  • Change Task Status: Mark tasks as in-progress or done.
  • List Tasks: Display tasks filtered by status.

Installation

  1. Clone the Repository:
    git clone https://github.com/under-script/task-tracker-cli.git
    
  2. Navigate to the Project Directory:
    cd task_tracker_cli
    
  3. Install Dependencies: Ensure you have Python installed. Then, install the required Python packages:
    pip install -r requirements.txt
    

Usage

To start using the Task Tracker CLI, simply run the Python script with the desired commands.

Adding a Task

Add a new task by providing a description:

python main.py add "Your task description"

Updating a Task

Update the description of an existing task by specifying its ID and the new description:

python main.py update <task_id> "Updated task description"

Deleting a Task

Delete a task by specifying its ID:

python main.py delete <task_id>

Marking a Task as In-Progress

Change the status of a task to "in-progress":

python main.py mark_in_progress <task_id>

Marking a Task as Done

Change the status of a task to "done":

python main.py mark_done <task_id>

Listing Tasks

List all tasks, optionally filtering by status:

# List all tasks
python main.py list

# List only tasks with a specific status (e.g., todo, in-progress, done)
python main.py list <status>

Note: The status argument is optional. If not provided, all tasks will be listed.

Task File

All tasks are stored in a tasks.json file in the project directory. The structure of this file is managed automatically by the CLI.

Task Structure

Each task has the following attributes:

  • id: Unique identifier for the task.
  • description: The text description of the task.
  • status: Current status of the task (todo, in-progress, or done).
  • createdAt: The timestamp when the task was created.
  • updatedAt: The timestamp when the task was last updated (optional).

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.

  1. Fork the repository.
  2. Create a new branch for your feature or fix.
  3. Commit your changes.
  4. Push to the branch.
  5. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or feedback, please contact [abdulmajidyunusov18@gmail.com].


Happy task tracking!

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_tracker_cli-0.1.0.3.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

task_tracker_cli-0.1.0.3-py2.py3-none-any.whl (6.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file task_tracker_cli-0.1.0.3.tar.gz.

File metadata

  • Download URL: task_tracker_cli-0.1.0.3.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.6

File hashes

Hashes for task_tracker_cli-0.1.0.3.tar.gz
Algorithm Hash digest
SHA256 30cf154fdb2ee2a605a7402e7fb37a0588ba8417431e2a7c258edc4930789671
MD5 db6690584a5798a56a539969e5041c6d
BLAKE2b-256 462675d62acc27543ee448f8c4c423df9a5f974ad609afa90bc1c16385f102ff

See more details on using hashes here.

File details

Details for the file task_tracker_cli-0.1.0.3-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for task_tracker_cli-0.1.0.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a95b61ff307c40500e25d074e613673f5a69289013054089f90b76ac50aeb7bd
MD5 41faaeef48d2b9afa3407b70235b0491
BLAKE2b-256 74e4d34a540ecbb0be05a0e321c7c77616270608a0bad5d311fdc91718a23e86

See more details on using hashes here.

Supported by

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