Skip to main content

Time tracking CLI application written in Python

Project description

Python application Coverage Status

ius-time

A simple command line application for tracking time spent on tasks of various categories.

Full documentation on the command line interface is available here.

About the name

Every month at work, I had to report to the head of my department how much time was spent working on each project. This information would be collected from each employee and compiled into "Internal Use Software" information.

To be honest, I'm not sure what the higher-ups do with this information, but regardless, I figured I would track the data accurately instead of making up BS numbers at the end of the month.

Thus, the ius-time CLI application was born.

TLDR: IUS = Internal Use Software

IUS Time

Usage:

$ ius [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • end: End active tasks.
  • list: List tasks, with an optional time filter.
  • start: Start a new task.
  • total: Sum the amount of time spent on your tasks.

ius end

End active tasks.

Usage:

$ ius end [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • all: End all active tasks.
  • last: End the last task that was started.
  • task: Specify the name of the task to end.

ius end all

End all active tasks.

Usage:

$ ius end all [OPTIONS]

Options:

  • --help: Show this message and exit.

ius end last

End the last task that was started.

Usage:

$ ius end last [OPTIONS]

Options:

  • --help: Show this message and exit.

ius end task

Specify the name of the task to end.

Usage:

$ ius end task [OPTIONS] TASK_NAME

Arguments:

  • TASK_NAME: [required]

Options:

  • --help: Show this message and exit.

ius list

List tasks, with an optional time filter.

Usage:

$ ius list [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • active: List only active tasks.
  • all: List all tasks in the database.
  • complete: List only completed tasks.

ius list active

List only active tasks.

Usage:

$ ius list active [OPTIONS]

Options:

  • -f, --filter [day|week|month|quarter|semiannual|year|none]: When applied, limits list output to tasks started within the filter window. [default: month]
  • --help: Show this message and exit.

ius list all

List all tasks in the database.

Usage:

$ ius list all [OPTIONS]

Options:

  • -f, --filter [day|week|month|quarter|semiannual|year|none]: When applied, limits list output to tasks started within the filter window. [default: month]
  • --help: Show this message and exit.

ius list complete

List only completed tasks.

Usage:

$ ius list complete [OPTIONS]

Options:

  • -f, --filter [day|week|month|quarter|semiannual|year|none]: When applied, limits list output to tasks started within the filter window. [default: month]
  • --help: Show this message and exit.

ius start

Start a new task.

Usage:

$ ius start [OPTIONS] TASK_NAME

Arguments:

  • TASK_NAME: [required]

Options:

  • -c, --category TEXT: [default: Misc]
  • --help: Show this message and exit.

ius total

Sum the amount of time spent on your tasks. Only calculated for completed tasks

Usage:

$ ius total [OPTIONS]

Options:

  • -f, --filter [day|week|month|quarter|semiannual|year|none]: When applied, limits list output to tasks started within the filter window. [default: month]
  • -c, --category TEXT
  • --help: Show this message and exit.

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

ius_time-0.1.0.tar.gz (19.8 kB view details)

Uploaded Source

Built Distribution

ius_time-0.1.0-py3-none-any.whl (21.2 kB view details)

Uploaded Python 3

File details

Details for the file ius_time-0.1.0.tar.gz.

File metadata

  • Download URL: ius_time-0.1.0.tar.gz
  • Upload date:
  • Size: 19.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.0 Windows/10

File hashes

Hashes for ius_time-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f02a8ee2f71150567bea74ea61c7dbaa80adb746076371e60ff102af647f885b
MD5 66d1d158cb8b61f9bd8faa76cf20268a
BLAKE2b-256 999be3f919f672aad19cbb1eff35936e731ef1afa574f545bb4d006d19be2123

See more details on using hashes here.

File details

Details for the file ius_time-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: ius_time-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 21.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.0 Windows/10

File hashes

Hashes for ius_time-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 daff96744a01d4cf03d057bf277b1b2f4159b011e11c642bf3a4a386a009d879
MD5 28730edf8c0c6bcd275f0c4ac46fa901
BLAKE2b-256 658325befba60b0935e17cff3b18f9ec33bc949e9c8beee4370d6ff3244d81f7

See more details on using hashes here.

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