pfython / time_is_money Goto Github PK

A common requirement is to log time to activities but with no intention of charging for them. This could be pro bono charity work, training/research/education, pre-sales effort etc. that someone wants to track even though it earns no money for them (directly).

Add the ability to set an hourly/daily rate on a per-client or per-client/task basis and included a calculation of total billable amount in get_totals() and hours_since().

Nice to have feature would be currency conversion since many freelancer websites work in USD ($) and/or function for calculating net/gross earnings e.g. after deduction of fees/tax based on a user-supplier formula.

Hello. I'm interested in this package. Finally, something made (currently, primarily?) for Windows 😆

I've got several questions, though:

1. How to use? My first instinct is to use python tim.pyw directly and see from there, but upon closer inspection I found that doing such won't use the refactored code in src directory at all.
2. How do I invoke the script like shown in README.md? I'm not used to PS (I prefer gitbash), and following exactly like README fails:

   PS E:\Git-LINE\pfython-tim\time_is_money> tim.pyw NAME_ONE NAME_TWO
   The term 'tim.pyw' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
   At line:1 char:8
   + tim.pyw <<<<  NAME_ONE NAME_TWO
       + CategoryInfo          : ObjectNotFound: (tim.pyw:String) [], CommandNotFoundException
       + FullyQualifiedErrorId : CommandNotFoundException
   
   Suggestion [3,General]: The command tim.pyw was not found, but does exist in the current location. Windows PowerShell doesn't load commands from the current location by default. If you trust this command, instead type ".\tim.pyw". See "get-help about_Command_Precedence" for more details.
   PS E:\Git-LINE\pfython-tim\time_is_money>

   If I follow PowerShell's suggestion, I got the "Open With" wizard (maybe Windows want me to associate .pyw with a python.exe somewhere). I don't feel that's a good thing?
   That being said, I can live with invoking python tim.pyw. I feel at least what I encountered should've been documented.
3. How to setup a virtual environment for developing this package? Apparently this package is not installable, or do I miss something? README.md currently doesn't tell anything about this.

Thanks in advance! Looking forward to contribute to this package, especially the "writing tests" part! 😄

Upwork.com has a really nice time logger IHMO. It optionally takes screenshots or webcam shots every X minutes to prove you're at your keyboard and/or show what you've been working on, as well as measuring mouse/keyboard activity and the title of open windows.

This enhancement would probably create a folder for each line in tim.csv, to contain screenshots and also a simple text file with activity information.

Quite intrusive some might say, but having used it a while it does actually work - gives the client a warm glow that they're not being cheated, and helps you fight the temptation to sneakily check social media (on your work device at least!) while you're supposed to be coding or testing...

Should be easy enough but in haste I've just left a global variable LAST_MONDAY to be updated manually. This is used by hour_since() as the default argument for checking how many hours have been recorded since a particular date - to answer client's inenvitable question "How many hours have you clocked up so far this week?".

Making it more generic/sophisticated would be a bonus, or offering a range of functions returning common queries e.g. hours worked this month, filtered by hours worked on a particular task or for a particular client.

The current version just keeps on adding new rows but most clients like to receive a timesheet for just the last reporting period (week, fortnight, month etc).

New function would produce that timesheet as a separate CSV file and strip the rows out of the active CSV file (default: tim.csv)