Skip to main content

time-tracker-cli is a Python script that allows you to track the time spent working in your projects or tasks.

Project description

It's a Python script that allows you to track the time spent working in your projects or tasks. At the moment, this script doesn't have external dependencies so it's ready to run.

Installation:

$ pip install time-tracker-cli

How to use:

Help menu:

$ time-tracker-cli -h

usage: time-tracker-cli [-h] [-p PATH] [-r] project

positional arguments:
  project               project name

optional arguments:
  -h, --help            show this help message and exit
  -p PATH, --path PATH  Path to the JSON data file
  -r, --report          Calculate and display a report of the time spent in the project

Start/end working session:

$ time-tracker-cli -p "~/Documents/my_project_time_tracker_data.json" "my_project"

The file or project within the file will be created automatically if it doesn't exist.

Behavior

The script saves "timestamps" for the working sessions in a JSON file with the following structure:

{
   "projects": [
       {
           "project_name": "a_project_name",
           "sessions": [
              {
                  "start": "dd/mm/yy - H:M:S" ,
                  "end": "dd/mm/yy - H:M:S"
              }
           ]
       }
   ]
}

Unfinished sessions will have a null value in the end field.

Report

To calculate the time spent working in a project, run:

$ time-tracker-cli -r -p "~/Documents/my_project_time_tracker_data.json" "my_project" 

Time spent working on project: 'my_project'
1 day, 7:52:19
Ongoing sessions: True
Time spent in ongoing session: 0:04:10.492647

TODO:

  • Add more functions to estimate the time spent working in a project (total, mean per day).
  • Add an argument to request a "report" of the time spent working in a project.
  • Add more documentation.
  • Add a simple GUI (optional).
  • Define behavior for unfinished sessions.

GUI version

Check out Time Tracker

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

time-tracker-cli-1.0.1.tar.gz (4.3 kB view hashes)

Uploaded source

Built Distribution

time_tracker_cli-1.0.1-py3-none-any.whl (4.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page