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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 2 Python 3

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