PerfectlyNormal-Flexo 0.3.9

data/lib/flexo/events/reply.rb

@@ -0,0 +1,45 @@
+require 'ostruct'
+
+module Flexo
+  module Events
+    # A numeric reply of some kind.
+    class ReplyEvent < Event
+      attr_reader :mynickname
+      attr_reader :numeric
+      attr_reader :text
+      attr_reader :reply
+
+      alias mynick mynickname
+      alias struct reply
+
+      def initialize(*args)
+        super
+        @mynickname = @data.params[0]
+        @numeric    = @data.message.to_i
+        @text       = @data.string
+        @is_error   = @numeric >= 400
+        @reply      = Struct.new
+      end
+
+      def self.[](reply)
+        n = (reply =~ /^\d+$/ || reply.kind_of?(Integer)) ? reply.to_i : Numerics.const_get(reply)
+        Numeric.new(n)
+      end
+    end
+
+    # This open structure is used to construct detailed objects about a specific
+    # reply, thus contains information specific to the received response.
+    class ReplyEvent::Struct < OpenStruct
+    end
+
+    # Returned by ReplyEvent.[] and used by Dispatcher to be able to subscribe to
+    # specific reply events.
+    class ReplyEvent::Numeric
+      attr_reader :numeric # :nodoc:
+
+      def initialize(numeric) # :nodoc:
+        @numeric = numeric
+      end
+    end
+  end
+end

data/lib/flexo/events/topic.rb

@@ -0,0 +1,18 @@
+module Flexo
+  module Events
+    class TopicEvent < Event
+      attr_reader :channel
+      attr_reader :topic
+
+      def initialize(*args)
+        super
+        @channel = @data.params[0]
+        @topic   = @data.string
+      end
+
+      def cleared?
+        @topic.empty?
+      end
+    end
+  end
+end

data/lib/flexo/events/unknown.rb

@@ -0,0 +1,11 @@
+module Flexo
+  module Events
+    # Events not implemented.
+    # Most likely because of lazyness.
+    # Maybe it's a bug in Flexo.
+    # Or it could be a special IRC server.
+    class UnknownEvent < Event
+      # dunno what to do with an unknown event!
+    end
+  end
+end

data/lib/flexo/handler.rb

@@ -0,0 +1,30 @@
+module Flexo
+  # As seen in Flexo::Dispatcher.
+  # This is the class that's spawned to handle
+  # a subscription to an event.
+  #
+  # Each call to Flexo::Dispatcher.subscribe
+  # creates an instance of Flexo::Handler, which
+  # is called when the event fires.
+  #
+  # Also, to unsubscribe, the original handle-object
+  # is required. So don't throw it away.
+  class Handler
+    # This just stores some instance variables
+    def initialize(numeric, &block)
+      @manager = Flexo::Manager.instance
+      @numeric = numeric
+      @block   = block
+    end
+
+    # While this function does the actuall
+    # calling of the block. So when this function,
+    # aptly named 'call', is called, the block passed
+    # as block when creating this instance, is executed.
+    def call(event)
+      if !@numeric || event.class == ReplyEvent && @numeric == event.numeric
+        @manager.thread { @block.call(event) }
+      end
+    end
+  end
+end

data/lib/flexo/logger.rb

@@ -0,0 +1,86 @@
+require 'thread'
+
+module Flexo
+  # Having a little log of what's going on might not
+  # be such a bad idea. This provides methods
+  # for outputting information to a logfile
+  class Logger
+    attr_reader   :logfile
+    attr_accessor :loglevel
+
+    # Open a logfile for writing.
+    # We want to open the logger first, so
+    # instead of reading values from the config when 
+    # initializing, we set them to defaults, and then,
+    # after the config has been loaded, override them.
+    def initialize
+      @logfile  = File.expand_path('~/flexo.log')
+      @loglevel = 3
+      @handle   = STDERR
+    end
+
+    # If we change the logfile, we should also reopen the handle
+    def logfile=(file)
+      file = File.expand_path(file)
+      if File.writable?(file)
+        @handle = File.open(file, 'a+')
+        info "Switched logfile to #{file}"
+      else
+        # Little fallback to make sure we have somewhere to log
+        @handle = STDERR
+      end
+    end
+
+    # Quick and dirty hack to find the textual representation
+    # of a log level based on the numeric value
+    def const_to_text(i)
+      hit = ""
+
+      Flexo::Constants.constants.each do |const|
+        if Flexo::Constants.const_get(const) == i
+          hit = const
+        end
+      end
+
+      return hit.split('_')[-1]
+    end
+
+    # Writes a line into the log
+    def log(level, line)
+      i     = level
+      level = const_to_text(level)
+
+      if(i <= @loglevel)
+        Thread.new do 
+          @handle.print "#{level.to_s.upcase} #{Time.now} #{line}\n"
+          @handle.flush
+        end
+      end
+    end
+
+    # Convenience function for debug-messages
+    def debug(line)
+      log(Flexo::Constants::LOG_DEBUG, line)
+    end
+    
+    # Convenience for more-verbose-than-debug-messages
+    def debug2(line)
+      log(Flexo::Constants::LOG_DEBUG2, line)
+    end
+
+    # Convenience for information
+    def info(line)
+      log(Flexo::Constants::LOG_INFO, line)
+    end
+
+    # Convenience for warnings
+    def warn(line)
+      log(Flexo::Constants::LOG_WARN, line)
+    end
+
+    # Convenience for errors
+    def error(line)
+      log(Flexo::Constants::LOG_ERROR, line)
+    end
+  end
+end

data/lib/flexo/manager.rb

@@ -0,0 +1,152 @@
+require 'thread'
+require 'singleton'
+require 'flexo/errors'
+require 'flexo/config'
+require 'flexo/constants'
+require 'flexo/data'
+require 'flexo/dispatcher'
+require 'flexo/event'
+require 'flexo/handler'
+require 'flexo/logger'
+require 'flexo/numerics'
+require 'flexo/pluginmanager'
+require 'flexo/plugin'
+require 'flexo/sender'
+require 'flexo/server'
+require 'flexo/trigger'
+
+module Flexo
+  # One class to rule them all.
+  # And in the darkness bind them.
+  #
+  # This singleton-class creates an
+  # instance of each other class that's needed
+  # and manages threads, mutexes and other things
+  # that need sharing between classes. Each
+  # class can just save a reference to Flexo::Manager
+  # and get access to everything they need.
+  class Manager
+    include Singleton
+
+    def initialize
+    end
+
+    # Create everything
+    def setup
+      return if @setup == true
+      @setup         = true
+      
+      @config        = Flexo::Config.new
+      raise InvalidConfigurationException unless @config.valid?
+
+      @nickname      = nil
+      @threadqueue   = Queue.new
+      @threadgroup   = ThreadGroup.new
+      @threadmax     = 100
+      @mutex         = Mutex.new
+      @pluginmutex   = Mutex.new
+
+      @logger        = Flexo::Logger.new
+      @logger.loglevel = @config['log.level']
+      @logger.logfile  = @config['log.file']
+
+      @logger.debug "Creating Dispatcher"
+      @dispatcher    = Flexo::Dispatcher.new
+
+      @logger.debug "Creating PluginManager"
+      @pluginmanager = Flexo::PluginManager.new(@pluginmutex)
+      @pluginmanager.load_plugin('control')
+      @pluginmanager.load_plugin('auth')
+
+      @logger.debug "Creating Sender"
+      @sender        = Flexo::Sender.new
+
+      @logger.debug "Creating Server"
+      @server        = Flexo::Server.new
+      @server.setup
+
+      @logger.debug "Created all Flexo-classes. Going to create threads"
+      manager = Thread.new do
+        loop do
+          if @threadqueue.size < @threadmax
+            @threadgroup.add(@threadqueue.shift.wakeup)
+          else
+            sleep 0.1
+          end
+        end
+        @threadgroup.add manager
+      end
+
+      @logger.info "Setting up default handlers"
+      dispatcher.subscribe(:PING) { |ping| ping.pong }
+      dispatcher.subscribe(Flexo::Events::PrivmsgEvent) { |msg|
+        return unless msg.ctcp?
+
+        case msg.text.split(' ')[0].upcase
+        when 'VERSION'
+          l  = "\001VERSION Flexo #{Flexo::Constants::FLEXO_VERSION} "
+          l += "(#{Flexo::Constants::FLEXO_RELEASE})\001"
+          @sender.notice(msg.data.hostmask.nickname, l)
+        when 'PING'
+          arg = msg.text.split(' ')[1]
+          cmd = "\001PING #{arg}\001"
+          @sender.notice(msg.data.hostmask.nickname, cmd)
+        when 'QUIT'
+          if msg.text.split(' ')[1] == 'lololz'
+            @server.disconnect
+            exit
+          end
+        end
+      }
+
+      @logger.debug "Sleeping a while to allow logging into the server"
+      sleep 15
+
+      @logger.info "Joining channels"
+      @config['core.channels'].each do |channel|
+        @sender.join(channel[:channel], channel[:key])
+      end
+
+      @logger.debug "Joining server-thread"
+      @server.thread.join
+    end
+
+    # Spawns a thread to handle the block
+    def thread(&block)
+      thread = Thread.new { sleep; block.call }
+      @threadqueue << thread
+      return thread
+    end
+
+    def mutex
+      @mutex.synchronize { yield }
+    end
+
+    def pluginmutex
+      @pluginmutex.synchronize { yield }
+    end
+
+    def dispatcher
+      return @dispatcher
+    end
+
+    def logger
+      return @logger
+    end
+
+    def config
+      return @config
+    end
+
+    def sender
+      return @sender
+    end
+
+    def server
+      return @server
+    end
+
+    def nickname; return @nickname; end
+    def nickname=(nick); @nickname = nick; nick; end
+  end
+end

data/lib/flexo/numerics.rb

@@ -0,0 +1,207 @@
+module Flexo
+  # This module contains a long list of constants.
+  # It maps numeric IRC codes to their text equivalents
+  #
+  # (Everything is stolen from http://tools.ietf.org/html/rfc2812#section-5)  
+  module Numerics
+    RPL_WELCOME           = 001 # "Welcome to the Internet Relay Network 
+                                # <nick>!<user>@<host>"
+    RPL_YOURHOST          = 002 # "Your host is <servername>, running version <ver>"
+    RPL_CREATED           = 003 # "This server was created <date>"
+    RPL_MYINFO            = 004 # "<servername> <version> <available user modes>
+                                # <available channel modes>"
+    RPL_BOUNCE            = 005 # "Try server <server>, port <port>"
+                                # Sent to suggest an alternative server
+                                # Often when the current server is full
+
+    RPL_TRACELINK         = 200 # "Link <version & debug level> <destination>
+                                # <next server> V<protocol version>
+                                # <link uptime in seconds> <backstream sendq>
+                                # <upstream sendq>"
+    RPL_TRACECONNECTING   = 201 # "Try. <class> <server>"
+    RPL_TRACEHANDSHAKE    = 202 # "H.S. <class> <server>"
+    RPL_TRACEUNKNOWN      = 203 # "???? <class> [<client IP address in dot form>]"
+    RPL_TRACEOPERATOR     = 204 # "Oper <class> <nick>"
+    RPL_TRACEUSER         = 205 # "User <class> <nick>"
+    RPL_TRACESERVER       = 206 # "Serv <class> <int>S <int>C <server>
+                                # <nick!user|*!*>@<host|server> V<protocol version>"
+    RPL_TRACESERVICE      = 207 # "Service <class> <name> <type> <active type>"
+    RPL_TRACENEWTYPE      = 208 # "<newtype> 0 <client name>"
+    RPL_TRACECLASS        = 209 # "Class <class> <count>"
+    RPL_TRACERECONNECT    = 210 # Unused.
+    RPL_TRACELOG          = 261 # "File <logfile> <debuglevel>"
+    RPL_TRACEEND          = 262 # "<server name> <version & debug level> :End of TRACE"
+
+    RPL_STATSLINKINFO     = 211 # "<linkname> <sendq> <sent messages>
+                                # <sent Kbytes> <received messages>
+                                # <received Kbytes> <time open>"
+    RPL_STATSCOMMANDS     = 212 # "<command> <count> <byte count> <remote count>"
+    RPL_ENDOFSTATS        = 219 # "<stats letter> :End of STATS report"
+    RPL_STATSUPTIME       = 242 # ":server up %d days %d:%02d:%02d"
+    RPL_STATSOLINE        = 243 # "O <hostmask> * <name>"
+    RPL_UMODEIS           = 221 # "<user mode string>"
+    RPL_SERVLIST          = 234 # "<name> <server> <mask> <type> <hopcount> <info>"
+    RPL_SERVLISTEND       = 235 # "<mask> <type> :End of service listing"
+    RPL_LUSERCLIENT       = 251 # ":There are <integer> users and <integer>
+                                # services on <integer> servers"
+    RPL_LUSEROP           = 252 # "<integer> :operator(s) online"
+    RPL_LUSERUNKNOWN      = 253 # "<integer> :unknown connection(s)"
+    RPL_LUSERCHANNELS     = 254 # "<integer> :channels formed"
+    RPL_LUSERME           = 255 # ":I have <integer> clients and <integer> servers"
+    RPL_ADMINME           = 256 # "<server> :Administrative info"
+    RPL_ADMINLOC1         = 257 # ":<admin info>"
+    RPL_ADMINLOC2         = 258 # ":<admin info>"
+    RPL_ADMINEMAIL        = 259 # ":<admin info>"
+    RPL_TRYAGAIN          = 263 # "<command> :Please wait a while and try again."
+
+    RPL_USERHOST          = 302 # ":*1<reply> *( " " <reply> )"
+    RPL_ISON              = 303 # ":*1<nick>  *( " " <nick>  )"
+    RPL_AWAY              = 301 # "<nick> :<away message>"
+    RPL_UNAWAY            = 305 # ":You are no longer marked as being away"
+    RPL_NOWAWAY           = 306 # ":You have been marked as being away"
+    RPL_WHOISUSER         = 311 # "<nick> <user> <host> * :<real name>"
+    RPL_WHOISSERVER       = 312 # "<nick> <server> :<server info>"
+    RPL_WHOISOPERATOR     = 313 # "<nick> :is an IRC operator"
+    RPL_WHOISIDLE         = 317 # "<nick> <integer> :seconds idle"
+    RPL_ENDWHOIS          = 318 # "<nick> :End of WHOIS list"
+    RPL_WHOISCHANNELS     = 319 # "<nick> :*( ( "@" / "+" ) <channel> " " )"
+    RPL_WHOWASUSER        = 314 # "<nick> <user> <host> * :<real name>"
+    RPL_ENDWHOWAS         = 369 # "<nick> :End of WHOWAS"
+    RPL_LISTSTART         = 321 # Obsolete. Not used.
+    RPL_LIST              = 322 # "<channel> <# visible> :<topic>"
+    RPL_LISTEND           = 323 # ":End of LIST"
+    RPL_UNIQOPIS          = 325 # <channel> <nickname>"
+    RPL_CHANNELMODEIS     = 324 # "<channel> <mode> <mode params>"
+    RPL_NOTOPIC           = 331 # "<channel> :No topic is set"
+    RPL_TOPIC             = 332 # "<channel> :<topic>"
+    RPL_INVITING          = 341 # "<channel> <nick>"
+    RPL_SUMMONING         = 342 # "<user> :Summoning user to IRC"
+    RPL_INVITELIST        = 346 # "<channel> <invitemask>"
+    RPL_ENDOFINVITELIST   = 347 # "<channel> :End of channel invite list"
+    RPL_EXCEPTLIST        = 348 # "<channel> <exceptionmask>"
+    RPL_ENDOFEXCEPTLIST   = 349 # "<channel> :End of channel exception list"
+    RPL_VERSION           = 351 # "<version>.<debuglevel> <server> :<comments>"
+    RPL_WHOREPLY          = 352 # "<channel> <user> <host> <server> <nick>
+                                # ( "H" / "G" > ["*"] [ ( "@" / "+" ) ]
+                                # :<hopcount> <real name>"
+    RPL_ENDOFWHO          = 315 # "<name> :End of WHO list"
+    RPL_NAMREPLY          = 353 # ( "=" / "*" / "@" ) <channel>
+                                # :[ "@" / "+" ] <nick> *( " " [ "@" / "+" ] <nick> )
+                                # - "@" is used for secret channels, "*" for private
+                                # channels, and "=" for others (public channels).
+    RPL_ENDOFNAMES        = 366 # "<channel> :End of NAMES list"
+    RPL_LINKS             = 364 # "<mask> <server> :<hopcount> <server info>"
+    RPL_ENDOFLINKS        = 365 # "<mask> :End of LINKS list"
+    RPL_BANLIST           = 367 # "<channel> <banmask>"
+    RPL_ENDOFBANLIST      = 368 # "<channel> :End of channel ban list"
+    RPL_INFO              = 371 # ":<string>"
+    RPL_ENFOFINFO         = 374 # ":End of INFO list"
+    RPL_MOTDSTART         = 375 # ":- <server> Message of the day - "
+    RPL_MOTD              = 372 # ":- <text>"
+    RPL_ENDOFMOTD         = 376 # ":End of MOTD command"
+    RPL_YOUREOPER         = 381 # ":You are now an IRC operator"
+    RPL_REHASHING         = 382 # "<config file> :Rehashing"
+    RPL_YOURESERVICE      = 383 # "You are service <servicename>"
+    RPL_TIME              = 391 # "<server> :<server's local time>"
+    RPL_USERSSTART        = 392 # ":UserID Terminal Host"
+    RPL_USERS             = 393 # ":<username> <ttyline> <hostname>"
+    RPL_ENDOFUSERS        = 394 # ":End of users"
+    RPL_NOUSERS           = 395 # ":Nobody logged in"
+
+    ERR_NOSUCHNICK        = 401 # "<nickname> :No such nick/channel"
+    ERR_NOSUCHSERVER      = 402 # "<server name> :No such server"
+    ERR_NOSUCHCHANNEL     = 403 # "<channel name> :No such channel"
+    ERR_CANNOTSENDTOCHAN  = 404 # "<channel name> :Cannot send to channel"
+    ERR_TOOMANYCHANNELS   = 405 # "<channel name> :You have joined too many channels"
+    ERR_WASNOSUCHNICK     = 406 # "<nickname> :There was no such nickname"
+    ERR_TOOMANYTARGETS    = 407 # <target> :<error code> recipients. <abort message>"
+                                # - Returned to a client which is attempting to send a
+                                #   PRIVMSG/NOTICE using the user@host destination format
+                                #   and for a user@host which has several occurrences.
+                                # - Returned to a client which trying to send a
+                                #   PRIVMSG/NOTICE to too many recipients.
+                                # - Returned to a client which is attempting to JOIN a safe
+                                #   channel using the shortname when there are more than one
+                                #   such channel.
+    ERR_NOSUCHSERVICE     = 408 # "<service name> :No such service"
+    ERR_NOORIGIN          = 409 # ":No origin specified"
+                                # - PING or PONG message missing the
+                                #   originator parameter.
+    ERR_NORECIPIENT       = 411 # ":No recipient given (<command>)"
+    ERR_NOTEXTTOSEND      = 412 # ":No text to send"
+    ERR_NOTOPLEVEL        = 413 # "<mask> :No toplevel domain specified"
+    ERR_WILDTOPLEVEL      = 414 # "<mask> :Wildcard in toplevel domain"
+    ERR_BADMASK           = 415 # "<mask> :Bad server/host mask"
+    ERR_UNKNOWNCOMMAND    = 421 # "<command> :Unknown command"
+    ERR_NOMOTD            = 422 # ":MOTD File is missing"
+    ERR_NOADMININFO       = 423 # "<server> :No administrative info available"
+    ERR_FILEERROR         = 424 # ":File error doing <file op> on <file>"
+    ERR_NONICKNAMEGIVEN   = 431 # ":No nickname given"
+    ERR_ERRONEUSNICKNAME  = 432 # "<nick> :Erroneous nickname"
+    ERR_NICKNAMEINUSE     = 433 # "<nick> :Nickname is already in use"
+    ERR_NICKCOLLISION     = 436 # "<nick> :Nickname collision KILL from <user>@<host>"
+    ERR_UNAVAILRESOURCE   = 437 # "<nick/channel> :Nick/channel is temporarily unavailable"
+    ERR_USERNOTINCHANNEL  = 441 # "<nick> <channel> :They aren't on that channel"
+    ERR_NOTONCHANNEL      = 442 # "<channel> :You're not on that channel"
+    ERR_USERONCHANNEL     = 443 # "<user> <channel> :is already on channel"
+    ERR_NOLOGIN           = 444 # "<user> :User not logged in"
+    ERR_SUMMONDISABLED    = 445 # ":SUMMON has been disabled"
+    ERR_USERSDISABLED     = 446 # ":USERS has been disabled"
+    ERR_NOTREGISTERED     = 451 # ":You have not registered"
+    ERR_NEEDMOREPARAMS    = 461 # "<command> :Not enough parameters"
+    ERR_ALREADYREGISTRED  = 462 # ":Unauthorized command (already registered)"
+    ERR_NOPERMFORHOST     = 463 # ":Your host isn't among the privileged"
+    ERR_PASSWDMISMATCH    = 464 # ":Password incorrect"
+    ERR_YOUREBANNEDCREEP  = 465 # ":You are banned from this server"
+    ERR_YOUWILLBEBANNED   = 466 # Sent by a server to inform that access will soon be denied
+    ERR_KEYSET            = 467 # "<channel> :Channel key already set"
+    ERR_CHANNELISFULL     = 471 # "<channel> :Cannot join channel (+l)"
+    ERR_UNKNOWNMODE       = 472 # "<char> :is unknown mode char to me for <channel>"
+    ERR_INVITEONLYCHAN    = 473 # "<channel> :Cannot join channel (+i)"
+    ERR_BANNEDFROMCHAN    = 474 # "<channel> :Cannot join channel (+b)"
+    ERR_BADCHANNELKEY     = 475 # "<channel> :Cannot join channel (+k)"
+    ERR_BADCHANMASK       = 476 # "<channel> :Bad Channel Mask"
+    ERR_NOCHANMODES       = 477 # "<channel> :Channel doesn't support modes"
+    ERR_BANLISTFULL       = 478 # "<channel> <char> :Channel list is full"
+    ERR_NOPRIVILEGES      = 481 # ":Permission Denied - You're not an IRC operator"
+    ERR_CHANOPPRIVSNEEDED = 482 # "<channel> :You're not channel operator"
+    ERR_CANTKILLSERVER    = 483 # ":You can't kill a server!"
+    ERR_RESTRICTED        = 484 # ":Your connection is restricted!"
+    ERR_UNIQOPPRIVSNEEDED = 485 # ":You're not the original channel operator"
+    ERR_NOOPERHOST        = 491 # ":No O-lines for your host"
+    ERR_UMODEUNKNOWNFLAG  = 501 # ":Unknown MODE flag"
+    ERR_USERSDONTMATCH    = 502 # ":Cannot change mode for other users
+
+    # The following numerics are either:
+    #   1. no longer in use
+    #   2. reserved for future planned use
+    #   3. in current use but part of a non-generic 'feature'
+    #      of the current IRC server
+    RPL_SERVICEINFO       = 231
+    RPL_ENDOFSERVICES     = 232
+    RPL_SERVICE           = 233
+    RPL_NONE              = 300
+    RPL_WHOISCHANOP       = 316
+    RPL_KILLDONE          = 361
+    RPL_CLOSING           = 362
+    RPL_CLOSEEND          = 363
+    RPL_INFOSTART         = 373
+    RPL_MYPORTIS          = 384
+
+    RPL_STATSCLINE        = 213
+    RPL_STATSNLINE        = 214
+    RPL_STATSILINE        = 215
+    RPL_STATSKLINE        = 216
+    RPL_STATSQLINE        = 217
+    RPL_STATSYLINE        = 218
+    RPL_STATSVLINE        = 240
+    RPL_STATSLLINE        = 241
+    RPL_STATSHLINE        = 244
+    RPL_STATSSLINE        = 244
+    RPL_STATSPING         = 246
+    RPL_STATSBLINE        = 247
+    RPL_STATSDLINE        = 250
+
+    ERR_NOSERVICEHOST     = 492
+  end
+end

data/lib/flexo/plugin.rb

@@ -0,0 +1,69 @@
+module Flexo
+  # Base class of all plugins.
+  # All plugins wanting to be loaded by
+  # Flexo must subclass this class or face the 
+  # wrath of Flexo::PluginManager. 
+  #
+  # If the plugin requires persistent storage,
+  # keeping it as a YAML-file like ~/.flexo/<plugin>.yaml
+  # would make Flexo::Config load it when starting, and
+  # making them available to the plugin through a simple
+  # call to @manager.config[key]. But that requires plugins
+  # to make their own namespace, preferably something like
+  # plugins.<pluginname>.key to prevent collisions.
+  class Plugin
+    def self.const_missing(const)
+      super unless [:NAME, :VERSION, :SUMMARY, :DEPENDS].include?(const)
+    end
+
+    # Variable, mutex, check.
+    def initialize(plugins, *args)
+      @manager = Flexo::Manager.instance
+      @plugins = plugins
+      @manager.logger.debug "Created #{self.class}, with #{@plugins.to_a}"
+    end
+
+    # Overriding method_missing to let plugins use commands
+    # from other plugins. If the plugin tries to use a function
+    # that doesn't exist, check the list of loaded plugins
+    # if any of those respond to the function.
+    def method_missing(method_name, *args, &block)
+      @manager.logger.debug "Method #{method_name} not found in #{self.class}"
+      @plugins.each do |plugin_name, plugin|
+        @manager.logger.debug "  Checking in #{plugin_name}"
+        if plugin.respond_to?(method_name)
+          @manager.logger.debug "    Found #{method_name} in #{plugin_name}"
+          return plugin.__send__(method_name, *args, &block)
+        end
+      end
+
+      @manager.logger.debug "  Method #{method_name} not found in any loaded plugins"
+      super
+    end
+
+    # Synchronize mutex
+    def mutex
+      @manager.pluginmutex { yield }
+    end
+
+    # Convenience. See Flexo::Dispatcher.subscribe
+    def subscribe(event, &block)
+      @manager.dispatcher.subscribe(event, &block)
+    end
+
+    # Convenience. See Flexo::Dispatcher.unsubscribe
+    def unsubscribe(handler)
+      @manager.dispatcher.unsubscribe(handler)
+    end
+
+    # Convenience. See Flexo::Dispatcher.add_trigger
+    def add_trigger(pattern, &block)
+      @manager.dispatcher.add_trigger(pattern, &block)
+    end
+
+    # Convenience. See Flexo::Dispatcher.remove_trigger
+    def remove_trigger(trigger)
+      @manager.dispatcher.remove_trigger(trigger)
+    end
+  end
+end