Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Small CLI time logger

Project Description

simple CLI time logger, inspired by gtimelog

Description

timeflow is a simple CLI time logger, used for logging your activities and featuring simple statistics and reporting capabilities

timeflow can be called using either tf or timeflow commands

Install

pip3 install timeflow

Written in python3. Best user experience with python3.

Tutorial

to start working (message content is not important)
>>> tf log "Arrived."

to save a timestamp and your log message,
when finished doing a task write
>>> tf log "Timeflow: create README.rst"

here 'Timeflow' is a 'project' you were working on and 'create README.rst'
is a log of what you were exactly doing this time. Both project and log
must be separated by a colon and space (``: ``).

some tasks are not (payable) work, mark them with two asterisks (**)
>>> tf log "Slack: chatting in the office ** "

you can have 'projects' without any explanations
>>> tf log "Lunch ** "
>>> tf log "Daily Scrum"

if you made a mistake, or missed to log of your activities
you can edit like this
>>> tf edit

this way timeflow will try to run your editor set in $EDITOR
or you can try
>>> tf edit -e vim

to open log file in vim

to check how much you've worked today
>>> tf stats

or to make a report
>>> tf stats --report

you can pass date ranges for stats command, e.g.
>>> tf stats --from 2015-01-01 --to 2015-01-31
>>> tf stats --from 2015-01-01 --to 2015-01-31 --report

Commands & options

log
log LOG_TEXT - create new log entry to timeflow’s log file.
edit

opens timeflow’s log file, by default trying to open an editor used in $EDITOR environment variable.

-e EDITOR - passes editor to be used in opening log file.

stats

shows today’s work and slack time.

-y, --yesterday - shows yesterday’s work and slack time.

-d DATE, --day DATE - shows arbitrary day’s work and slack time.

--week WEEK_NUMBER - shows arbitrary week’s work and slack time.

--this-week - shows this week’s work and slack time.

--last-week - shows last week’s work and slack time.

--month MONTH_NUMBER - shows arbitrary month’s work and slack time.

--this-month - shows this month’s work and slack time.

--last-month - shows last month’s work and slack time.

-f DATE, --from DATE - shows work and slack time, from DATE until today, if --to option is not used.

-t DATE, --to DATE - shows work and slack time, up to DATE. Must be used with --from option.

--report - shows report for today, or some other time range if specified using available options.

--report-as-gtimelog - same as --report, but the output is like in gtimelog

Release History

Release History

This version
History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
timeflow-0.2.4.tar.gz (8.9 kB) Copy SHA256 Checksum SHA256 Source Jan 30, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting