<html> <head> <title>p4rss</title> </head> <body> <h3>Name</h3> p4rss.py - generate RSS feed from <code>p4 changes -m 10</code>. <h3>Synopsis</h3> <code>python p4rss.py > /path/to/rssfile</code><br/> <code>python p4rss.py ... > /path/to/anotherrssfile</code><br/> <code>python p4rss.py //depot/jay_han/... > /path/to/yetanotherrssfile</code><br/> If no argument is given, p4rss.py generates 10 most recent changes from <code>//...</code> or the top of the depot. <h3>Description</h3> p4rss.py converts usual output from p4 changes e.g. <pre> 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' ... </pre> to RSS 0.91 format. For example see <a href="http://radio.weblogs.com/0107481/p4rss.xml" title="RSS feed about p4rss development hosted at Perforce public depot."> <img src="http://radio.weblogs.com/0107481/images/xml.gif" border="0" width="36" height="14" alt="RSS feed about p4rss development hosted at Perforce public depop." /> </a>p4rss.xml</a> - this is the RSS feed about p4rss development hosted at Perforce public depot. <br/> Run p4rss from a cron job to generate the RSS periodically. <p> Because p4rss.py uses vanilla p4, user can modify its behaviour with usual P4 environment variables. <h3>Bugs</h3> p4rss.py has many limitations: <ul> <li>no way to limit the change list to specific depot/branch.</li> <li>supports only RSS 0.91 and not other versions of RSS.</li> <li>p4 changes returns many data fields including <ul> <li>status: ignored</li> <li>client: ignored</li> <li>user: ignored </li> <li>code: ignored</li> <li>time: ignored</li> <li>change: displayed as <title> element</li> <li>desc: displayed as <description> element</li> </ul> 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?</li> <li><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. <a href="http://public.perforce.com/cgi-bin/p4db/changeView.cgi?CH=2781">2781</a>. To customize p4rss, edit p4rss.py (sorry).</li> <li>no support for caching and other advanced features.</li> </ul> <h3>Todo</h3> <ol> <li>study web interfaces like p4db, p4web or <a href="http://pyds.muensterland.org/">PyDS</a></li> <li>trim this doc comment as it's even longer than the code!</li> </ol> <h3>Download</h3> <a href="http://radio.weblogs.com/0107481/p4rss.zip">p4rss.zip</a> - contains p4rss.py, <a href="http://radio.weblogs.com/0107481/p4rss.html">p4rss.html</a> (this file), <a href="http://radio.weblogs.com/0107481/sample.p4rss.xml">sample.p4rss.xml</a>, <a href="http://radio.weblogs.com/0107481/p4rss.xml">p4rss.xml</a> and last10changes.txt - the RSS for p4rss developement and its text counterpart. <p> Two alternate downloads: <ul> <li><a href="http://public.perforce.com/cgi-bin/p4db/fileSearch.cgi?FSPC=%2F%2Fguest%2Fjay_han%2Fp4rss%2F...">p4rss via p4db</a></li> <li>via p4 directly: //guest/jay_han/p4rss</li> </ul> <hr/> Copyright 2003 <a href="http://radio.xmlstoragesystem.com/rcsPublic/mailto?usernum=0107481">Jay Han</a><br/> You are free to use it as long as you do not blame me for anything. </body>
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#10 | 3358 | Jay Han | added email option and updated release.bat | ||
#9 | 2858 | Jay Han | put <link> element to help auto discovery of RSS | ||
#8 | 2835 | Jay Han | update to mention optional file argument and default one //... | ||
#7 | 2830 | Jay Han | typo cleanup | ||
#6 | 2827 | Jay Han | RSS for p4rss = http://radio.weblogs.com/0107481/p4rss.xml | ||
#5 | 2814 | Jay Han |
p4rss.xml is the RSS feed for p4rss at public.perforce.com. Whenever I make a new release (by running release.bat), p4rss.xml should be posted to the website. |
||
#4 | 2812 | Jay Han | escape &, <, >, ", ' to HTML entities | ||
#3 | 2798 | Jay Han | customization information (or some lame excuses...) | ||
#2 | 2797 | Jay Han | rename index.html to p4rss.html | ||
#1 | 2793 | Jay Han | rename index.html to p4rss.html and modify release.bat to reflect this change. | ||
//guest/jay_han/p4rss/index.html | |||||
#5 | 2789 | Jay Han | update mail link | ||
#4 | 2788 | Jay Han | download from blog page, delete the often-regenerated sample.p4rss.xml | ||
#3 | 2782 | Jay Han | description comes from p4 describe, not the truncated p4 changes output. | ||
#2 | 2781 | Jay Han | pull out doc from p4rss.py, set url to public.perforce.com for now, also add a sample.p4rss.xml. | ||
#1 | 2780 | Jay Han | index.html for p4rss.py (copied docstring + email) |