]> git.netwichtig.de Git - user/henk/code/ruby/rbot.git/blob - data/rbot/plugins/rss.rb
acebda9cc0d030d48afee4ea63c7fda2dac8c13a
[user/henk/code/ruby/rbot.git] / data / rbot / plugins / rss.rb
1 #-- vim:sw=2:et\r
2 #++\r
3 #\r
4 # RSS feed plugin for RubyBot\r
5 # (c) 2004 Stanislav Karchebny <berkus@madfire.net>\r
6 # (c) 2005 Ian Monroe <ian@monroe.nu>\r
7 # (c) 2005 Mark Kretschmann <markey@web.de>\r
8 # (c) 2006 Giuseppe Bilotta <giuseppe.bilotta@gmail.com>\r
9 #\r
10 # Licensed under MIT License.\r
11 \r
12 require 'rss/parser'\r
13 require 'rss/1.0'\r
14 require 'rss/2.0'\r
15 require 'rss/dublincore'\r
16 # begin\r
17 #   require 'rss/dublincore/2.0'\r
18 # rescue\r
19 #   warning "Unable to load RSS libraries, RSS plugin functionality crippled"\r
20 # end\r
21 \r
22 class ::RssBlob\r
23   attr_accessor :url\r
24   attr_accessor :handle\r
25   attr_accessor :type\r
26   attr :watchers\r
27   attr_accessor :refresh_rate\r
28   attr_accessor :xml\r
29   attr_accessor :title\r
30   attr_accessor :items\r
31   attr_accessor :mutex\r
32 \r
33   def initialize(url,handle=nil,type=nil,watchers=[], xml=nil)\r
34     @url = url\r
35     if handle\r
36       @handle = handle\r
37     else\r
38       @handle = url\r
39     end\r
40     @type = type\r
41     @watchers=[]\r
42     @refresh_rate = nil\r
43     @xml = xml\r
44     @title = nil\r
45     @items = nil\r
46     @mutex = Mutex.new\r
47     sanitize_watchers(watchers)\r
48   end\r
49 \r
50   def dup\r
51     self.class.new(@url,\r
52                    @handle,\r
53                    @type ? @type.dup : nil,\r
54                    @watchers.dup,\r
55                    @xml ? @xml.dup : nil)\r
56   end\r
57 \r
58   # Downcase all watchers, possibly turning them into Strings if they weren't\r
59   def sanitize_watchers(list=@watchers)\r
60     ls = list.dup\r
61     @watchers.clear\r
62     ls.each { |w|\r
63       add_watch(w)\r
64     }\r
65   end\r
66 \r
67   def watched?\r
68     !@watchers.empty?\r
69   end\r
70 \r
71   def watched_by?(who)\r
72     @watchers.include?(who.downcase)\r
73   end\r
74 \r
75   def add_watch(who)\r
76     if watched_by?(who)\r
77       return nil\r
78     end\r
79     @watchers << who.downcase\r
80     return who\r
81   end\r
82 \r
83   def rm_watch(who)\r
84     @watchers.delete(who.downcase)\r
85   end\r
86 \r
87   def to_a\r
88     [@handle,@url,@type,@refresh_rate,@watchers]\r
89   end\r
90 \r
91   def to_s(watchers=false)\r
92     if watchers\r
93       a = self.to_a.flatten\r
94     else\r
95       a = self.to_a[0,3]\r
96     end\r
97     a.compact.join(" | ")\r
98   end\r
99 end\r
100 \r
101 class RSSFeedsPlugin < Plugin\r
102   BotConfig.register BotConfigIntegerValue.new('rss.head_max',\r
103     :default => 30, :validate => Proc.new{|v| v > 0 && v < 200},\r
104     :desc => "How many characters to use of a RSS item header")\r
105 \r
106   BotConfig.register BotConfigIntegerValue.new('rss.text_max',\r
107     :default => 90, :validate => Proc.new{|v| v > 0 && v < 400},\r
108     :desc => "How many characters to use of a RSS item text")\r
109 \r
110   BotConfig.register BotConfigIntegerValue.new('rss.thread_sleep',\r
111     :default => 300, :validate => Proc.new{|v| v > 30},\r
112     :desc => "How many seconds to sleep before checking RSS feeds again")\r
113 \r
114   def initialize\r
115     super\r
116     if @registry.has_key?(:feeds)\r
117       @feeds = @registry[:feeds]\r
118       @feeds.keys.grep(/[A-Z]/) { |k|\r
119         @feeds[k.downcase] = @feeds[k]\r
120         @feeds.delete(k)\r
121       }\r
122       @feeds.each { |k, f|\r
123         f.mutex = Mutex.new unless f.mutex\r
124         f.sanitize_watchers\r
125         parseRss(f) if f.xml\r
126       }\r
127     else\r
128       @feeds = Hash.new\r
129     end\r
130     @watch = Hash.new\r
131     rewatch_rss\r
132   end\r
133 \r
134   def name\r
135     "rss"\r
136   end\r
137 \r
138   def watchlist\r
139     @feeds.select { |h, f| f.watched? }\r
140   end\r
141 \r
142   def cleanup\r
143     stop_watches\r
144   end\r
145 \r
146   def save\r
147     unparsed = Hash.new()\r
148     @feeds.each { |k, f|\r
149       f.mutex.synchronize do\r
150         unparsed[k] = f.dup\r
151       end\r
152     }\r
153     unparsed.each { |k, f|\r
154       debug f.inspect\r
155     }\r
156     @registry[:feeds] = unparsed\r
157   end\r
158 \r
159   def stop_watch(handle)\r
160     if @watch.has_key?(handle)\r
161       begin\r
162         debug "Stopping watch #{handle}"\r
163         @bot.timer.remove(@watch[handle])\r
164         @watch.delete(handle)\r
165       rescue => e\r
166         report_problem("Failed to stop watch for #{handle}", e, nil)\r
167       end\r
168     end\r
169   end\r
170 \r
171   def stop_watches\r
172     @watch.each_key { |k|\r
173       stop_watch(k)\r
174     }\r
175   end\r
176 \r
177   def help(plugin,topic="")\r
178     case topic\r
179     when "show"\r
180       "rss show #{Bold}handle#{Bold} [#{Bold}limit#{Bold}] : show #{Bold}limit#{Bold} (default: 5, max: 15) entries from rss #{Bold}handle#{Bold}; #{Bold}limit#{Bold} can also be in the form a..b, to display a specific range of items"\r
181     when "list"\r
182       "rss list [#{Bold}handle#{Bold}] : list all rss feeds (matching #{Bold}handle#{Bold})"\r
183     when "watched"\r
184       "rss watched [#{Bold}handle#{Bold}] : list all watched rss feeds (matching #{Bold}handle#{Bold})"\r
185     when "add"\r
186       "rss add #{Bold}handle#{Bold} #{Bold}url#{Bold} [#{Bold}type#{Bold}] : add a new rss called #{Bold}handle#{Bold} from url #{Bold}url#{Bold} (of type #{Bold}type#{Bold})"\r
187     when "change"\r
188       "rss change #{Bold}what#{Bold} of #{Bold}handle#{Bold} to #{Bold}new#{Bold} : change the #{Underline}handle#{Underline}, #{Underline}url#{Underline}, #{Underline}type#{Underline} or #{Underline}refresh#{Underline} rate of rss called #{Bold}handle#{Bold} to value #{Bold}new#{Bold}"\r
189     when /^(del(ete)?|rm)$/\r
190       "rss del(ete)|rm #{Bold}handle#{Bold} : delete rss feed #{Bold}handle#{Bold}"\r
191     when "replace"\r
192       "rss replace #{Bold}handle#{Bold} #{Bold}url#{Bold} [#{Bold}type#{Bold}] : try to replace the url of rss called #{Bold}handle#{Bold} with #{Bold}url#{Bold} (of type #{Bold}type#{Bold}); only works if nobody else is watching it"\r
193     when "forcereplace"\r
194       "rss forcereplace #{Bold}handle#{Bold} #{Bold}url#{Bold} [#{Bold}type#{Bold}] : replace the url of rss called #{Bold}handle#{Bold} with #{Bold}url#{Bold} (of type #{Bold}type#{Bold})"\r
195     when "watch"\r
196       "rss watch #{Bold}handle#{Bold} [#{Bold}url#{Bold} [#{Bold}type#{Bold}]] : watch rss #{Bold}handle#{Bold} for changes; when the other parameters are present, it will be created if it doesn't exist yet"\r
197     when /(un|rm)watch/\r
198       "rss unwatch|rmwatch #{Bold}handle#{Bold} : stop watching rss #{Bold}handle#{Bold} for changes"\r
199     when "rewatch"\r
200       "rss rewatch : restart threads that watch for changes in watched rss"\r
201     else\r
202       "manage RSS feeds: rss show|list|watched|add|change|del(ete)|rm|(force)replace|watch|unwatch|rmwatch|rewatch"\r
203     end\r
204   end\r
205 \r
206   def report_problem(report, e=nil, m=nil)\r
207     if m && m.respond_to?(:reply)\r
208       m.reply report\r
209     else\r
210       warning report\r
211     end\r
212     if e\r
213       debug e.inspect\r
214       debug e.backtrace.join("\n") if e.respond_to?(:backtrace)\r
215     end\r
216   end\r
217 \r
218   def show_rss(m, params)\r
219     handle = params[:handle]\r
220     lims = params[:limit].to_s.match(/(\d+)(?:..(\d+))?/)\r
221     debug lims.to_a.inspect\r
222     if lims[2]\r
223       ll = [[lims[1].to_i-1,lims[2].to_i-1].min,  0].max\r
224       ul = [[lims[1].to_i-1,lims[2].to_i-1].max, 14].min\r
225       rev = lims[1].to_i > lims[2].to_i\r
226     else\r
227       ll = 0\r
228       ul = [[lims[1].to_i-1, 0].max, 14].min\r
229       rev = false\r
230     end\r
231 \r
232     feed = @feeds.fetch(handle.downcase, nil)\r
233     unless feed\r
234       m.reply "I don't know any feeds named #{handle}"\r
235       return\r
236     end\r
237 \r
238     m.reply "lemme fetch it..."\r
239     title = items = nil\r
240     fetched = fetchRss(feed, m)\r
241     return unless fetched or feed.xml\r
242     if not fetched and feed.items\r
243       m.reply "using old data"\r
244     else\r
245       parsed = parseRss(feed, m)\r
246       m.reply "using old data" unless parsed\r
247     end\r
248     return unless feed.items\r
249     title = feed.title\r
250     items = feed.items\r
251 \r
252     # We sort the feeds in freshness order (newer ones first)\r
253     items = freshness_sort(items)\r
254     disp = items[ll..ul]\r
255     disp.reverse! if rev\r
256 \r
257     m.reply "Channel : #{title}"\r
258     disp.each do |item|\r
259       printFormattedRss(feed, item, {:places=>[m.replyto],:handle=>nil,:date=>true})\r
260     end\r
261   end\r
262 \r
263   def itemDate(item,ex=nil)\r
264     return item.pubDate if item.respond_to?(:pubDate) and item.pubDate\r
265     return item.date if item.respond_to?(:date) and item.date\r
266     return ex\r
267   end\r
268 \r
269   def freshness_sort(items)\r
270     notime = Time.at(0)\r
271     items.sort { |a, b|\r
272       itemDate(b, notime) <=> itemDate(a, notime)\r
273     }\r
274   end\r
275 \r
276   def list_rss(m, params)\r
277     wanted = params[:handle]\r
278     reply = String.new\r
279     @feeds.each { |handle, feed|\r
280       next if wanted and !handle.match(/#{wanted}/i)\r
281       reply << "#{feed.handle}: #{feed.url} (in format: #{feed.type ? feed.type : 'default'})"\r
282       (reply << " refreshing every #{Utils.secs_to_string(feed.refresh_rate)}") if feed.refresh_rate\r
283       (reply << " (watched)") if feed.watched_by?(m.replyto)\r
284       reply << "\n"\r
285     }\r
286     if reply.empty?\r
287       reply = "no feeds found"\r
288       reply << " matching #{wanted}" if wanted\r
289     end\r
290     m.reply reply\r
291   end\r
292 \r
293   def watched_rss(m, params)\r
294     wanted = params[:handle]\r
295     reply = String.new\r
296     watchlist.each { |handle, feed|\r
297       next if wanted and !handle.match(/#{wanted}/i)\r
298       next unless feed.watched_by?(m.replyto)\r
299       reply << "#{feed.handle}: #{feed.url} (in format: #{feed.type ? feed.type : 'default'})"\r
300       (reply << " refreshing every #{Utils.secs_to_string(feed.refresh_rate)}") if feed.refresh_rate\r
301       reply << "\n"\r
302     }\r
303     if reply.empty?\r
304       reply = "no watched feeds"\r
305       reply << " matching #{wanted}" if wanted\r
306     end\r
307     m.reply reply\r
308   end\r
309 \r
310   def add_rss(m, params, force=false)\r
311     handle = params[:handle]\r
312     url = params[:url]\r
313     unless url.match(/https?/)\r
314       m.reply "I only deal with feeds from HTTP sources, so I can't use #{url} (maybe you forgot the handle?)"\r
315       return\r
316     end\r
317     type = params[:type]\r
318     if @feeds.fetch(handle.downcase, nil) && !force\r
319       m.reply "There is already a feed named #{handle} (URL: #{@feeds[handle.downcase].url})"\r
320       return\r
321     end\r
322     unless url\r
323       m.reply "You must specify both a handle and an url to add an RSS feed"\r
324       return\r
325     end\r
326     @feeds[handle.downcase] = RssBlob.new(url,handle,type)\r
327     reply = "Added RSS #{url} named #{handle}"\r
328     if type\r
329       reply << " (format: #{type})"\r
330     end\r
331     m.reply reply\r
332     return handle\r
333   end\r
334 \r
335   def change_rss(m, params)\r
336     handle = params[:handle].downcase\r
337     feed = @feeds.fetch(handle, nil)\r
338     unless feed\r
339       m.reply "No such feed with handle #{handle}"\r
340       return\r
341     end\r
342     case params[:what].intern\r
343     when :handle\r
344       new = params[:new].downcase\r
345       if @feeds.key?(new) and @feeds[new]\r
346         m.reply "There already is a feed with handle #{new}"\r
347         return\r
348       else\r
349         feed.mutex.synchronize do\r
350           @feeds[new] = feed\r
351           @feeds.delete(handle)\r
352           feed.handle = new\r
353         end\r
354         handle = new\r
355       end\r
356     when :url\r
357       new = params[:new]\r
358       feed.mutex.synchronize do\r
359         feed.url = new\r
360       end\r
361     when :format, :type\r
362       new = params[:new]\r
363       new = nil if new == 'default'\r
364       feed.mutex.synchronize do\r
365         feed.type = new\r
366       end\r
367     when :refresh\r
368       new = params[:new].to_i\r
369       new = nil if new == 0\r
370       feed.mutex.synchronize do\r
371         feed.refresh_rate = new\r
372       end\r
373     else\r
374       m.reply "Don't know how to change #{params[:what]} for feeds"\r
375       return\r
376     end\r
377     m.reply "Feed changed:"\r
378     list_rss(m, {:handle => handle})\r
379   end\r
380 \r
381   def del_rss(m, params, pass=false)\r
382     feed = unwatch_rss(m, params, true)\r
383     if feed.watched?\r
384       m.reply "someone else is watching #{feed.handle}, I won't remove it from my list"\r
385       return\r
386     end\r
387     @feeds.delete(feed.handle.downcase)\r
388     m.okay unless pass\r
389     return\r
390   end\r
391 \r
392   def replace_rss(m, params)\r
393     handle = params[:handle]\r
394     if @feeds.key?(handle.downcase)\r
395       del_rss(m, {:handle => handle}, true)\r
396     end\r
397     if @feeds.key?(handle.downcase)\r
398       m.reply "can't replace #{feed.handle}"\r
399     else\r
400       add_rss(m, params, true)\r
401     end\r
402   end\r
403 \r
404   def forcereplace_rss(m, params)\r
405     add_rss(m, params, true)\r
406   end\r
407 \r
408   def watch_rss(m, params)\r
409     handle = params[:handle]\r
410     url = params[:url]\r
411     type = params[:type]\r
412     if url\r
413       add_rss(m, params)\r
414     end\r
415     feed = @feeds.fetch(handle.downcase, nil)\r
416     if feed\r
417       if feed.add_watch(m.replyto)\r
418         watchRss(feed, m)\r
419         m.okay\r
420       else\r
421         m.reply "Already watching #{feed.handle}"\r
422       end\r
423     else\r
424       m.reply "Couldn't watch feed #{handle} (no such feed found)"\r
425     end\r
426   end\r
427 \r
428   def unwatch_rss(m, params, pass=false)\r
429     handle = params[:handle].downcase\r
430     unless @feeds.has_key?(handle)\r
431       m.reply("dunno that feed")\r
432       return\r
433     end\r
434     feed = @feeds[handle]\r
435     if feed.rm_watch(m.replyto)\r
436       m.reply "#{m.replyto} has been removed from the watchlist for #{feed.handle}"\r
437     else\r
438       m.reply("#{m.replyto} wasn't watching #{feed.handle}") unless pass\r
439     end\r
440     if !feed.watched?\r
441       stop_watch(handle)\r
442     end\r
443     return feed\r
444   end\r
445 \r
446   def rewatch_rss(m=nil, params=nil)\r
447     stop_watches\r
448 \r
449     # Read watches from list.\r
450     watchlist.each{ |handle, feed|\r
451       watchRss(feed, m)\r
452     }\r
453     m.okay if m\r
454   end\r
455 \r
456   private\r
457   def watchRss(feed, m=nil)\r
458     if @watch.has_key?(feed.handle)\r
459       report_problem("watcher thread for #{feed.handle} is already running", nil, m)\r
460       return\r
461     end\r
462     status = Hash.new\r
463     status[:failures] = 0\r
464     @watch[feed.handle] = @bot.timer.add(0, status) {\r
465       debug "watcher for #{feed} started"\r
466       failures = status[:failures]\r
467       begin\r
468         debug "fetching #{feed}"\r
469         oldxml = feed.xml ? feed.xml.dup : nil\r
470         unless fetchRss(feed)\r
471           failures += 1\r
472         else\r
473           if oldxml and oldxml == feed.xml\r
474             debug "xml for #{feed} didn't change"\r
475             failures -= 1 if failures > 0\r
476           else\r
477             if not feed.items\r
478               debug "no previous items in feed #{feed}"\r
479               parseRss(feed)\r
480               failures -= 1 if failures > 0\r
481             else\r
482               otxt = feed.items.map { |item| item.to_s }\r
483               unless parseRss(feed)\r
484                 debug "no items in feed #{feed}"\r
485                 failures += 1\r
486               else\r
487                 debug "Checking if new items are available for #{feed}"\r
488                 failures -= 1 if failures > 0\r
489                 dispItems = feed.items.reject { |item|\r
490                   otxt.include?(item.to_s)\r
491                 }\r
492                 if dispItems.length > 0\r
493                   debug "Found #{dispItems.length} new items in #{feed}"\r
494                   # When displaying watched feeds, publish them from older to newer\r
495                   dispItems.reverse.each { |item|\r
496                     printFormattedRss(feed, item)\r
497                   }\r
498                 else\r
499                   debug "No new items found in #{feed}"\r
500                 end\r
501               end\r
502             end\r
503           end\r
504         end\r
505       rescue Exception => e\r
506         error "Error watching #{feed}: #{e.inspect}"\r
507         debug e.backtrace.join("\n")\r
508         failures += 1\r
509       end\r
510 \r
511       status[:failures] = failures\r
512 \r
513       feed.mutex.synchronize do\r
514         seconds = (feed.refresh_rate || @bot.config['rss.thread_sleep']) * (failures + 1)\r
515         seconds += seconds * (rand(100)-50)/100\r
516         debug "watcher for #{feed} going to sleep #{seconds} seconds.."\r
517         @bot.timer.reschedule(@watch[feed.handle], seconds)\r
518       end\r
519     }\r
520     debug "watcher for #{feed} added"\r
521   end\r
522 \r
523   def printFormattedRss(feed, item, opts=nil)\r
524     places = feed.watchers\r
525     handle = "::#{feed.handle}:: "\r
526     date = String.new\r
527     if opts\r
528       places = opts[:places] if opts.key?(:places)\r
529       handle = opts[:handle].to_s if opts.key?(:handle)\r
530       if opts.key?(:date) && opts[:date]\r
531         if item.respond_to?(:pubDate) \r
532           if item.pubDate.class <= Time\r
533             date = item.pubDate.strftime("%Y/%m/%d %H.%M.%S")\r
534           else\r
535             date = item.pubDate.to_s\r
536           end\r
537         elsif  item.respond_to?(:date)\r
538           if item.date.class <= Time\r
539             date = item.date.strftime("%Y/%m/%d %H.%M.%S")\r
540           else\r
541             date = item.date.to_s\r
542           end\r
543         else\r
544           date = "(no date)"\r
545         end\r
546         date += " :: "\r
547       end\r
548     end\r
549     title = "#{Bold}#{item.title.chomp.riphtml}#{Bold}" if item.title\r
550     desc = item.description.gsub(/\s+/,' ').strip.riphtml if item.description\r
551     link = item.link.chomp if item.link\r
552     line1 = nil\r
553     line2 = nil\r
554     case feed.type\r
555     when 'blog'\r
556       line1 = "#{handle}#{date}#{item.category.content} blogged at #{link}"\r
557       line2 = "#{handle}#{title} - #{desc}"\r
558     when 'forum'\r
559       line1 = "#{handle}#{date}#{title}#{' @ ' if item.title && item.link}#{link}"\r
560     when 'wiki'\r
561       line1 = "#{handle}#{date}#{title}#{' @ ' if item.title && item.link}#{link} has been edited by #{item.dc_creator}. #{desc}"\r
562     when 'gmane'\r
563       line1 = "#{handle}#{date}Message #{title} sent by #{item.dc_creator}. #{desc}"\r
564     when 'trac'\r
565       line1 = "#{handle}#{date}#{title} @ #{link}"\r
566       unless item.title =~ /^Changeset \[(\d+)\]/\r
567         line2 = "#{handle}#{date}#{desc}"\r
568       end\r
569     else\r
570       line1 = "#{handle}#{date}#{title}#{' @ ' if item.title && item.link}#{link}"\r
571     end\r
572     places.each { |loc|\r
573       @bot.say loc, line1, :overlong => :truncate\r
574       next unless line2\r
575       @bot.say loc, line2, :overlong => :truncate\r
576     }\r
577   end\r
578 \r
579   def fetchRss(feed, m=nil)\r
580     begin\r
581       # Use 60 sec timeout, cause the default is too low\r
582       xml = @bot.httputil.get_cached(feed.url, 60, 60)\r
583     rescue URI::InvalidURIError, URI::BadURIError => e\r
584       report_problem("invalid rss feed #{feed.url}", e, m)\r
585       return nil\r
586     rescue => e\r
587       report_problem("error getting #{feed.url}", e, m)\r
588       return nil\r
589     end\r
590     debug "fetched #{feed}"\r
591     unless xml\r
592       report_problem("reading feed #{feed} failed", nil, m)\r
593       return nil\r
594     end\r
595     feed.mutex.synchronize do\r
596       feed.xml = xml\r
597     end\r
598     return true\r
599   end\r
600 \r
601   def parseRss(feed, m=nil)\r
602     return nil unless feed.xml\r
603     feed.mutex.synchronize do\r
604       xml = feed.xml\r
605       begin\r
606         ## do validate parse\r
607         rss = RSS::Parser.parse(xml)\r
608         debug "parsed #{feed}"\r
609       rescue RSS::InvalidRSSError\r
610         ## do non validate parse for invalid RSS 1.0\r
611         begin\r
612           rss = RSS::Parser.parse(xml, false)\r
613         rescue RSS::Error => e\r
614           report_problem("parsing rss stream failed, whoops =(", e, m)\r
615           return nil\r
616         end\r
617       rescue RSS::Error => e\r
618         report_problem("parsing rss stream failed, oioi", e, m)\r
619         return nil\r
620       rescue => e\r
621         report_problem("processing error occured, sorry =(", e, m)\r
622         return nil\r
623       end\r
624       items = []\r
625       if rss.nil?\r
626         report_problem("#{feed} does not include RSS 1.0 or 0.9x/2.0", nil, m)\r
627       else\r
628         begin\r
629           rss.output_encoding = 'UTF-8'\r
630         rescue RSS::UnknownConvertMethod => e\r
631           report_problem("bah! something went wrong =(", e, m)\r
632           return nil\r
633         end\r
634         rss.channel.title ||= "Unknown"\r
635         title = rss.channel.title\r
636         rss.items.each do |item|\r
637           item.title ||= "Unknown"\r
638           items << item\r
639         end\r
640       end\r
641 \r
642       if items.empty?\r
643         report_problem("no items found in the feed, maybe try weed?", e, m)\r
644         return nil\r
645       end\r
646       feed.title = title\r
647       feed.items = items\r
648       return true\r
649     end\r
650   end\r
651 end\r
652 \r
653 plugin = RSSFeedsPlugin.new\r
654 \r
655 plugin.map 'rss show :handle :limit',\r
656   :action => 'show_rss',\r
657   :requirements => {:limit => /^\d+(?:\.\.\d+)?$/},\r
658   :defaults => {:limit => 5}\r
659 plugin.map 'rss list :handle',\r
660   :action => 'list_rss',\r
661   :defaults =>  {:handle => nil}\r
662 plugin.map 'rss watched :handle',\r
663   :action => 'watched_rss',\r
664   :defaults =>  {:handle => nil}\r
665 plugin.map 'rss add :handle :url :type',\r
666   :action => 'add_rss',\r
667   :defaults => {:type => nil}\r
668 plugin.map 'rss change :what of :handle to :new',\r
669   :action => 'change_rss',\r
670   :requirements => { :what => /handle|url|format|type|refresh/ }\r
671 plugin.map 'rss change :what for :handle to :new',\r
672   :action => 'change_rss',\r
673   :requirements => { :what => /handle|url|format|type|refesh/ }\r
674 plugin.map 'rss del :handle',\r
675   :action => 'del_rss'\r
676 plugin.map 'rss delete :handle',\r
677   :action => 'del_rss'\r
678 plugin.map 'rss rm :handle',\r
679   :action => 'del_rss'\r
680 plugin.map 'rss replace :handle :url :type',\r
681   :action => 'replace_rss',\r
682   :defaults => {:type => nil}\r
683 plugin.map 'rss forcereplace :handle :url :type',\r
684   :action => 'forcereplace_rss',\r
685   :defaults => {:type => nil}\r
686 plugin.map 'rss watch :handle :url :type',\r
687   :action => 'watch_rss',\r
688   :defaults => {:url => nil, :type => nil}\r
689 plugin.map 'rss unwatch :handle',\r
690   :action => 'unwatch_rss'\r
691 plugin.map 'rss rmwatch :handle',\r
692   :action => 'unwatch_rss'\r
693 plugin.map 'rss rewatch',\r
694   :action => 'rewatch_rss'\r
695 \r