module Plugins
require 'rbot/messagemapper'
- # base class for all rbot plugins
- # certain methods will be called if they are provided, if you define one of
- # the following methods, it will be called as appropriate:
- #
- # map(template, options)::
- # map!(template, options)::
- # map is the new, cleaner way to respond to specific message formats
- # without littering your plugin code with regexps. The difference
- # between map and map! is that map! will not register the new command
- # as an alternative name for the plugin.
- #
- # Examples:
- #
- # plugin.map 'karmastats', :action => 'karma_stats'
- #
- # # while in the plugin...
- # def karma_stats(m, params)
- # m.reply "..."
- # end
- #
- # # the default action is the first component
- # plugin.map 'karma'
- #
- # # attributes can be pulled out of the match string
- # plugin.map 'karma for :key'
- # plugin.map 'karma :key'
- #
- # # while in the plugin...
- # def karma(m, params)
- # item = params[:key]
- # m.reply 'karma for #{item}'
- # end
- #
- # # you can setup defaults, to make parameters optional
- # plugin.map 'karma :key', :defaults => {:key => 'defaultvalue'}
- #
- # # the default auth check is also against the first component
- # # but that can be changed
- # plugin.map 'karmastats', :auth => 'karma'
- #
- # # maps can be restricted to public or private message:
- # plugin.map 'karmastats', :private false,
- # plugin.map 'karmastats', :public false,
- # end
- #
- # listen(UserMessage)::
- # Called for all messages of any type. To
- # differentiate them, use message.kind_of? It'll be
- # either a PrivMessage, NoticeMessage, KickMessage,
- # QuitMessage, PartMessage, JoinMessage, NickMessage,
- # etc.
- #
- # privmsg(PrivMessage)::
- # called for a PRIVMSG if the first word matches one
- # the plugin register()d for. Use m.plugin to get
- # that word and m.params for the rest of the message,
- # if applicable.
- #
- # kick(KickMessage)::
- # Called when a user (or the bot) is kicked from a
- # channel the bot is in.
- #
- # join(JoinMessage)::
- # Called when a user (or the bot) joins a channel
- #
- # part(PartMessage)::
- # Called when a user (or the bot) parts a channel
- #
- # quit(QuitMessage)::
- # Called when a user (or the bot) quits IRC
- #
- # nick(NickMessage)::
- # Called when a user (or the bot) changes Nick
- # topic(TopicMessage)::
- # Called when a user (or the bot) changes a channel
- # topic
- #
- # connect():: Called when a server is joined successfully, but
- # before autojoin channels are joined (no params)
- #
- # save:: Called when you are required to save your plugin's
- # state, if you maintain data between sessions
- #
- # cleanup:: called before your plugin is "unloaded", prior to a
- # plugin reload or bot quit - close any open
- # files/connections or flush caches here
+=begin
+ base class for all rbot plugins
+ certain methods will be called if they are provided, if you define one of
+ the following methods, it will be called as appropriate:
+
+ map(template, options)::
+ map!(template, options)::
+ map is the new, cleaner way to respond to specific message formats
+ without littering your plugin code with regexps. The difference
+ between map and map! is that map! will not register the new command
+ as an alternative name for the plugin.
+
+ Examples:
+
+ plugin.map 'karmastats', :action => 'karma_stats'
+
+ # while in the plugin...
+ def karma_stats(m, params)
+ m.reply "..."
+ end
+
+ # the default action is the first component
+ plugin.map 'karma'
+
+ # attributes can be pulled out of the match string
+ plugin.map 'karma for :key'
+ plugin.map 'karma :key'
+
+ # while in the plugin...
+ def karma(m, params)
+ item = params[:key]
+ m.reply 'karma for #{item}'
+ end
+
+ # you can setup defaults, to make parameters optional
+ plugin.map 'karma :key', :defaults => {:key => 'defaultvalue'}
+
+ # the default auth check is also against the first component
+ # but that can be changed
+ plugin.map 'karmastats', :auth => 'karma'
+
+ # maps can be restricted to public or private message:
+ plugin.map 'karmastats', :private false,
+ plugin.map 'karmastats', :public false,
+ end
+
+ listen(UserMessage)::
+ Called for all messages of any type. To
+ differentiate them, use message.kind_of? It'll be
+ either a PrivMessage, NoticeMessage, KickMessage,
+ QuitMessage, PartMessage, JoinMessage, NickMessage,
+ etc.
+
+ privmsg(PrivMessage)::
+ called for a PRIVMSG if the first word matches one
+ the plugin register()d for. Use m.plugin to get
+ that word and m.params for the rest of the message,
+ if applicable.
+
+ kick(KickMessage)::
+ Called when a user (or the bot) is kicked from a
+ channel the bot is in.
+
+ join(JoinMessage)::
+ Called when a user (or the bot) joins a channel
+
+ part(PartMessage)::
+ Called when a user (or the bot) parts a channel
+
+ quit(QuitMessage)::
+ Called when a user (or the bot) quits IRC
+
+ nick(NickMessage)::
+ Called when a user (or the bot) changes Nick
+ topic(TopicMessage)::
+ Called when a user (or the bot) changes a channel
+ topic
+
+ connect():: Called when a server is joined successfully, but
+ before autojoin channels are joined (no params)
+
+ save:: Called when you are required to save your plugin's
+ state, if you maintain data between sessions
+
+ cleanup:: called before your plugin is "unloaded", prior to a
+ plugin reload or bot quit - close any open
+ files/connections or flush caches here
+=end
+
class Plugin
attr_reader :bot # the associated bot
# initialise your plugin. Always call super if you override this method,
@registry.close
end
+ def handle(m)
+ @handler.handle(m)
+ end
+
def map(*args)
@handler.map(*args)
# register this map
self.register name
unless self.respond_to?('privmsg')
def self.privmsg(m)
- @handler.handle(m)
+ handle(m)
end
end
end
self.register name, {:hidden => true}
unless self.respond_to?('privmsg')
def self.privmsg(m)
- @handler.handle(m)
+ handle(m)
end
end
end
# return a help string for your module. for complex modules, you may wish
# to break your help into topics, and return a list of available topics if
# +topic+ is nil. +plugin+ is passed containing the matching prefix for
- # this message - if your plugin handles multiple prefixes, make sure your
+ # this message - if your plugin handles multiple prefixes, make sure you
# return the correct help for the prefix requested
def help(plugin, topic)
"no help"
# load plugins from pre-assigned list of directories
def scan
- @blacklist = Array.new
+ @failed = Array.new
+ @ignored = Array.new
+ processed = Hash.new
+
@@bot.config['plugins.blacklist'].each { |p|
- @blacklist << p+".rb"
+ pn = p + ".rb"
+ processed[pn.intern] = :blacklisted
}
- @failed = Array.new
- processed = @blacklist.dup
+
dirs = Array.new
dirs << Config::datadir + "/plugins"
dirs += @dirs
if(FileTest.directory?(dir))
d = Dir.new(dir)
d.sort.each {|file|
+
next if(file =~ /^\./)
- next if(processed.include?(file))
+
+ if processed.has_key?(file.intern)
+ @ignored << {:name => file, :dir => dir, :reason => processed[file.intern]}
+ next
+ end
+
if(file =~ /^(.+\.rb)\.disabled$/)
- processed << $1
+ # GB: Do we want to do this? This means that a disabled plugin in a directory
+ # will disable in all subsequent directories. This was probably meant
+ # to be used before plugins.blacklist was implemented, so I think
+ # we don't need this anymore
+ processed[$1.intern] = :disabled
+ @ignored << {:name => $1, :dir => dir, :reason => processed[$1.intern]}
next
end
+
next unless(file =~ /\.rb$/)
+
tmpfilename = "#{dir}/#{file}"
# create a new, anonymous module to "house" the plugin
begin
plugin_string = IO.readlines(tmpfilename).join("")
debug "loading plugin #{tmpfilename}"
- plugin_module.module_eval(plugin_string)
- processed << file
+ plugin_module.module_eval(plugin_string, tmpfilename)
+ processed[file.intern] = :loaded
rescue Exception => err
# rescue TimeoutError, StandardError, NameError, LoadError, SyntaxError => err
warning "plugin #{tmpfilename} load failed\n" + err.inspect
newerr.set_backtrace(bt)
# debug "Simplified error: " << newerr.inspect
# debug newerr.backtrace.join("\n")
- @failed << { :name => tmpfilename, :err => newerr }
+ @failed << { :name => file, :dir => dir, :reason => newerr }
# debug "Failures: #{@failed.inspect}"
end
}
# return list of help topics (plugin names)
def helptopics
+ # Active plugins first
if(@@plugins.length > 0)
list = " [#{length} plugin#{'s' if length > 1}: " + @@plugins.values.uniq.collect{|p| p.name}.sort.join(", ")
else
list = " [no plugins active"
end
- list << "; #{Reverse}#{@failed.length} plugin#{'s' if @failed.length > 1} failed to load#{Reverse}: use #{Bold}help pluginfailures#{Bold} to see why" unless @failed.empty?
+ # Ignored plugins next
+ list << "; #{Underline}#{@ignored.length} plugin#{'s' if @ignored.length > 1} ignored#{Underline}: use #{Bold}help ignored plugins#{Bold} to see why" unless @ignored.empty?
+ # Failed plugins next
+ list << "; #{Reverse}#{@failed.length} plugin#{'s' if @failed.length > 1} failed to load#{Reverse}: use #{Bold}help failed plugins#{Bold} to see why" unless @failed.empty?
list << "]"
return list
end
# return help for +topic+ (call associated plugin's help method)
def help(topic="")
- if topic =~ /plugin\s*fail(?:ure)?s?\s*(trace(?:back)?s?)?/
+ case topic
+ when /fail(?:ed)?\s*plugins?.*(trace(?:back)?s?)?/
# debug "Failures: #{@failed.inspect}"
return "no plugins failed to load" if @failed.empty?
return (@failed.inject(Array.new) { |list, p|
- list << "#{Bold}#{p[:name]}#{Bold} failed with #{p[:err].class}: #{p[:err]}"
- list << "#{Bold}#{p[:name]}#{Bold} failed at #{p[:err].backtrace.join(', ')}" if $1 and not p[:err].backtrace.empty?
+ list << "#{Bold}#{p[:name]}#{Bold} in #{p[:dir]} failed"
+ list << "with error #{p[:reason].class}: #{p[:reason]}"
+ list << "at #{p[:reason].backtrace.join(', ')}" if $1 and not p[:reason].backtrace.empty?
list
}).join("\n")
- end
- if(topic =~ /^(\S+)\s*(.*)$/)
+ when /ignored?\s*plugins?/
+ return "no plugins were ignored" if @ignored.empty?
+ return (@ignored.inject(Array.new) { |list, p|
+ case p[:reason]
+ when :loaded
+ list << "#{p[:name]} in #{p[:dir]} (overruled by previous)"
+ else
+ list << "#{p[:name]} in #{p[:dir]} (#{p[:reason].to_s})"
+ end
+ list
+ }).join(", ")
+ when /^(\S+)\s*(.*)$/
key = $1
params = $2
if(@@plugins.has_key?(key))
begin
return @@plugins[key].help(key, params)
rescue Exception => err
- #rescue TimeoutError, StandardError, NameError, SyntaxError => err
+ #rescue TimeoutError, StandardError, NameError, SyntaxError => err
error "plugin #{@@plugins[key].name} help() failed: #{err.class}: #{err}"
error err.backtrace.join("\n")
end