p4rss.html #10

  • //
  • guest/
  • jay_han/
  • p4rss/
  • p4rss.html
  • View
  • Commits
  • Open Download .zip Download (2 KB)
<html>
<head>
<title>p4rss</title>
<link rel="alternate" type="application/rss+xml" title="RSS feed about p4rss development hosted at Perforce public depot"> 
</head>
<body>
<h3>Name</h3>
p4rss.py - generate RSS feed from
<code>p4 changes -m 10</code>.
<h3>Synopsis</h3>
<code>python p4rss.py &gt; /path/to/rssfile.xml</code><br/>
p4rss.py generates 10 most recent changes from <code>//depot/...</code> or
the top of the depot. Users can specify their customizations by editing p4rss.ini file.
<dl>
	<dt>title<dd>name of RSS feed - useful for html rendering
	<dt>filespec<dd>argument for p4
	<dt>maxchanges<dd>value for -m option of p4
	<dt>site_url<dd>url of p4db
	<dt>maildomain<dd>if set, user info appears as email addresses
</dl>
<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 2.0 format.
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>
There is no support for caching and other advanced features.
<h3>Todo</h3>
Study web interfaces like p4db, p4web or  <a href="http://pyds.muensterland.org/">PyDS</a>
<h3>Download</h3>
<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="mailto:jhan@acm.org">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)