blur 1.6.2.pre → 1.7.0

data/library/blur.rb

@@ -16,6 +16,7 @@ require 'blur/encryption'
 require 'blur/enhancements'
 require 'blur/script/cache'
 require 'blur/network/user'
+require 'blur/script/fantasy'
 require 'blur/network/channel'
 require 'blur/network/command'
 require 'blur/network/connection'
@@ -27,7 +28,7 @@ require 'blur/script/messageparsing'
 # It can be by handlers, scripts, communications, and what have you.
 module Blur
   # The major and minor version-values of Blur.
-  Version = "1.6.2.pre"
+  Version = "1.7.0"
 
   # Instantiates a client with given options and then makes the client instance
   # evaluate the given block to form a DSL.

data/library/blur/script.rb

@@ -46,6 +46,7 @@ module Blur
         end
         
         __send__ :loaded if respond_to? :loaded
+        __send__ :module_init if respond_to? :module_init
       end
     end
     

data/library/blur/script/fantasy.rb

@@ -0,0 +1,72 @@
+# encoding: utf-8
+
+module Blur
+  class Script < Module
+    # The +Fantasy+ module is a module that gives the ability to turn a
+    # script into a DSL-like framework.
+    #
+    # What it does is automatically test to see if a message starts with a
+    # trigger, and then, if so, it sends the command-part of the message to
+    # the script object itself.
+    #
+    # This way, the plugin-writer doesn't need to have repetetive code like
+    # that in every script.
+    #
+    # @example
+    #   Script :example do
+    #     include Fantasy
+    #
+    #     def command_test user, channel, message
+    #       channel.say "I hear you."
+    #     end
+    #   end
+    #
+    #   # And if a user were to send the message ".test my method", it would
+    #   # trigger the #command_test method with the following arguments
+    #   #
+    #   # user    => #<Blur::Network::User … >
+    #   # channel => #<Blur::Network::Channel … >
+    #   # message => ".test my method"
+    module Fantasy
+      # The prefix that turns it into a possible command.
+      MessageTrigger = "."
+
+      # Extend +klass+ with self.
+      def self.included klass
+        klass.extend self
+      end
+
+      # Called when a script has been loaded, for use in modules extending
+      # the script.
+      def module_init
+        @__fantasy_triggers = []
+
+        public_methods.grep(/^command_/).each do |trigger|
+          @__fantasy_triggers << trigger.to_s[8..-1]
+        end
+      end
+      
+      # Handle all calls to the scripts +message+ method, check to see if
+      # the message containts a valid command, serialize it and pass it to
+      # the script as command_name with the parameters +user+, +channel+
+      # and +message+.
+      def message user, channel, line
+        return unless line.start_with? MessageTrigger
+        
+        command, args = line.split $;, 2
+        trigger = serialize command
+
+        if @__fantasy_triggers.include? trigger
+          __send__ :"command_#{trigger}", user, channel, args
+        end
+      end
+      
+    protected
+      
+      # Strip all non-word characters from the input command.
+      def serialize name
+        name.gsub /\W/, '' if name
+      end
+    end
+  end
+end

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: blur
 version: !ruby/object:Gem::Version
-  version: 1.6.2.pre
-  prerelease: 6
+  version: 1.7.0
+  prerelease: 
 platform: ruby
 authors:
 - Mikkel Kroman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-19 00:00:00.000000000 Z
+date: 2012-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: majic
-  requirement: &19385580 !ruby/object:Gem::Requirement
+  requirement: &10805240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0.2'
   type: :runtime
   prerelease: false
-  version_requirements: *19385580
+  version_requirements: *10805240
 - !ruby/object:Gem::Dependency
   name: crypt19
-  requirement: &19401480 !ruby/object:Gem::Requirement
+  requirement: &10804700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 1.2.1
   type: :runtime
   prerelease: false
-  version_requirements: *19401480
+  version_requirements: *10804700
 - !ruby/object:Gem::Dependency
   name: eventmachine
-  requirement: &19401020 !ruby/object:Gem::Requirement
+  requirement: &10804040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -43,7 +43,7 @@ dependencies:
         version: '0.12'
   type: :runtime
   prerelease: false
-  version_requirements: *19401020
+  version_requirements: *10804040
 description: ! '    An event-driven IRC-framework in and for Ruby. Is extensible and
   supports script with (re)loading functionality during runtime.
 
@@ -53,21 +53,22 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- library/blur.rb
 - library/blur/client.rb
-- library/blur/encryption.rb
-- library/blur/encryption/base64.rb
-- library/blur/encryption/fish.rb
-- library/blur/enhancements.rb
-- library/blur/handling.rb
 - library/blur/network.rb
+- library/blur/encryption/fish.rb
+- library/blur/encryption/base64.rb
+- library/blur/encryption.rb
+- library/blur/script/fantasy.rb
+- library/blur/script/cache.rb
+- library/blur/script/messageparsing.rb
 - library/blur/network/channel.rb
 - library/blur/network/command.rb
-- library/blur/network/connection.rb
 - library/blur/network/user.rb
+- library/blur/network/connection.rb
 - library/blur/script.rb
-- library/blur/script/cache.rb
-- library/blur/script/messageparsing.rb
+- library/blur/enhancements.rb
+- library/blur/handling.rb
+- library/blur.rb
 homepage: https://github.com/mkroman/blur
 licenses:
 - ISC
@@ -84,12 +85,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: An event-driven IRC-framework for Ruby.