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 (recommended)

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.2.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.2-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: simple_task_tracker-2.5.2.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.2.tar.gz
Algorithm Hash digest
SHA256 d4988251b6201761ed6e7076c1825077f0a4d7e95581d9adbd162b4b50fdb068
MD5 7a475328fc6c827b305a2d62af4a60a7
BLAKE2b-256 32014c94ccd07f75ecb5006f637c37d2ba9590bed54d14b5d395d0f9eda30bbb

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for simple_task_tracker-2.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2271b5e95d6b15013082c6b6469e5e88e92ce03fdae162106e348e69ae9e3ce3
MD5 fcc50b6f8ff0ce63babaa553f3e9d35b
BLAKE2b-256 392cdddccc0ade278cf7e89aceeaa78f052660876c9892a750f0877be2073673

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