https://github.com/jedrus2000/totra
an unofficial TopTracker CLI helper
https://github.com/jedrus2000/totra
cli command-line-tool toptal toptracker
Last synced: 5 months ago
JSON representation
an unofficial TopTracker CLI helper
- Host: GitHub
- URL: https://github.com/jedrus2000/totra
- Owner: jedrus2000
- License: mit
- Created: 2018-06-15T13:27:54.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-06-15T22:58:14.000Z (about 8 years ago)
- Last Synced: 2025-11-28T06:55:52.731Z (7 months ago)
- Topics: cli, command-line-tool, toptal, toptracker
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
totra
=====
*an unofficial TopTracker CLI helper*
Purpose
-------
[TopTracker](https://www.toptal.com/tracker) is great time tracking tool, but when
it comes to making polls, reports etc. I find CLI tools much more productive then
clicking around web page.
The idea went from simple question: *how much hours I've worked i.e this week ?*
With TopTracker web page, to know such information I had to: login to web page, click on
date range, export activities to csv, open spreadsheet software and import this csv,
and then sum.
With this tool I can just:
`totra how_much_hours --workers="Andrzej Bargański" --from=Monday -l my@login.com -p mypassword`
...and in second I see the answer !
Usage
-----
__*Notice:*__
*Application is still in planning stage. Commands, options etc. can change, and every*
*TopTracker user is invited to post thoughts, wishes and participate in development.*
```
totra activities [--format=] [--projects=] [--workers=] --from= [--to=] [-l login] [-p password] [-o output_filename]
totra how_much_hours [--projects=] [--workers=] --from= [--to=] [-l login] [-p password]
totra -h | --help
totra --version
Commands:
activities Output activities in --format.
how_much_hours Shows how much work hours are registered according to given parameters.
Options:
--format= Output format. Can be: json, excel. [default: json]
--projects= Projects names as coma separated list. Ex. 'Project 1' or 'Project 1,Project 2'
--workers= Workers as coma seprated list. Ex. 'Worker Name' or 'Worker Name 1, Worker Name 2'
--from= Date as beginning of period for data retrieval. Format is: YYYY-mm-dd , ex: 2018-05-01
--to= Date as end of period for data retrieval. Format is: YYYY-mm-dd , ex: 2018-05-01. [default: now].
-o output_filename Output filename to write data. Default is stdout (print on your screen) [default: stdout]
-h --help Show this screen.
--version Show version.
-l login User login name.
-p password User password.
```
Installation
------------
First if you missing Python 3.6 on your system, install it from [here](https://www.python.org/downloads/release/python-365/).
Then execute on command line :
`pip install totra`