ChangeLog

   1 2007-01-30  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
   2
   3         * New IRC Framework: Server methods to retrieve a Channel or User are
   4         now more robust to empty or nil nicks and channel names passed as
   5         parameters.
   6
   7 2007-01-29  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
   8
   9         * Timer rescheduling: it is now possible to reschedule the period
  10         any particular Action is taken by issuing the command
  11                 @bot.timer.reschedule(handle, new_period)
  12         where +handle+ is a timer handle returned by the @bot.timer.add() that
  13         created the action, and new_period is the new period for the Action.
  14
  15 2007-01-23  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  16
  17         * Reduced saving: the salut, lart, and quotes plugin now only save
  18         their datafiles if anything changed since last time. This speeds up
  19         operations such as saving and rescanning; it also allow hand-editing
  20         of the data files while the bot is running, since a rescan will load
  21         the changed data files without overwriting them with a useless save
  22         before. Of course this only works if there are no pending changes in
  23         the running bot.
  24
  25 2007-01-12  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  26
  27         * Server timeout: rework the server timeout code. Instead of PINGing
  28         the server unconditionally every server.ping_timeout seconds, we only
  29         PING it if we don't receive anything in the user-chosen timeout (lazy
  30         PING). The code rewrite also seems to have fixed the "bot stalling
  31         doing nothing" problem, which seemed to have been a consequence of
  32         @socket.select not having a timeout.
  33
  34 2006-11-01  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  35
  36         * SSL support: patch from Robin H. Johnson <robbat2@gentoo.org>
  37
  38 2006-10-28  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  39
  40         * A-Z game: try to guess the word the bot is thinking of: every miss
  41         helps by reducing the range of allowed words, until it's so small
  42         around the correct one that you can't miss it.
  43
  44 2006-10-27  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  45
  46         * Flood protection: first attempt at penalty-based flood protection.
  47         This should make rbot much less prone to Excess Floods *and* still
  48         serve normally without excessive delays.
  49
  50 2006-10-25  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  51
  52         * HttpUtil: Strings returned by get_cached now have a cached? method
  53         which returns true or false depending on whether the result was taken
  54         from the cache or not; this can be exploited by plugins that parse the
  55         result in some particular way, since they can now skip the parsing
  56         stage if they cache the parse result.
  57
  58 2006-10-24  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  59
  60         * HttpUtil: initial implementation of proper caching based on
  61         last-modified and etag HTTP headers
  62
  63 2006-10-17  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  64
  65         * Salut plugin: handles (multilingual) salutations (hello/goodbye)
  66
  67 2006-10-15  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  68
  69         * Language stuff: plugins can now handle language changes in a natural
  70         fashion. lart is the first plugin to make use of this. NOTE: this
  71         is not (yet) backwards compatible: the old larts/praises files from
  72         previous rbot setups have to be renamed manually
  73         * Language stuff: italian translations
  74         * Utils.safe_save(filename): allows 'safe' saving of a file: it needs a
  75         block, to which it will yield a temporary file on which operations can
  76         be carried out. When the block returns, the tempfile will be renamed to
  77         the given filename
  78
  79 2006-09-21  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  80
  81         * New Auth Framework: restore backwards compatibility: 'auth
  82         <masterpassword>' and 'login owner <masterpassword>' both work.
  83         * Topic plugin: cleanups. Implement 'topic undo'. 'topic undo' after a
  84         'topic undo' undoes the last undo.
  85
  86 2006-09-09  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  87
  88         * New Auth Framework: rbot was opping anyone who asked for it (opme
  89         plugin). Fixed, and cleaned up.
  90
  91 2006-09-01  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  92
  93         * New Auth Framework: document and fine tune permissions view the auth
  94         core botmodule.
  95         * Version: when run from a svn checkout, the bot now tries to report
  96         which svn revision it's at, and if there are local changes
  97
  98 2006-08-31  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
  99
 100         * Nickserv plugin: bot will now try to inform nickserv when password
 101         is changed. Moreover it's not necessary to specify the nick anymore if
 102         you want to change the password for the current bot nick. Also do some
 103         internal cleanups while we're at it.
 104
 105 2006-08-29  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 106
 107         * Script plugin: new (UNSAFE!) echo functions. Just like eval, but
 108         m.replies the result of the evaluation.
 109         * New Auth Framework: config keys now have their own permissions. So
 110         you can allow people to view or edit only some of the config values.
 111         auth.password defaults to false. Still needs some work.
 112
 113 2006-08-26  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 114
 115         * Plugin message mapper: new implementation. Multi-word parameters now
 116         need not be the last, and it is possible to retrieve the entire
 117         substring with preserved whitespace by using to_s. Also, parts of the
 118         map string can be bracketed to make them optional. Examples:
 119                 remind :user [about] *stuff
 120         will respond to
 121                 remind me about washing my teeth
 122         and also to
 123                 remind me washing my teeth
 124         It is possible to have parameters in brackets, in which case they will
 125         be optional too, and default to nil or [] (resp. single- and
 126         multi-word parameters) unless an alternative is provided in the
 127         :defaults hash for the message map options.
 128         * Script plugin: new (UNSAFE!) eval function. Not documented in help.
 129         Not permitted by default.
 130
 131 2006-08-25 Mark Kretschmann <markey@web.de>
 132
 133         * Added quiz plugin, a multiplayer trivia quiz game.
 134
 135 2006-08-20  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 136
 137         * Topic plugin: fix a bug that prevented it from loading
 138         correctly.
 139         * New IRC Framework: make sure that NOTICEs and PRIVMSGs do not
 140         raise an exception when the target is in one of the special forms
 141         #<mask> or $<mask>. Needs some work, though, since this case should be
 142         handled specifically.
 143
 144 2006-08-17  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 145
 146         * Fix help: It got broken while rearranging the plugin stuff, now it's
 147         properly fixed.
 148         * New Auth Framework: forgot to create the InvalidPassword exception.
 149         It's a RuntimeError now.
 150         * Fix help: this time for real (or so I hope).
 151         * New IRC Framework: topic plugin now works correctly.
 152         * New Auth Framework: nickserv plugin now defaults to false for its
 153         auth, so that only owner can do stuff with it
 154         * New Auth Framework: fix horrible typo, assignment instead of
 155         equality test when checking for the username during login.
 156         * Keywords plugin: tell and forget work again without 'keyword' before
 157         them.
 158
 159 2006-08-12  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 160
 161         * Subregistry: force prefix to be a String with to_s
 162
 163 2006-08-11  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 164
 165         * AutoOp plugin: adapted to the new IRC framework.
 166         * AutoOp plugin: trigger autoop on nick change too.
 167         * New Auth Framework: allow? method now informs a user when they don't
 168         have permission to do what they asked for.
 169         * New nickreply and nickokay methods: they act like the old reply
 170         method, but include the nick of the user the bot is replying to when
 171         talking in public. The usual reply method can be configured to act
 172         like this as default.
 173
 174 2006-08-10  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 175
 176         * Fix a bug in new IRC Framework: the list of channels a quitting user was
 177         on was not built correctly, causing an exception when the user was not
 178         in the first channel in the list of channels.
 179         * Fix a bug in new Auth Framework: BotUser's name is changed via
 180         username=, not name=.
 181         * New HalfLife 2 plugin from ocr: queries online servers for online
 182         status and number of users.
 183
 184 2006-08-07  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 185
 186         * Add kick method to kernel: plugins can now use
 187                 @bot.kick channel, user, reason
 188         to kick a user from a channel
 189         * RSS plugin: fix rewatch_rss method
 190         * RSS plugin: the different ways to represent channels before and
 191         after the New IRC Framework was causing strange problems such as
 192         watched feed not being listed as such, undeletable watches, double
 193         watches etc. Fix this by checking both for the Channel objects and
 194         their to_s form when checking for watches or deleting them.
 195
 196 2006-08-06  Giuseppe Bilotta <giuseppe.bilotta@gmail.com>
 197
 198         * Updating the ChangeLog again: describe the new stuff in trunk which
 199         will be made available in the next release. Use Gnu style for new
 200         changelog entries (yyyy-mm-dd name <email address>\n<tab> ...):
 201         there's a macro for this since at least Vim 6.x and higher, called by
 202         <Leader>o (default leader: slash (\))
 203         * New IRC Framework: Server, Channels, User, Netmasks etc are all
 204         proper Ruby objects. The better organization will allow multi-server
 205         connections to be implemented more easily
 206         * Modularize core: split the internal functionality from what can be
 207         implemented as botmodules (which work just the same as plugins). Move
 208         Configuration, Basics and Auth out of the 'kernel' into core
 209         botmodules.
 210         * New Auth Framework: BotUsers are now Ruby objects with attached
 211         PermissionSets which define what the BotUser can do, by channel if
 212         necessary. The new framework allows very fine-grained control while
 213         still being very easy to manage for elementary usage. BotUser data can
 214         be exported and imported, but no backwards compatibility has been
 215         implemented yet. Most plugins still have to be updated to the new
 216         command-path-based mechanism.
 217
 218 Sun Aug 06 17:33:55 BST 2006  Tom Gilbert <tom@linuxbrit.co.uk>
 219
 220   * 0.9.10 released
 221         * Changes: Lots of new and updated plugins, including one to poll RSS feeds.
 222         A first step towards a better auth system (total revamp due in 0.9.11).
 223         Improvements to network and server code which should provide greater
 224         stability. A new message queueing mechanism with bitrate throttling. A new
 225         logging framework for debugging and tracing the activities of the bot. A
 226         new split-db registry system for better performance and transactional
 227         usage of bdb for resilience. More integration with Nickserv where
 228         available including optional automatic ghost-killing.
 229
 230 Wed Sep 07 20:16:46 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 231
 232   * Fixed quit, broke it last commit
 233         * Fixed trap() for win32
 234
 235 Sun Aug 21 13:29:55 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 236
 237   * fix for bug in quakenet plugin (trac #14)
 238         * multiple fixes for unescaped bot nick in regexp's (trac #13)
 239
 240 Fri Aug 12 20:51:38 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 241
 242   * fix up autoop plugin a bit
 243
 244 Thu Aug 11 00:13:11 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 245
 246   * Added two plugins from Robin Kearney <robin@riviera.org.uk>
 247         * Threat (US threat level :P)
 248         * bash (bash.org quotes)
 249
 250 Thu Aug 11 00:04:31 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 251
 252   * Patches from "Alexey I. Froloff" <raorn@altlinux.ru>
 253         * Do not use "/home/#{Etc.getlogin}/" for default home directory, use
 254         "#{Etc.getpwnam(Etc.getlogin).dir}/" instead.
 255         * Do not try to load same plugin from different locations.  Added ability
 256         to disable system-wide plugins - create PLUGIN.rb.disabled in user's
 257         plugins directory.
 258         * For example, to disable freshmeat plugin installed in /usr/share/rbot/plugins/freshmeat.rb one can create empty file ~/.rbot/plugins/freshmeat.rb.disabled
 259
 260 Mon Aug 08 23:08:01 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 261
 262   * new markov plugin for random inane chat
 263
 264 Sun Aug 07 18:20:24 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 265
 266   * stop insult plugin being used to insult the bot
 267
 268 Sun Aug 07 17:53:06 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 269
 270   * workaround for people without YAML::load_file
 271         * quit message for restart
 272
 273 Sun Aug 07 15:11:07 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 274
 275   * fix address_prefix, broken in 0.9.9, reported by ruskie.
 276
 277 Sat Aug 06 00:54:34 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 278
 279   * Released 0.9.9
 280
 281 Fri Aug 05 23:55:20 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 282
 283   * few more tweaks preparing to release 0.9.9
 284
 285 Thu Aug 04 23:03:30 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 286
 287   * Improved ircd recognition of rfc2812.rb
 288         * de-string'd, de-cap'd rfc2812.rb, looks less shouty now
 289         * moved the Q auth stuff (for quakenet) into a new qauth plugin (untested!)
 290         * finish fixing the httputil
 291
 292 Thu Aug 04 00:11:52 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 293
 294   * Tweaked the debug() stuff a bit. Need to do this more cleanly really
 295         * Added a fair bit of documentation for some of the new features
 296
 297 Wed Aug 03 15:25:07 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 298
 299   * Added french language file (TODO most of the plugins just talk english)
 300         * The way the Enum configs were set up, it wasn't possible to add language
 301         files to rbot at runtime (the directory was only scanned at startup). Now
 302         you can set a values Proc, which is called to return a list of allowed
 303         values whenever it's queried.
 304         * Added Config module for determining where we were installed.
 305         Unfortunately rubygems is a total whore in this regard, and I hope the
 306         current hackery I have to do to support it becomes redundant in the
 307         future.
 308
 309 Wed Aug 03 00:31:41 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 310
 311   * Added Rakefile, tweaked gemspec
 312
 313 Tue Aug 02 16:27:36 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 314
 315   * Fixed the new http.proxy* settings, they work!
 316         * Fixed a bug with auth-checking for the config module
 317         * misc tweaks
 318
 319 Sun Jul 31 02:20:08 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 320
 321   * Updated docgen to generate rdoc again with the new repo structure
 322         * added new restart command to the core bot, quits irc and reexecs the
 323         bot, to pick up new code/libraries etc.
 324
 325 Sat Jul 30 22:33:36 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 326
 327   * Config items are now objects, various types are available.
 328         * The config wizard will now use registered config items if :wizard is set
 329     to true for those items. It will ask questions in the order they were
 330                 registered.
 331         * The config module now works for doing runtime configuration.
 332         * misc refactoring
 333
 334 Sat Jul 30 01:19:32 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 335
 336   * config module for configuring the running bot via IRC
 337         * BotConfig.register method for various modules and any plugin to register
 338         bot configuration which the new config module will expose for them.
 339         * various other tweaks as I continue to refactor..
 340
 341 Fri Jul 29 13:07:56 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 342
 343   * Moved some stuff out of util.rb into the plugins that actually need
 344         them. Those methods didn't belong in util as they were plugin-specific.
 345         * moved a few more plugins to use map() where appropriate
 346         * made the url plugin only store unique urls
 347
 348 Thu Jul 28 23:45:26 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 349
 350   * Reworked the Timer module. The Timer now has a smart thread manager to
 351         start/stop the tick() thread. This means the timer isn't called every 0.1
 352         seconds to see what needs doing, which is much more efficient
 353   * reworked the ircsocket queue mechanism to use a Timer
 354         * reworked the nickserv plugin to use maps
 355         * made server.reconnect_wait configurable
 356         * added Class tracing mechanism to bin/rbot, use --trace Classname for
 357         debugging
 358
 359 Tue Jul 26 14:41:34 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 360
 361   * Prevent multiple plugin registrations of the same name
 362         * reworking the config system to use yaml for persistence
 363         * reworking the config system key names
 364         * on first startup, the bot will prompt for the essential startup config
 365         * new config module for configuring the bot at runtime
 366         * new config module includes new configurables, for example changing the
 367         bot's language at runtime.
 368         * various other fixes
 369         * New way of mapping plugins to strings, using maps. These may be
 370         familiar to rails users. This is to reduce the amount of regexps plugins
 371         currently need to do to parse arguments. The old method (privmsg) is still
 372         supported, of course. Example plugin now:
 373           def MyPlugin < Plugin
 374                   def foo(m, params)
 375                           m.reply "bar"
 376                         end
 377
 378                         def complexfoo(m, params)
 379                           m.reply "qux! (#{params[:bar]} #{params[:baz]})"
 380                         end
 381                 end
 382                 plugin = MyPlugin.new
 383                 # simple map
 384                 plugin.map 'foo'
 385
 386     # this will match "rbot: foo somestring otherstring" and pass the
 387                 # parameters as a hash using the names in the map.
 388                 plugin.map 'foo :bar :baz', :action => 'complexfoo'
 389                 # this means :foo is an optional parameter
 390                 plugin.map 'foo :foo', :defaults => {:foo => 'bar'}
 391     # you can also gobble up into an array
 392                 plugin.map 'foo *bar' # params[:bar] will be an array of string elements
 393     # and you can validate, here the first param must be a number
 394                 plugin.map 'foo :bar', :requirements => {:foo => /^\d+$/}
 395
 396
 397 Sat Jul 23 01:39:08 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 398
 399   * Changed BotConfig to use yaml storage, method syntax instead of hash for
 400         get/set, to allow more flexibility and encapsulation
 401         * Added convenience method Message.okay (m.okay is the same as the
 402         old-style @bot.okay m.replyto)
 403
 404 Wed Jul 20 23:30:01 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 405
 406   * Move some core plugins to use the new httputil
 407         * fix wserver's redirection handling for relative (i.e. broken) redirects
 408         * fix tube plugin's html parsing
 409
 410 Wed Jul 20 01:18:06 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 411
 412         * Add new httputil object to the bot object, to be used by plugins etc
 413         that wish to make http requests. It sets up all the proxies etc for them
 414         according to bot config.
 415
 416 Sat Jul 16 02:23:13 BST 2005  Tom Gilbert <tom@linuxbrit.co.uk>
 417
 418   * Apply most of Rene's patch and fix various plugins.
 419         * New plugin: autoop (auto ops via hostmask)
 420         * New feature: karmastats
 421
 422 Wed Oct 13 16:16:31 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 423
 424   * Fix bug with quotes plugin where it gets confused and sees both a quote
 425   and a keyword, both plugins are triggered by, for example "addquote foo is
 426   bar"
 427   * fixed this by implementing the "has_responded" flag on a message. When a
 428   plugin replied to a message (or it manually sets m.replied to true), the
 429   keywords plugin will honour that flag and not examine the message for
 430   keywords. This flag can also be checked by listen plugins that don't want to
 431   interfere with other plugin commands.
 432
 433 Mon Oct 11 00:37:52 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 434
 435   * Fixes to the NickServ plugin
 436
 437 Sat Oct 09 23:23:24 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 438
 439   * Keyword searching
 440
 441 Fri Oct 08 00:40:07 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 442
 443   * fixed insult plugin
 444   * fixed excuse plugin
 445
 446 Thu Oct 07 23:28:05 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 447
 448   * searching for urls in the url plugin
 449   * roshambo (rock/paper/scissors) plugin from Hans Fugal <hans@fugal.net>
 450
 451 Sat Apr 17 20:56:50 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 452
 453   * Oh, found new tv plugin in my inbox from ages ago, but it's still not
 454   working so I guess it changed again since then
 455   * New eightball plugin from Daniel Free
 456
 457 Sat Apr 17 20:44:43 BST 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 458
 459   * Fixed the babelfish parser so translate works again.
 460   * Misc other fixes
 461   * Note some plugins are broken (excuse,insult) because the server they use
 462     went away. I don't know of a replacement right now.
 463   * tv plugin seems broken, perhaps the html changed.
 464
 465 Thu Jan 15 21:37:38 GMT 2004  Tom Gilbert <tom@linuxbrit.co.uk>
 466
 467   * Fixes for ruby 1.8
 468
 469 0.9.8
 470 * new plugin from Alan Third <alan@idiocy.org>, allows you to search and list
 471   UK TV programmes.
 472
 473 0.9.7
 474 * various plugin updates
 475 * fix (again) for C to F temp conversion in weather plugin
 476 * channel topic patch from Peter Suschlik, gives plugin better access to topic
 477   changes and related information
 478
 479 0.9.6
 480 * changes to layout of slashdot plugin output
 481 * freshmeat plugin, show latest updates or search
 482 * fix to C to F temp conversion in weather plugin
 483 * status command returns some bot status
 484 * fortune plugin
 485 * using BDB::Btree everywhere now, instead of BDB::Hash, because the Btree api
 486   allows me to set my own key comparison function. This is needed to keep
 487   supporting case insensitivity (vital for IRC), which was sadly broken in
 488   0.9.5 :( All existing dbs will be upgraded automatically.
 489 * roulette plugin - play russian roulette :) also keeps game stats.
 490 * new config option, NO_KEYWORD_ADDRESS. If set to "true", the bot will always
 491   respond to keywords it knows even when not addressed and the message doesn't
 492   start with '. Message must end with "?" however.
 493 * hopefully fixed welcome message parsing from certain server types
 494
 495 0.9.5
 496 * plugin object registry
 497   This provides persistant storage for plugins via a hash interface. The
 498   default mode is an object store, so you can store ruby objects and reference
 499   them with hash keys. This is because the default store/restore methods of
 500   the plugins' RegistryAccessor are calls to Marshal.dump and Marshal.restore,
 501   for example:
 502     blah = Hash.new
 503     blah[:foo] = "fum"
 504     @registry[:blah] = blah
 505   then, even after the bot is shut down and disconnected, on the next run you
 506   can access the blah object as it was, with:
 507     blah = @registry[:blah]
 508   The registry can of course be used to store simple strings, fixnums, etc as
 509   well, and should be useful to store or cache plugin data or dynamic plugin
 510   configuration.
 511
 512   If you don't need to store objects, and strictly want a persistant hash of
 513   strings, you can override the store/restore methods to suit your needs, for
 514   example (in your plugin):
 515     def initialize
 516       class << @registry
 517         def store(val)
 518           val
 519         end
 520         def restore(val)
 521           val
 522         end
 523       end
 524     end
 525   Your plugins section of the registry is private, it has its own namespace
 526   (derived from the plugin's class name, so change it and lose your data).
 527   Calls to registry.each etc, will only iterate over your namespace.
 528
 529   The nickserv and karma plugins use the new registry and should serve as a
 530   useful example. Basic usage of the registry is simple, just treat it as a
 531   hash, with values that never die (unless you delete() them).
 532 * Change to the nickserv plugin. The old method of putting the nickserv
 533   password in rbot.conf was useless for multiple nicks or easy updates. The
 534   plugin now uses the plugin registry to store passwords for any nicks it
 535   owns. The plugin can be told to register the current nick (supply a password
 536   or it'll generate one), identify for the current nick (if the password is
 537   known), and can be told the passwords for other nicks. If NickServ asks the
 538   bot to identify, it will automatically do so if it knows the appropriate
 539   password.
 540 * karma plugin now uses the plugin registry, it should automatically import
 541   your existing, stored karma data into the registry.
 542 * The babelfish plugin now caches results in the bot registry to speed up
 543   common lookups.
 544 * New message types and plugin methods to grab them,
 545   quit(QuitMessage):   Called when a user (or the bot) quits IRC
 546   nick(NickMessage):   Called when a user (or the bot) changes Nick
 547   topic(TopicMessage): Called when a user (or the bot) changes a channel topic
 548 * A plugin's listen() method will now receive any kind of Message, e.g.
 549   PrivMessage, NoticeMessage, NickMessage, JoinMessage, etc
 550 * New plugins:
 551   seen: the usual "seen" stuff:
 552         rbot: seen giblet?
 553         giblet was last seen xxx ago doing xxx
 554   cal:  calls the unix cal program to display a calendar
 555   math: evaluates mathematical expressions:
 556         rbot: math 2+2
 557         rbot: math 4 to the power of 8
 558         rbot: math ((232+432) - 4) / 2
 559         (ported from infobot. Thanks to Kevin Lenzo, who wrote the
 560         original infobot math module)
 561   slashdot: displays latest headlines or searches for articles
 562   url:  stores urls mentioned in channels for regurgitation later
 563   weather: grabs and parses METAR weather data, will remember the last weather
 564            code you asked for so you don't have to :)
 565 * New utility function, Util.http_get(url) for getting remote data via http,
 566   just dumps response.body into a string and returns it, or nil if anything at
 567   all goes wrong. Useful for simple plugins.
 568 * random quit messages if none specified, messages set in language description
 569   file
 570 * keywords are now stored in bdb databases - your old keywords.rbot will be
 571   imported. Static keywords (fact packs) are also stored in bdb databases, and
 572   rbot will automatically convert any text .fact file dropped in the confdir's
 573   keywords subdirectory, at startup, into a bdb file. If both a db and a text
 574   file exist of the same name (except the extension), the text file will be
 575   imported and merged into the database.
 576   static keywords will be looked up in each factpack db in turn, in
 577   alphabetical filename order - so you can prioritise using the filename if
 578   you wish.
 579 * fixed a bug with autsplitting long sent lines, the last line was often being
 580   split unnecessarily.
 581
 582 0.9.4
 583 * Massive cleanup of rfc2812.rb, contributed by Lars Christensen
 584   <dsl8950@vip.cybercity.dk>, gets rid of a lot of regexps
 585 * Fixed bug reading static keyword files - "foo <=is=> bar" may not have
 586   worked for a couple of releases, only "foo<=is=>bar" was working - this was
 587   not intended and should be fixed now
 588 * Experimental send queue, to prevent the bot from flooding out, the delay
 589   between sending messages to the server defaults to 2s, but is configurable
 590   in conf.rbot, set SENDQ_DELAY (0 to disable queueing). You can also set/get
 591   the value from the bot, "rbot: options get sendq_delay", and
 592   "rbot: options set sendq_delay 1.5", if you have sufficient auth for "config"
 593   This is a bursting sendq, most ircd's allow bursts of up to 5
 594   lines, with non-burst limits of 512 bytes/2 seconds. To set the burst limit,
 595   configure SENDQ_BURST in conf.rbot, or do the same kind of stuff with
 596   "rbot: options set sendq_burst 2", etc.
 597   The defaults are 2s/4 burst, which seem to work okay for me.
 598 * support for multiple, customisable, addressing prefixes. Set ADDRESS_PREFIX
 599   in conf.rbot to a space separate list of addressing prefixes, e.g
 600   ADDRESS_PREFIX = | ! =>
 601   Would mean that all of the following in channel messages would cause the bot
 602   to respond:
 603               rbot: version
 604               |version
 605               !version
 606               =>version
 607 * bb plugin removed, bb is nearly over and it doesn't work 100% anyway
 608 * Two plugins from brailsmt (from #ruby-lang on openprojects), a stats plugin
 609   which monitors usage of 1-word sentences, and lart, which allows you to ask
 610   rbot to lart people - with an optional reason - larts are user-definable and
 611   can be added on the fly.
 612 * made google.rb work for people with 1.6 ruby's net/http
 613
 614 0.9.3
 615
 616 * fix quit messages
 617 * new plugin for handling nickserv-protected nicks, use NICKSERV_PASSWORD in
 618   the config file.
 619 * fixes to a few other buglets
 620 * new plugin to grab bigbrother headlines, still buggy and only useful for UK
 621   folks who love bb :-)
 622 * fixes to various plugins
 623 * Patch from akira yamada <akira@ruby-lang.org>
 624   DNS plugin: Use resolv-replace if found, do lookup in new thread
 625   Fix bug joining channels with keys
 626
 627 0.9.2
 628
 629 * better "connect failure" error message
 630 * better option parsing, and --debug option
 631 * access to bot's online help via commandline, eg:
 632   ./rbot.rb --help
 633   ./rbot.rb --help core
 634   ./rbot.rb --help "core save"
 635 * Fix broken help from last point release
 636 * Plugin API modification and cleanup. You no longer need to set @listen to
 637   true in order to get all NOTICE and PRIVMSGs, you just need to define the
 638   method. The method is now called listen(), renamed from listener(). This
 639   should be the last time the plugin api is changed incompatibly.
 640 * New plugin method kick(). Use it to see kicks (duh :))
 641 * New plugin methods join(), part(). Obvious uses.
 642 * Example plugin autorejoin.rb, uses kick event to rejoin channel and insult
 643   kicker
 644 * fix bug in remind plugins "remind me no more" recognition.
 645
 646 0.9.1
 647
 648 * Fix welcome message recognition for certain IRCd's.
 649
 650 0.9
 651
 652 * Allow keyword definitions which end in '?', like this:
 653   bot: foo is bar\?
 654 * rdoc documentation!
 655 * fixed broken address regexp, "rbot: .foo" was being treated as an addressed
 656   form of "foo" (lost the .)
 657 * fix stupid bug in last release (looking for wrong default conf dir)
 658
 659 0.8
 660
 661 * Tarball layout change. modules all in rbot/ now, and the rbot/ default
 662   configuration moved to rbotconf/. This lets the thing run from an unpacked
 663   tarball while also being ready to run with the modules installed somewhere
 664   else.
 665 * change hashbang to /usr/bin/env ruby, in order to use PATH looking for ruby,
 666   it's BSD friendly!
 667 * allow "botnick : foo" style addressing, and even "botnick... foo"
 668 * slap plugin (contributed by oct)
 669 * renamed bot.send to bot.sendmsg, I didn't really want to override send() ;D
 670   (thanks Kero)
 671
 672 0.7.1
 673 * Made sane for packagers. Looks in the right places for plugins and language
 674   files now, so extra effort shouldn't be needed there.
 675
 676 0.7
 677
 678 * Fixed "nick taken on join" bug
 679 * Dice plugin patch from David Dorward
 680 * fix searchquote regexp
 681 * conf.rbot: PASSWORD -> SERVER_PASSWORD, to prevent confusion with PASSWD,
 682   which is for master auth.
 683
 684 0.6
 685
 686 * Fixed addquote (was incrementing quote ID twice)
 687 * now strips colour/bold escapes from incoming messages (rbot was ignoring
 688   messages addressed using a bolded colon, for example).
 689 * minor bugfixes
 690 * more language breadth
 691 * Addressing works better now
 692 * Can autojoin channels with keys, conf.rbot line is:
 693   autojoin_channels #chan1, #chan2, #chan3 key, #chan4 key, #chan5
 694 * dice plugin fixes
 695
 696 0.5
 697
 698 * Initial release