Metadata-Version: 2.1
Name: tracklr
Version: 1.3.0
Summary: Tracklr - Command-line Productivity Toolset
Home-page: https://tracklr.com
Author: Marek Kuziel
Author-email: marek@kuziel.info
License: UNKNOWN
Download-URL: https://gitlab.com/markuz/tracklr/-/archive/master/tracklr-master.tar.bz2
Platform: Any
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Intended Audience :: Other Audience
Classifier: Environment :: Console
Requires-Dist: appdirs
Requires-Dist: cliff
Requires-Dist: icalendar
Requires-Dist: jinja2
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: xhtml2pdf

README
======

.. contents::
      :local:


Introduction
------------

``Tracklr`` is a command-line toolset for processing `iCalendar` feeds.


Installation
------------

Install ``tracklr`` via ``pip``::

    pip install tracklr


Dependencies
------------

``Tracklr`` requires the following packages installed::

    appdirs
    cliff
    icalendar
    jinja2
    pyfiglet   # Optional
    pyyaml
    requests
    xhtml2pdf


Configuration
-------------

Out of the box ``tracklr`` uses its own configuration stored in ``Tracklr.__config__``.

For PDF reports ``tracklr`` uses by default its own HTML template in ``tracklr.pdf.Pdf.__template__``.

``tracklr`` provides ``init`` command to create ``tracklr.yml`` and ``pdf.html`` files either in
user config directory eg. ``~/.config/tracklr/`` or current working directory (default).

See ``tracklr init --help`` for more details.


Usage
-----

::

    # setup local config
    tracklr init config

    # setup global pdf.html uses for all tracklr instances
    tracklr init template --user-config-dir

    # display info about the current instance
    tracklr info

    # show only 2019-02 events
    tracklr ls -d 2019-02

    # show only 2019 @tracklr events
    tracklr ls -d 2019 -i @tracklr

    # generate 2019 @tracklr PDF report 
    tracklr pdf -d 2019 -i @tracklr

    # show all hours matching tag #tags
    tracklr group -i "#tags"


Development
-----------

Pull requests welcomed.

``Tracklr`` git repository is available at https://gitlab.com/markuz/tracklr

For more information, see https://tracklr.com/development.html


Documentation
-------------

Project documentation for the current version is available at https://tracklr.com/

Source of the documentaton is available in the `Tracklr` repository
https://gitlab.com/markuz/tracklr/tree/master/docs/source


License
-------

`BSD 3-clause Clear License <https://gitlab.com/markuz/tracklr/blob/master/LICENSE>`_


