Skip to main content

Simple Task Tracker CLI

Project description

Simple Task Tracker CLI

PyPI - Version PyPI - Python Version GitHub License

A command-line interface (CLI) application to keep track of your tasks, their starting time, finishing time and their durations. The CLI uses a SQLite DB to store data.

Installation

You can install the package using either pipx or pip.

Note: It is highly recommended to install this package using pipx. It provides an isolated environment for installing and managing command-line tools. It also simplifies running CLIs without activating a virtual environment.
Check out this page to compare pip and pipx.

Using pipx

pipx install simple-task-tracker

Using pip

pip install simple-task-tracker

Usage

After the installation, you can run the CLI application with the following command:

tt help

This will display the list of available commands and their descriptions.

Commands

  • tt active: (or "a") List all active tasks.
  • tt create: (or "c") Save a new task as ended. The ended time is the time right now, and the starting time is calculated using (now - duration_in_minutes).
  • tt delete: (or "d") Delete a task.
  • tt finish: (or "f") Mark a task as done. It can be restarted again using 'start' command. If no task is specified, stop the only active task.
  • tt grep : (or "g") Search for tasks containing the given pattern (case insensitive). Optionally limit to a specific date.
  • tt help : (or "h") Show help message.
  • tt log : (or "l") Log all tasks of the day (DD-MM). If --date is not provided, today's date will be used.
  • tt pause : (or "p") Pause the active task.
  • tt resume: (or "r") Resume last stopped task.
  • tt start : (or "s") Start a task.
  • tt stats : Show statistics about your work patterns.
  • tt week : (or "w") List all tasks for the current week along with their durations.

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.

License

This project is licensed under the MIT License.

Contact

If you have any questions or suggestions, feel free to contact me at ismailben44@gmail.com.

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

simple_task_tracker-2.5.0.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

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

simple_task_tracker-2.5.0-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

Details for the file simple_task_tracker-2.5.0.tar.gz.

File metadata

  • Download URL: simple_task_tracker-2.5.0.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for simple_task_tracker-2.5.0.tar.gz
Algorithm Hash digest
SHA256 2c96ff609ff0e15328dcbd98b4c3f973bb517cb67ad8eef21a722291ea19697a
MD5 84f3520db4eb52148264e2f78f852edf
BLAKE2b-256 4b52606c4454f6a22eb3f6c749b39336526cbac00349c85bac0e6c012067dad8

See more details on using hashes here.

File details

Details for the file simple_task_tracker-2.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_task_tracker-2.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3e8a29558d7c03db22311ef261cd68e07708aa201ce9d441278be6e5bc333bb6
MD5 ce0d5d893372640911410be09ba58078
BLAKE2b-256 380d3df43a0ae64c757ed559826adeeb1e448b9646c4eca01966157813515650

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