python-pytm 0.0.14

PyTM - an Open Source Python Time Management Tool for Mankind

PУΓM - A CLI time tracker for projects with invoice generation

Goals

Project time management, billing, and invoice generation.

Preview

Screenshots

Installing PyTM

You can download it from PyPI using pip:

python -m pip install python-pytm

Check the version by typing the following in your terminal.:

pytm --version

Basic commands

To see the available commands type:

pytm --help

Commands related to projects

• Start a new/existing project: pytm project start PROJECT_NAME

• Remove a project: pytm project remove PROJECT_NAME

• Check the status of a project: pytm project status PROJECT_NAME

• Check the list of tasks and duration of a project: pytm project summary PROJECT_NAME

• Finish active project: pytm project finish

• Pause active project: pytm project pause

• Abort active project: pytm project abort

Commands related to Task

• Start a new or existing task in the current active project: pytm task start TASK_NAME

• Remove a task: pytm task remove TASK_NAME

• current task’s status: pytm task status

• Finish active task: pytm task finish

• Pause active task: pytm task pause

• Abort active task: pytm task abort

Others

Configure project, user and invoice info:

pytm config project PROJECT_NAME
pytm config user
pytm config invoice

Generate Invoice:

pytm invoice auto PROJECT_NAME
pytm invoice manual

Check version:

pytm --version
pytm -v

For a list of all the available commands try:

pytm --help

Running the tests

• Clone this repository

• Install dependencies:

  pip install -r requirements.txt

• run the tests:

  py.test

Notes

• Author - Wasi - (wasi0013).

• License - see the LICENSE file.

• Contributing - see CONTRIBUTING.rst for detail. You can also help by creating issues.

• Version - see the tags on this repository.

• Acknowledgments - bootstrapped using this cookiecutter package.

• Built With :heart: using Python.

Documentation

The full documentation is at http://PyTM.rtfd.org.

History

0.0.1 (2018-10-23)

• First release on PyPI.

0.0.2 (2018-11-09)

• Second release on PyPI.

• Created Skeleton of the command line Interface.

0.0.3 (2023-10-18)

• Implemented data store in home directory.

• Made project commands functional.

0.0.4 (2023-10-28)

• Implemented state.

• Improved project commands.

0.0.5 (2023-10-30)

• Made task commands functional.

• Improved project summary.

• Project summary now shows total duration of the project.

0.0.6 (2023-10-31)

• bug fix

• readme and doc update

• Improved Command line interface outputs.

0.0.7 (2023-11-01)

• Added show sub command for project.

• Added json sub command for project.

• refactored project and task commands output messages.

• fixed bugs in project sub commands.

0.0.8 (2023-11-01)

• Added config sub command.

• added command to save default user information.

• refactored project and task commands.

• fixed bugs.

• added config command to configure project meta data such as title, billable? etc.

0.0.9 (2023-11-02)

• Added config invoice command for configuring default invoice texts and logo.

• Added invoice sub command.

• Added invoice manual command to generate manual invoice using prompts.

• Added invoice auto <Project> command to generate invoice from existing projects.

• invoice manual and auto command generates HTML invoices using Tailwind CSS and opens it in a Browser.

0.0.10 (2023-11-03)

• open invoices using python’s standard library.

• code refactor

• bug fix

0.0.11 (2023-11-03)

• Major bug fix.

0.0.12 (2023-11-04)

• Bug fix.

0.0.13 (2023-11-07)

• Made the init command optional.

0.0.14 (2023-11-07)

• config invoice command bug fix.

• copy logo instead of moving it permanently when configuring invoice.

• fixed f strings quote issue.

• made init command hidden.

• improved doc strings and help texts.