tp-timesheet 1.2.1

CLI tool to automate the submisison of tp timesheets

TP-Timesheet

Automated submission of TP timesheets. Version<1.0.0 carries out the submission only on the web form while Version>=1.0.0 also submits on the Clockify application.

Installation

Install

This tool is published on pypi so from any terminal with python3 installed run:

pip install tp-timesheet

Note: some outdated OS's still require pip3 instead of pip. If you get an error Unknown command: pip then try the following:

pip3 install tp-timesheet

Upgrade

pip install --upgrade tp-timesheet

Uninstall

pip uninstall tp-timesheet

Usage

Run the tool with the help option to find out additional usage information

tp-timesheet --help

Common cli options

# submit live hours (default) for today
tp-timesheet --start today

# submit live hours (default) for next 5 days
tp-timesheet --start today --count 5

# submit for Mon 3/10/22 to Thursday 6/10/22 with a task of Out Of Office (OOO)
tp-timesheet --start '3/10/22' --count 5 -t OOO

# Schedule the form to submit automatically on weekdays
tp-timesheet --automate weekdays

# append '--verbose' to any command to get more log messages about what is going on
# append '--dry-run' to any command to avoid clicking submit. Good for testing

Development

Install the dev environment and run tool locally:

pip install -e .[dev]

tp-timesheet --help

note: if zsh is used, install the dev environment with:

pip install -e ".[dev]"

Contributing

To run checks prior to committing

black --check --diff tp_timesheet # See what formatting changes need to be made
black tp_timesheet # Run formatter
pylint tp_timesheet # Run linter
pytest # Run testing