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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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