A tail-f-like utility for feeds
Project description
Feedstail is a tail-f-like utility for feeds. It monitor a feed and emits new entries. Feedstail aim to be simple, hackable and compatible with rsstail its C brother.
License
Feedstail is released under the terms of the GNU General Public License v3 or later.
Get started
Use pip to install feedstail the easy way:
$ pip install feedstail
Or retrieve the project with git and install it:
$ git clone git://gitorious.org/feedstail/feedstail.git $ cd feedstail $ python setup.py install
Then, launch feedstail with the identi.ca feeds to test it:
$ feedstail -u http://identi.ca/api/statuses/public_timeline.atom
Examples
By default, feedstail will checkout the feeds every 15 minutes. If you want to customize this interval you can use the i option. The following example will retrieve feeds every 5 seconds:
$ feedstail -u http://identi.ca/api/statuses/public_timeline.atom -i 5
The default output format may not be ok for you. You can specify your own format using the f option. The given fields must be an available property of the feed entries. The following example will output the published date, the title and the link:
$ feedstail -u http://identi.ca/api/statuses/public_timeline.atom -f "{published}: {title} - {link}"
Feedstail compares the id element to find new entries. You can choose another element of comparison with the k option. The following example says to feedstail to use the title to find new entries:
$ feedstail -u http://identi.ca/api/statuses/public_timeline.atom -i 2 -k title
As feedstail is built above feedparser, the available values of format fields and keys can be found in the documentation of the library.
Contribute !
Fork the project: git://gitorious.org/feedstail/feedstail.git
Create your patch in a topic branch
Send pull requests or send your patches via e-mail
Don’t forget to mark your commits by one of the following flag:
[enh]: Your commit add a notable enhancement, a new feature for instance
[fix]: Your commit is a bugfix
[doc]: Your commit improve the documentation
[mod]: Your commit bring general changes, matching neither of the above, like refactoring
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.