Package: time-monitoring
Time monitoringThetime-monitoringpackage provides useful tools to monitor your time.
It can be used to improve productivity, or to generate invoice.InstallationRequirements:
The package is based on python and shell.We provide an installation through thepipypackage repository, hence you can use pip to download it.$ pip install time-monitoringIf you are working withcondaenvironments, make sure that your pip command is linked to conda by typing$ which pipand making sure that the output displays conda installation path.Once you have intall the package, you should initialize buffer files with the following command$ setup_time_reportBuffers files are kept in the foldertime-monitoringof your home directory.
This is specified by theBUFFER_PATHvariable in the filesrc/time_monitor/config.py.
If you want to modify this location, you should download the code source, modify those variables and build the package (e.g.by running$ python setup.py install).There is few variables that are fixed for you, that you might want to change if you were to use this package to it full potential.
In particular, there is macros defines in the filesys.prefix / latex / invoice / constants.texwheresys.prefixis the prefix of your python installation that can be check inpythonby importing thesysmodule and printing the value ofsys.prefix.FutureShell commandsThis package provides the following shell executables.Basic commandsThebegincommand$ begin <activity> -m --message "<optional message>"This command indicates that you have begun a new activity specified by<activity>,e.g.<activity>=work.
You may add a message such as"fixing issue 31".If you use this command while another activity was already declared, it will assume you just stop the precedent activity.Themessagecommand$ message "<message>" "<first optional message>" [...] "<final optional message>"This command allows you to add a message without modifying the activity you are currently pursuing.
For example, if you have already declare being in your spare time and decide to read the press and would like to monitor this, you can add the message"reading the press".Thestopcommand$ stopWhen you stop an activity and do not begin a new one, run this command.Thereportcommand$ reportThis command saves all activities recorded since last report in order to generate a new report.
This is useful to generate statistics or invoices.Reports are numbered according the the format<YYYY><MM><NB>where<YYYY>and<MM>denominates the current year and month and<NB>is counting the number of reports generated so far in the month.Past activity reports are kept in adatafolder specified by the variableDATA_PATHof thetime_monitoring/config.pyfile.Advanced commandsTheactivitycommand$ activityThis command opens the buffer file that records your current activity.
It is useful to check make sure you have declared it correctly and eventually correct it.Thestatscommand$ stats -r --report <report number>This command sums up current period activities, or the activities saved in the report<report number>.Theinvoicecommand$ invoice -a --activity <activity> -r --report <report number> -p --price <hourly rate> -c --change <change rate> -i --invoice <invoice number>This command is useful to generate invoices.
You can bill at a given<hourly rate>price for a given<activity>regarding houred reported in the report<report number>.
The generated pdf file will be located in thelatexfolder of this code source.