Name
p4rss.py - generate RSS feed from
p4 changes -m 10
.
Synopsis
python p4rss.py > /path/to/rssfile
Description
p4rss.py converts usual output from p4 changes e.g.
Change 10 on 2003/02/26 by hjh@p4rss 'Doc on RSS 0.91 vs 1.0, and cos'
Change 9 on 2003/02/26 by hjh@p4rss 'Add a bit more doc. '
Change 8 on 2003/02/26 by hjh@p4rss 'Documentation and cosmetic chan'
...
to RSS 0.91 format. For example see
p4rss.xml - this is the RSS feed
about p4rss development hosted at Perforce public depot.
Run p4rss from a cron job to generate the RSS periodically.
Because p4rss.py uses vanilla p4, user can modify its behaviour with
usual P4 environment variables.
Bugs
p4rss.py has many limitations:
- no way to limit the change list to specific depot/branch.
- supports only RSS 0.91 and not other versions of RSS.
- p4 changes and describe return many data fields including
- status: ignored
- client: ignored
- user: ignored
- code: ignored
- time: ignored
- change: displayed as <title> element
- desc: displayed as <description> element
User and time fields are useful information and need to be displayed.
Maybe more extensible RSS 1.0+ should be used instead of really simple 0.91?
- <link> element is set to http://public.perforce.com for now i.e. it is not
really meaningful.
As of 2781, <item> url is set to p4db url e.g. 2781.
To customize p4rss, edit p4rss.py (sorry).
- no support for caching and other advanced features.
Todo
- study web interfaces like p4db, p4web or PyDS
- trim this doc comment as it's even longer than the code!
Download
p4rss.zip -
contains p4rss.py,
p4rss.html (this file)
sample.p4rss.xml
p4rss.xml and last10changes.txt - the RSS for p4rss developement and its text counterpart.
Two alternate downloads:
Copyright 2003 Jay Han
You are free to use it as long as you do not blame me for anything.