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

Uploaded Python 3

File details

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

File metadata

  • Download URL: simple_task_tracker-2.5.1.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.1.tar.gz
Algorithm Hash digest
SHA256 4e71c1b33e7e00d8408af65fa7f6d9117305b69347c4f5cb1b89148b504ddb52
MD5 5cc52c06ff0d7543510bce0a1637317b
BLAKE2b-256 0805c3e8b1968da411f076434756b9cfbce3e7d4a794f7e84e2e31eee46adb9a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for simple_task_tracker-2.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fa594ec396fe6a4c9b582bd593a13ee863a426948772770939a75a5c18eb8f24
MD5 f93ff7e3943014779a2519e3ae0dbe89
BLAKE2b-256 edb7514610dc1452ee1e582461c2513194675b36efb29071f7512cf0bdd436c4

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