Skip to content

dejanfajfar/wdc

Repository files navigation

Logo

CI PyPI version

WDC

Log work effortlessly

About

Inspiration

Every company uses its own time tracking program. Sometimes as an freelancer I have to fill out multiple at once. If you are lucky those time tracking tools are actually useful and do not require exceeded effort to operate.

Sadly from my experience this is not always the case...

Another inspiration was to answer the question: How long do I have to work today?

Goals

WDC has the following goals in no particular order:

  • Easy to use (if possible)
  • Calculate the end time of the current work day
  • Log basic work information
    • Start time
    • End time
    • A descriptive message
  • Provide an easy way of grouping the logged work information
  • Export the logged items

Description

Because this is my tool, I have opted for a CLI tool that can be used on all systems. In order to achieve this WDC is written in python, which is readily available on all platforms.

TBD

Changelog

The changelog can be found here

Installation

From source code

Clone the repository:

git clone https://github.com/dejanfajfar/wdc.git .

If you have make available then simply execute the install target

make install

If make is not available on your system then you can run the underlying python command. For that you have to navigate to the directory containing the setup.py file. In that directory execute

python setup.py install

Using PIP

It is assumed that you have python and PIP installed

WDC is published as openly accessible package on pypi.org/project/wdc/.

Because of this it can be easilly installed using pip

$ pip install wdc

Formatting time

In order to make wdc faster usable from the CLI we opted to represent time and dates is a optimized format.

Details can be read at Date and Time format wiki page

Samples

25th of October 2020 ==> 2020-10-25

11:30am ==> 1130

4:30pm ==> 1630

...

Commands

WDC supports the following command: