ircmachine 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: eb3c6abf09f3ce657496ebac2b2bb384a5fa9962
+  data.tar.gz: fff381302cd8132fe6412be5837f398d500a0d0f
+SHA512:
+  metadata.gz: ed5df1caa8891bfa3da2e627d1eccfb21d85d06d08ed4dcce37d8d5eea72aa8b3f6b6551238801be388b836f57f6c0185eea881aefa0964177e10cff4cd52dfb
+  data.tar.gz: 1b677c17b260d8c4234967a689e0fa70891c11ccacb65c0c0ad1701995d33fe2e8be0c98b1854fef39a5f767a2d0b51d47e65912dc28e16e81e9892bdb0a74ce

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+ref

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ircmachine.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Chris Davies
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,25 @@
+# IRCMachine
+
+A very basic gem for parsing and dealing with the IRC protocol.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ircmachine'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ircmachine
+
+## Contributing
+
+1. Fork it ( http://github.com/north636/ircmachine/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'ircmachine'
+  t.test_files = FileList['spec/**/*.rb']
+  t.verbose = true
+end

data/ircmachine.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ircmachine/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ircmachine'
+  spec.version       = IRCMachine::VERSION
+  spec.authors       = ['Chris Davies']
+  spec.email         = ['chris.davies.uk@member.mensa.org']
+  spec.summary       = %q{A simple IRC protocol parser.}
+  spec.description   = spec.summary
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'rake'
+end

data/lib/ircmachine/command.rb

@@ -0,0 +1,155 @@
+require 'ircmachine/message'
+
+module IRCMachine
+  module Command
+
+    class << self
+      def cmds
+        @cmds ||= {}
+      end
+      private :cmds
+
+      def from_msg(msg)
+        if (klass = cmds[msg.command]).nil?
+          fail ArgumentError, "Unknown command: #{msg.command}"
+        else
+          klass.new(msg.prefix, *msg.params)
+        end
+      end
+
+      def parse(str)
+        if (msg = IRCMachine::Message.parse(str)).nil?
+          fail ArgumentError, 'Invalid format for IRC message.'
+        else
+          from_msg(msg)
+        end
+      end
+
+      def defcmd(cmd, *arg_names)
+        cmd = cmd.strip.upcase
+
+        klass = Class.new do
+          define_method(:initialize) do |prefix = nil, *args|
+            instance_variable_set('@prefix', prefix)
+
+            arg_names.zip(args).each do |e|
+              name, value = e[0], e[1]
+              instance_variable_set("@#{name}", value)
+            end
+          end
+
+          # Create readers for the parameters.
+          arg_names.each do |name|
+            define_method(name) { instance_variable_get("@#{name}") }
+          end
+
+          define_method(:prefix) { instance_variable_get('@prefix') }
+
+          define_method(:to_msg) do
+            param_values = arg_names.map { |k| instance_variable_get("@#{k}") }.join(' ')
+
+            IRCMachine::Message.new(
+              instance_variable_get('@prefix'),
+              cmd,
+              param_values
+            )
+          end
+
+          define_method(:to_s) { self.to_msg.to_s }
+        end
+
+        const_set("#{cmd.capitalize}Command", klass)
+        cmds[cmd] = klass
+      end
+      private :defcmd
+
+      # Same as defcmd, but arguments are passed in reverse order.  This is to
+      # support commands like WHOIS, which has an optional parameter in the
+      # middle, rather than at the end...
+      def defrcmd(cmd, *arg_names)
+        cmd = cmd.strip.upcase
+
+        klass = Class.new do
+          define_method(:initialize) do |prefix = nil, *args|
+            instance_variable_set('@prefix', prefix)
+
+            arg_names.reverse.zip(args.reverse).each do |e|
+              name, value = e[0], e[1]
+              instance_variable_set("@#{name}", value)
+            end
+          end
+
+          # Create readers for the parameters.
+          arg_names.each do |name|
+            define_method(name) { instance_variable_get("@#{name}") }
+          end
+
+          define_method(:prefix) { instance_variable_get('@prefix') }
+
+          define_method(:to_msg) do
+            param_values = arg_names.reverse.map { |k| instance_variable_get("@#{k}") }.join(' ')
+
+            IRCMachine::Message.new(
+              instance_variable_get('@prefix'),
+              cmd,
+              param_values
+            )
+          end
+
+          define_method(:to_s) { self.to_msg.to_s }
+        end
+
+        const_set("#{cmd.capitalize}Command", klass)
+        cmds[cmd] = klass
+      end
+      private :defrcmd
+    end
+
+    defcmd  'PASS',     :password
+    defcmd  'NICK',     :nickname
+    defcmd  'USER',     :user, :mode, :unused, :realname, :name, :password
+    defcmd  'MODE',     :target, :modestring
+    defcmd  'SERVICE',  :nickname, :reserved, :distribution, :type, :reserved2, :info
+    defcmd  'QUIT',     :message
+    defcmd  'SQUIT',    :server, :comment
+    defcmd  'JOIN',     :channels, :keys
+    defcmd  'PART',     :channels
+    defcmd  'TOPIC',    :channel, :topic
+    defcmd  'NAMES',    :channels, :target
+    defcmd  'LIST',     :channels, :target
+    defcmd  'INVITE',   :nickname, :channel
+    defcmd  'KICK',     :channels, :users, :comment
+    defcmd  'PRIVMSG',  :target, :message
+    defcmd  'NOTICE',   :target, :message
+    defcmd  'MOTD',     :target
+    defcmd  'LUSERS',   :mask, :target
+    defcmd  'VERSION',  :target
+    defcmd  'STATS',    :query, :target
+    defcmd  'LINKS',    :remote_server, :server_mask
+    defcmd  'TIME',     :target
+    defcmd  'CONNECT',  :server, :port, :remote_server
+    defcmd  'TRACE',    :target
+    defcmd  'ADMIN',    :target
+    defcmd  'INFO',     :target
+    defcmd  'SERVLIST', :mask, :type
+    defcmd  'SQUERY',   :service, :text
+    defcmd  'WHO',      :mask, :o
+    defrcmd 'WHOIS',    :target, :who
+    defcmd  'WHOWAS',   :nicknames, :count, :target
+    defcmd  'KILL',     :nickname, :comment
+    defcmd  'PING',     :who, :server
+    defcmd  'PONG',     :who, :server
+    defcmd  'ERROR',    :message
+    defcmd  'AWAY',     :text
+    defcmd  'REHASH'
+    defcmd  'DIE'
+    defcmd  'RESTART'
+    defcmd  'SUMMON',   :user, :target, :channel
+    defcmd  'USERS',    :target
+    defcmd  'WALLOPS',  :text
+
+    # TODO: support multiple nicknames properly?
+    defcmd  'USERHOST', :nickname, :nickname2, :nickname3, :nickname4, :nickname5
+    defcmd  'ISON',     :nickname, :nickname2, :nickname3, :nickname4, :nickname5
+  end
+end

data/lib/ircmachine/ircsocketadapter.rb

@@ -0,0 +1,71 @@
+module IRCMachine
+  class IRCSocketAdapter
+    attr_reader :socket
+
+    # As per RFC 2812:
+    IRC_MAX_DATA = 512
+
+    def initialize(socket)
+      @socket       = socket
+      @messages     = []
+      @messages_mtx = Mutex.new
+      @buffer       = ''
+      @buffer_mtx   = Mutex.new
+    end
+
+    def recv(blocking = true)
+      # If we have data to return already, return it.
+      @messages_mtx.synchronize { return @messages.shift unless @messages.empty? }
+
+      got_msg = false
+      msg = nil
+      until got_msg
+        data =
+          if blocking
+            @socket.recv(IRC_MAX_DATA)
+          else
+            @socket.recv_nonblock(IRC_MAX_DATA)
+          end
+
+        unless data.nil?
+          @buffer_mtx.synchronize do
+            data.each_char do |c|
+              @buffer << c
+
+              if c == "\n"
+                @messages_mtx.synchronize do
+                  begin
+                    msg = IRCMachine::Message.parse(@buffer)
+                    @messages << msg
+                  rescue ArgumentError
+                    # => Not recognised; ignore it.
+                  end
+                end
+                @buffer = ''
+              elsif @buffer.size > IRC_MAX_DATA
+                # Too long.  Drop it.
+                @buffer = ''
+              end
+            end
+          end
+        end
+
+        msg = @messages_mtx.synchronize { @messages.shift unless @messages.empty? }
+        got_msg = !blocking || !msg.nil?
+      end
+
+      msg
+    end
+
+    def recv_nonblock
+      recv(false)
+    end
+
+    def send(data)
+      msg = IRCMachine::Message.parse(data)
+      fail ArgumentError, "Invalid IRC data." if msg.nil?
+
+      @socket.send(msg.to_s)
+    end
+  end
+end

data/lib/ircmachine/message.rb

@@ -0,0 +1,53 @@
+module IRCMachine
+  class Message
+    # Based on RFC 2812, section 2.3.1
+    SHORTNAME   = /[a-z0-9][a-z0-9-]*[a-z0-9]*/in
+    HOSTNAME    = /#{SHORTNAME}(?:\.#{SHORTNAME})*/n
+    SERVERNAME  = /#{HOSTNAME}/n
+    SPECIAL     = /[\x5b-\x60\x7b-\x7d]/n
+    NICKNAME    = /[a-z\x5b-\x60\x7b-\x7d][a-z0-9\x5b-\x60\x7b-\x7d-]{,8}/in
+    USER        = /[\x01-\x09\x0b-\x0c\x0e-\x1f\x21-\x3f\x41-\xff]+/n
+    IP4ADDR     = /[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}/n
+    IP6ADDR     = /(?:[0-9a-f]+(?::[0-9a-f]+){7})|(?:0:0:0:0:0:(?:0|ffff):#{IP4ADDR})/in
+    HOSTADDR    = /#{IP4ADDR}|#{IP6ADDR}/n
+    HOST        = /#{HOSTNAME}|#{HOSTADDR}/n
+    PREFIX      = /#{SERVERNAME}|(?:#{NICKNAME}((?:!#{USER})?@#{HOST})?)/n
+    COMMAND     = /[a-z]+|[0-9]{3}/in
+    NOSPCRLFCL  = /[\x01-\x09\x0b-\x0c\x0e-\x1f\x21-\x39\x3b-\xff]/n
+    TRAILING    = /(?:[: ]|#{NOSPCRLFCL})*/n
+    MIDDLE      = /#{NOSPCRLFCL}(?::|#{NOSPCRLFCL})*/n
+    PARAMS      = /(?:(?: #{MIDDLE}){,14}(?: :#{TRAILING})?)|(?:(?: #{MIDDLE}){,14}(?: :?#{TRAILING})?)/n
+    MESSAGE     = /^(?<prefix>:#{PREFIX} )?(?<command>#{COMMAND})(?<params>#{PARAMS})?\r\n$/n
+
+    attr_reader :prefix, :command, :params
+
+    def initialize(prefix, command, params)
+      @prefix   = prefix && prefix.strip
+      @command  = command
+
+      params = (params || '').strip
+      @params =
+        if params[0] == ':'
+          [ params ]
+        elsif (trail_index = params.index(' :')).nil?
+          params.split(/ +/)
+        else
+          params[0...trail_index].split(/ +/).push(params[trail_index..-1].strip)
+        end
+    end
+
+    def to_s
+      str = ''
+      str << "#{prefix} " unless prefix.nil?
+      str << command
+      str << " #{params.join(' ')}" unless params.empty?
+      str << "\r\n"
+    end
+
+    def self.parse(str)
+      unless (m = MESSAGE.match(str)).nil?
+        Message.new(m[:prefix], m[:command], m[:params])
+      end
+    end
+  end
+end

data/lib/ircmachine/version.rb

@@ -0,0 +1,3 @@
+module IRCMachine
+  VERSION = "0.0.1"
+end

data/lib/ircmachine.rb

@@ -0,0 +1,3 @@
+require 'ircmachine/command'
+require 'ircmachine/message'
+require 'ircmachine/version'

data/spec/command_spec.rb

@@ -0,0 +1,47 @@
+require 'minitest/autorun'
+
+require 'ircmachine/command'
+
+describe IRCMachine::Command do
+  describe 'defcmd' do
+    it 'should populate arguments correctly' do
+      c = IRCMachine::Command.parse("JOIN #channel key\r\n")
+      c.channels.must_equal '#channel'
+      c.keys.must_equal 'key'
+    end
+
+    it 'should leave fields as nil if not given' do
+      c = IRCMachine::Command.parse("JOIN #channel\r\n")
+      c.channels.must_equal '#channel'
+      c.keys.must_be_nil
+    end
+
+    it 'should produce commands that themselves produce correct Message objects' do
+      c = IRCMachine::Command.parse(":foo JOIN #channel key\r\n")
+      m = c.to_msg
+      m.wont_be_nil
+      m.prefix.must_equal ':foo'
+      m.command.must_equal 'JOIN'
+      m.params.must_equal ['#channel', 'key']
+    end
+
+    it 'should produce commands that themselves produce valid IRC commands with to_s' do
+      c = IRCMachine::Command.parse(":foo QUIT :my quit message\r\n")
+      c.to_s.must_equal ":foo QUIT :my quit message\r\n"
+    end
+  end
+
+  describe 'defrcmd' do
+    it 'should populate the last argument first' do
+      c = IRCMachine::Command.parse("WHOIS foo\r\n")
+      c.target.must_be_nil
+      c.who.must_equal 'foo'
+    end
+
+    it 'should populate the arguments in reverse order' do
+      c = IRCMachine::Command.parse("WHOIS example.com foo\r\n")
+      c.target.must_equal 'example.com'
+      c.who.must_equal 'foo'
+    end
+  end
+end

data/spec/ircsocketadapter_spec.rb

@@ -0,0 +1,90 @@
+require 'minitest/autorun'
+
+require 'ircmachine/ircsocketadapter'
+
+describe IRCMachine::IRCSocketAdapter do
+  it 'sends valid IRC data' do
+    sock = MiniTest::Mock.new
+    sock.expect(:send, true, [ "JOIN #channel\r\n" ])
+
+    sa = IRCMachine::IRCSocketAdapter.new(sock)
+    sa.send("JOIN #channel\r\n")
+
+    sock.verify
+  end
+
+  it 'raises an ArgumentError when trying to send invalid IRC data' do
+    sock = MiniTest::Mock.new
+    sa = IRCMachine::IRCSocketAdapter.new(sock)
+
+    proc {
+      sa.send("this isn't IRC data!")
+    }.must_raise ArgumentError
+  end
+
+  it 'returns Message objects when receiving a single message' do
+    sock = MiniTest::Mock.new
+    sock.expect(:recv, ":foo@example.com QUIT :some message\r\n", [ Fixnum ])
+
+    sa = IRCMachine::IRCSocketAdapter.new(sock)
+    msg = sa.recv
+
+    msg.wont_be_nil
+    msg.must_be_instance_of IRCMachine::Message
+
+    sock.verify
+  end
+
+  it 'queues Message objects and returns them in order when receiving multiple messages' do
+    sock = MiniTest::Mock.new
+    sock.expect(:recv, ":foo@example.com QUIT :some message\r\n:bar@example.com PRIVMSG #chan :blah blah\r\n", [ Fixnum ])
+
+    sa = IRCMachine::IRCSocketAdapter.new(sock)
+    msg = sa.recv
+
+    msg.wont_be_nil
+    msg.must_be_instance_of IRCMachine::Message
+    msg.command.must_equal 'QUIT'
+
+    msg = sa.recv
+
+    msg.wont_be_nil
+    msg.must_be_instance_of IRCMachine::Message
+    msg.command.must_equal 'PRIVMSG'
+
+    sock.verify
+  end
+
+  it 'buffers messages if only partial data is received and does multiple recv if blocking' do
+    sock = MiniTest::Mock.new
+    sock.expect(:recv, ":foo@example.com QUIT :", [ Fixnum ])
+    sock.expect(:recv, "some message\r\n", [ Fixnum ])
+
+    sa = IRCMachine::IRCSocketAdapter.new(sock)
+    msg = sa.recv
+    
+    msg.wont_be_nil
+    msg.must_be_instance_of IRCMachine::Message
+    msg.command.must_equal 'QUIT'
+
+    sock.verify
+  end
+
+  it 'buffers messages if only partial data is received, but only does on recv if non-blocking' do
+
+    sock = MiniTest::Mock.new
+    sock.expect(:recv_nonblock, ":foo@example.com QU", [ Fixnum ])
+    sock.expect(:recv_nonblock, "IT :blah\r\n", [ Fixnum ])
+
+    sa = IRCMachine::IRCSocketAdapter.new(sock)
+    msg = sa.recv_nonblock
+    msg.must_be_nil
+
+    msg = sa.recv_nonblock
+    msg.wont_be_nil
+    msg.must_be_instance_of IRCMachine::Message
+    msg.command.must_equal 'QUIT'
+
+    sock.verify
+  end
+end

data/spec/message_spec.rb

@@ -0,0 +1,59 @@
+require 'minitest/autorun'
+
+require 'ircmachine/message'
+
+describe IRCMachine::Message do
+  it 'should parse basic commands with no prefix and no parameters' do
+    m = IRCMachine::Message.parse("QUIT\r\n")
+    m.wont_be_nil
+    m.command.must_equal 'QUIT'
+    m.prefix.must_be_nil
+    m.params.must_be_empty
+  end
+
+  it 'should parse commands that have one parameter' do
+    m = IRCMachine::Message.parse("JOIN #hello\r\n")
+    m.wont_be_nil
+    m.command.must_equal 'JOIN'
+    m.prefix.must_be_nil
+    m.params.size.must_equal 1
+    m.params[0].must_equal '#hello'
+  end
+
+  it 'should parse commands that have multiple parameters' do
+    m = IRCMachine::Message.parse("PRIVMSG #chan :this is my message\r\n")
+    m.wont_be_nil
+    m.command.must_equal 'PRIVMSG'
+    m.prefix.must_be_nil
+    m.params.size.must_equal 2
+    m.params[0].must_equal '#chan'
+    m.params[1].must_equal ':this is my message'
+  end
+
+  it 'should parse commands with a prefix containing just a nickname' do
+    m = IRCMachine::Message.parse(":nick QUIT :blah\r\n")
+    m.wont_be_nil
+    m.command.must_equal 'QUIT'
+    m.prefix.must_equal ':nick'
+    m.params.size.must_equal 1
+    m.params[0].must_equal ':blah'
+  end
+
+  it 'should parse commands with a prefix containing a nickname and a host' do
+    m = IRCMachine::Message.parse(":nick@host QUIT :blah\r\n")
+    m.wont_be_nil
+    m.command.must_equal 'QUIT'
+    m.prefix.must_equal ':nick@host'
+    m.params.size.must_equal 1
+    m.params[0].must_equal ':blah'
+  end
+
+  it 'should parse commands with a prefix containing a nickname, username and a host' do
+    m = IRCMachine::Message.parse(":nick!user@host QUIT :blah\r\n")
+    m.wont_be_nil
+    m.command.must_equal 'QUIT'
+    m.prefix.must_equal ':nick!user@host'
+    m.params.size.must_equal 1
+    m.params[0].must_equal ':blah'
+  end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: ircmachine
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Chris Davies
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A simple IRC protocol parser.
+email:
+- chris.davies.uk@member.mensa.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- ircmachine.gemspec
+- lib/ircmachine.rb
+- lib/ircmachine/command.rb
+- lib/ircmachine/ircsocketadapter.rb
+- lib/ircmachine/message.rb
+- lib/ircmachine/version.rb
+- spec/command_spec.rb
+- spec/ircsocketadapter_spec.rb
+- spec/message_spec.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: A simple IRC protocol parser.
+test_files:
+- spec/command_spec.rb
+- spec/ircsocketadapter_spec.rb
+- spec/message_spec.rb