https://github.com/trimailov/timeflow

Simple cli time tracker inspired by gtimelog
https://github.com/trimailov/timeflow

Last synced: about 2 months ago
JSON representation

Simple cli time tracker inspired by gtimelog

• Host: GitHub
• URL: https://github.com/trimailov/timeflow
• Owner: trimailov
• License: mit
• Created: 2015-09-21T20:13:01.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2018-07-28T09:35:09.000Z (over 6 years ago)
• Last Synced: 2024-09-18T10:45:33.676Z (3 months ago)
• Language: Python
• Size: 409 KB
• Stars: 17
• Watchers: 2
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred-test - trimailov/timeflow - Simple cli time tracker inspired by gtimelog (Python)

README

        
timeflow

========

simple CLI time logger, inspired by `gtimelog `_

.. image:: img/description.png

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 `_