=====
 RSS 
=====
| 

about
-----
| 

:author:  Bart Thate <bart@gozerbot.org>
:contact: IRCNET/#dunkbots
:website: http://plugins.gozerbot.org
:license: Public Domain
 
| 

description
-----------
| 

manage rss feeds

| 

commands
--------
| 


1) rss-add

    rss-add <name> <url> to the rsswatcher

    ::

        <user> !rss-add gozerbot http://gozerbot.org/hg/gozerbot/?cmd=changelog;style=rss
        <output> rss item added

2) rss-addchannel

    rss-addchannel <name> [<botname>] <channel> ..add <channel> or <botname> <channel> to watchchannels of <name>

    ::

        <user> !rss-addchannel gozerbot #dunkbots
        <output> rss channel added

    ::

        <user> !rss-addchannel gozerbot main #dunkbots
        <output> rss channel added

3) rss-additemslist

    rss-additemslist <name> <item> .. add to itemslist of <name> 

    ::

        <user> !rss-additemslist gozerbot url
        <output> item added to itemslist

4) rss-channels

    rss-channels <name> .. show channels

    ::

        <user> !rss-channels gozerbot
        <output> #dunkbots .. ('main', '#dunkbots')

5) rss-del

    rss-del <name> .. remove <name> from the rsswatcher

    ::

        <user> !rss-del mekker
        <output> there is no mekker rss item

6) rss-delchannel

    rss-delchannel <name> [<botname>] <channel> .. delete <channel> or <botname> <channel> from watchchannels of <name>

    ::

        <user> !rss-delchannel gozerbot #dunkbots
        <output> rss channel deleted

    ::

        <user> !rss-delchannel gozerbot main #dunkbots
        <output> rss channel deleted

7) rss-delitemslist

    rss-delitemslist <name> <item> .. delete from itemslist of <name> 

    ::

        <user> !rss-delitemslist gozerbot url
        <output> item deleted from itemslist

8) rss-feeds

    rss-feeds <name> .. show what feeds are running in a channel

    ::

        <user> !rss-feeds
        <output> #test has no feeds running

    ::

        <user> !rss-feeds #dunkbots
        <output> #dunkbots has no feeds running

9) rss-get

    rss-get <name> .. get data from <name>

    ::

        <user> !rss-get gozerbot
        <output> use proper name in license - .. pyflake - .. gendoc related stuff - .. fix list output - .. use decode()
        <output>  in todefenc - .. tune gendoc - .. remove trbs .deb site from source command now that we are in testing/unstable
        <output>  - .. simplify infoitem's item added message - .. update gendoc - .. merge - .. hg/gozerbot Changelog
        <output>  -

10) rss-itemslist

    rss-itemslist <name> .. get itemslist of <name> 

    ::

        <user> !rss-itemslist gozerbot
        <output> title

11) rss-list

    get list of rss items

    ::

        <user> !rss-list
        <output> gozerbot

12) rss-running

    rss-running .. get running rsswatchers

    ::

        <user> !rss-running
        <output> nothing running yet

13) rss-scan

    rss-scan <name> .. get items of <name> 

    ::

        <user> !rss-scan gozerbot
        <output> description=11 .. title=11 .. link=11 .. pubDate=10 .. author=10

14) rss-setsleeptime

    rss-setsleeptime <name> <seconds> .. set sleeping time for <name> .. min 60 sec

    ::

        <user> !rss-setsleeptime gozerbot 600
        <output> sleeptime set

15) rss-sleeptime

    rss-sleeptime <name> .. get sleeping time for <name>

    ::

        <user> !rss-sleeptime gozerbot
        <output> sleeptime for gozerbot is 600 seconds

16) rss-stopwatch

    rss-stopwatch <name> .. stop polling <name>

    ::

        <user> !rss-stopwatch gozerbot
        <output> we are not watching gozerbot in #test

17) rss-sync

    rss-sync <name> .. sync data of <name>

    ::

        <user> !rss-sync gozerbot
        <output> gozerbot synced

18) rss-url

    rss-url <name> .. get url from rssitem with <name>

    ::

        <user> !rss-url gozerbot
        <output> url of gozerbot: http://gozerbot.org/hg/gozerbot/?cmd=changelog;style=rss

19) rss-watch

    rss-watch <name> [seconds to sleep] .. go watching <name>

    ::

        <user> !rss-watch gozerbot
        <output> watcher thread started

    ::

        <user> !rss-watch gozerbot 600
        <output> already watching gozerbot
