Metadata-Version: 2.0
Name: chakula
Version: 0.7.2
Summary: An RSS feed monitor mimicking tail -f
Home-page: https://github.com/reubano/chakula
Author: Reuben Cummings
Author-email: reubano@gmail.com
License: BSD
Download-URL: https://github.com/reubano/chakula/archive/v0.7.2.tar.gz
Keywords: chakula,An,RSS,feed,monitor,mimicking,tail,-f
Platform: MacOS X
Platform: Windows
Platform: Linux
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 3 - Alpha
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Framework :: Flask
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Requires-Dist: feedparser (>=5.2.1,<6.0.0)
Requires-Dist: pygogo (<0.10.0,>=0.9.1)
Requires-Dist: python-dateutil (<3.0.0,>=2.6.0)
Provides-Extra: develop
Requires-Dist: coverage (>=4.0.3,<5.0.0); extra == 'develop'
Requires-Dist: flake8 (<3.0.0,>=2.5.1); extra == 'develop'
Requires-Dist: manage.py (>=0.2.10,<0.3.0); extra == 'develop'
Requires-Dist: pep8 (>=1.5.7,<2.0.0); extra == 'develop'
Requires-Dist: pip (<10.0.0,>=9.0.0); extra == 'develop'
Requires-Dist: pkutils (>=0.13.6,<0.14.0); extra == 'develop'
Requires-Dist: pylint (>=1.5.2,<2.0.0); extra == 'develop'
Requires-Dist: pytest (>=3.0.6,<4.0.0); extra == 'develop'
Requires-Dist: scripttest (>=1.3,<2.0); extra == 'develop'
Requires-Dist: setuptools (<35.0.0,>=23.0.0); extra == 'develop'
Requires-Dist: tox (<3.0.0,>=2.3.1); extra == 'develop'
Requires-Dist: twine (>=1.8.1,<2.0.0); extra == 'develop'
Requires-Dist: virtualenv (>=15.1.0,<16.0.0); extra == 'develop'
Provides-Extra: redis
Requires-Dist: redisworks (>=0.2.7,<0.3.0); extra == 'redis'

chakula
=======

|versions| |pypi|

*chakula* is a Python library and command-line rss feed monitor with behavior
similar to ``tail -f``. *chakula* is based off of rsstail.py_, but can be used as
a library to call a custom function each time new entries appear in the feed.

Usage
-----

::

    $ chakula --help
    positional arguments:
      urls                  The urls to tail (default: reads from stdin).

    optional arguments:
      -h, --help            show this help message and exit
      -i INTERVAL, --interval INTERVAL
                            Number of seconds between polling (default: 300s).
      -N ITERATIONS, --iterations ITERATIONS
                            Number of times to poll before quiting (default: inf).
      -I INITIAL, --initial INITIAL
                            Number of entries to show (default: all)
      -n DATE, --newer DATE
                            Date by which entries should be newer than
      -s FIELD, --show FIELD
                            Entry field to display (default: title).
      -t FORMAT, --time-format FORMAT
                            The date/time format (default: 'YYYY/MM/DD HH:MM:SS').
      -F FORMAT, --format FORMAT
                            The output format (overrides other format options).
      -c CACHE, --cache CACHE
                            File path to store feed information across multiple runs.
      -r, --reverse         Show entries in reverse order.
      -f, --fail            Exit on error.
      -u, --unique          Skip duplicate entries.
      -H, --heading         Show field headings.
      -v, --version         Show version and exit.
      -V, --verbose         Increase output verbosity.

    Format specifiers must have one the following forms:
      %(placeholder)[flags]s
      {placeholder:flags}

    Examples:
      chakula <url>
      echo '<url>' | chakula --reverse
      chakula -s pubdate -s title -s author <url1> <url2> <url3>
      chakula --interval 60s --newer "2011/12/20 23:50:12" <url>
      chakula --format '%(timestamp)-30s %(title)s\n' <url>
      chakula --format '%(title)s was written on %(pubdate)s\n' <url>
      chakula --format '{timestamp:<30} {title} {author}\n' <url>
      chakula --format '{timestamp:<20} {pubdate:^30} {author:>30}\n' <url>
      chakula --time-format '%Y/%m/%d %H:%M:%S' <url>
      chakula --time-format 'Day of the year: %j Month: %b' <url>

    Useful flags in this context are:
      %(placeholder)-10s - left align and pad
      %(placeholder)10s  - right align and pad
      {placeholder:<10}  - left align and pad
      {placeholder:>10}  - right align and pad
      {placeholder:^10}  - center align and pad

    Available fields: author, comments, created, desc, description,
    expired, id, link, pubdate, timestamp, title, updated, url

Installing
----------

The latest stable version of chakula can be installed from pypi_:

.. code-block:: bash

    $ pip install chakula

Similar projects
----------------

    - rsstail.py_
    - rsstail_
    - feedstail_
    - theyoke_
    - wag_

License
-------

*chakula* is released under the terms of the `Revised BSD License`_.

.. |travis| image:: https://img.shields.io/travis/reubano/chakula/master.svg
    :target: https://travis-ci.org/reubano/chakula

.. |versions| image:: https://img.shields.io/pypi/pyversions/chakula.svg
    :target: https://pypi.python.org/pypi/chakula

.. |pypi| image:: https://img.shields.io/pypi/v/chakula.svg
    :target: https://pypi.python.org/pypi/chakula

.. _rsstail.py:    http://github.com/gvalkov/rsstail.py/
.. _rsstail:    http://www.vanheusden.com/rsstail/
.. _feedstail:  http://pypi.python.org/pypi/feedstail/
.. _theyoke:    http://github.com/mackers/theyoke/
.. _wag:        http://github.com/knobe/wag/
.. _feedparser: http://code.google.com/p/feedparser/
.. _`Revised BSD License`: https://raw.github.com/reubano/chakula.py/master/LICENSE
.. _pypi:        https://pypi.python.org/pypi/chakula



