Politime

Command line tasks logger, to make your boss happy.

Principle

• It use a list of topics specified in json file which can be centralized.
• The user select one or more topics on which he worked today.
• Its results are saved in a json file and it can be exposed later, in the proper format.

Usage

List predefined topics :

$ politime list topics

Add topics on which you worked :

# Today
$ politime add

# Yesterday
$ politime add yesterday

# Another specific day
$ politime add 2017-10-23

To overwrite previously saved topics for a day, use set command instead of add :

# Today
$ politime set

List saved topics by days :

$ politime list

Requirement

• PHP 5.5 (accessibility over security)

Install

Clone the project :

$ git clone git@github.com:KuiKui/Politime.git /path-to-politime

Install dependencies :

$ cd /path-to-politime
$ composer install

The executable is in the bin/ directory, you can configure your $PATH :

$ export PATH=/path-to-politime/bin:$PATH

Configure topics

Update the topics.json file in the data directory containing a list of topics (see the it).

You can also configure an environment variable to specify a custom path to your topics file :

$ export POLITIME_TOPICS_FILENAME=/path-to-your-custom-data/my-custom-topics.json

It's possible to reach remote file to use centralized topics in a same team :

$ export POLITIME_TOPICS_FILENAME=http://path-to-your-custom-remote-data/team-remote-topics.json

Configure backups

By default, Politime save your activity in a json file timeslots.json in the data directory.

You can configure an environment variable to specify a custom path to your timeslots file :

$ export POLITIME_TIMESLOTS_FILENAME=/path-to-your-custom-data/politime-save.json