Metadata-Version: 1.1
Name: timew
Version: 0.0.4
Summary: Python bindings for your timewarrior database
Home-page: https://gitlab.com/tjaart/python-timew
Author: Tjaart van der Walt
Author-email: tjaart@tjaart.org
License: MIT
Description: # timew - Python API for Timewarrior #
        
        ## Installation ##
        
        For this API to work, you need [Timewarrior](https://taskwarrior.org/docs/timewarrior/download.html) installed
        
        Installation is easy from the [Python Package Index](https://pypi.org/project/timew/)
        
        ```bash
        pip install timew
        ```
        
        ## Examples ##
        
        ```bash
        >>> from timew import TimeWarrior
        
        >>> timew = TimeWarrior()
        
        >>> timew.start(time=datetime(2018, 8, 15, 9, 0, 0), tags=['my tag'])
        Tracking "my tag"
        Started 2018-09-06T09:00:00
        Current         07T13:20:45
        Total              28:20:45
        
        >>> timew.cancel()
        Canceled active time tracking.
        
        >>> timew.delete(1)
        Deleted @1
        
        >>> timew.join(1, 2)
        Joined @1 and @2
        
        >>> from timew import Duration
        >>> from datetime import timedelta
        >>> timew.lengthen(1, Duration(timedelta(minutes=30)))
        Lengthened @1 by 0:30:00
        
        >>> timew.move(1, datetime(2018, 8, 15, 9, 0, 0))
        Moved @1 to 2018-09-05T09:00:00
        
        >>> timew.shorten(1, Duration(timedelta(minutes=10)))
        Shortened @1 by 0:10:00
        
        >>> timew.split(1)
        Split @1
        
        >>> timew.start(tags=['my tag'])
        Tracking "my tag"
        Started 2018-09-07T13:37:00
        Current               40:22
        Total               0:03:22
        
        >>> timew.stop()
        Recorded "my tag"
        Started 2018-09-07T13:37:00
        Ended                 40:53
        Total               0:03:53
        
        >>> timew.track(start_time=datetime(2018, 9, 7, 11, 0, 0), end_time=datetime(2018, 9, 7, 12, 0, 0))
        Tracking "from 20180907T110000 - 20180907T120000"
        Started 2018-09-07T13:42:27
        Current                  27
        Total               0:00:00
        ```
        
        
Keywords: timewarrior
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
