atheme 0.0.4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1ef808aa81937926711c9c9222cfbaf6ededde5c
-  data.tar.gz: 2c0801d9b8f22cb983553d044223a95865a267c2
+  metadata.gz: f2998dc6b7bb543e351d32b16752b46209b48d68
+  data.tar.gz: 2c22e7cb236a49f1d3806fee16d2cec721643dad
 SHA512:
-  metadata.gz: 4b407ac82837f0a9415a9f935690cbb4e3adecafa8c72dc6d61cd77ae1c175c7e4811979353f2b855afef6e15ec0fb6f730278cf06ff59ba2d075893b0941771
-  data.tar.gz: cd978456efc0e66bda28bb1ea4ca8403554966c5e7655e9f24819aedef1b3590da3f9b9f7d8528f71396981853398f68dcf462af1c14fcea14bfaec1cca13cdc
+  metadata.gz: c640de4939bb35e70df70830a32ae4a650ed63d8f1502d77f1bd09d77745cbd17a3d230a39d5e2a5cf3868aed654bcd203da9d74858d694707d15fcff899bea4
+  data.tar.gz: d9638c291948f850680a300b033c88b97dbeae62d429d941b4d3fe52b54fd8a56a4dd19322f2b08722c20f3a81b696e9a0488446f170b6a26a46b74f9287826d

data/.gitignore

@@ -15,4 +15,3 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
-spec/config.yml

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2013 James Newton and Robert Babcock
+Copyright (c) 2013 James Newton <james@Zaphyous.com>
 
 MIT License
 

data/README.md

@@ -27,10 +27,7 @@ You need to be using [Atheme IRC Services](http://www.atheme.net) with httpd and
 ### Configuration
 
 ```ruby
-Atheme.configure do |config|
-  config.hostname = 'example.com'
-  config.port = 9876
-end
+Atheme.configure hostname: 'example.com', port: 1234, protocol: 'http'
 ```
 
 Optional: `protocol` (default http)
@@ -54,7 +51,22 @@ Any command can be used that the user has access to use.
 
 Command format: `Atheme::ServiceName.command 'param', 'param', ...`
 
-To see services supported [go here](https://github.com/zaphyous/atheme-ruby/tree/develop/lib/atheme/services).
+To see supported services [go here](https://github.com/zaphyous/atheme-ruby/blob/feature/chanserv_methods/lib/atheme.rb#L21).
+
+If you use a custom service you can create a class like so:
+
+```ruby
+class Atheme::ServiceName < Atheme::Service
+end
+```
+
+Each command will return an object of the `Atheme::Service` that is used. All will always have `#to_raw` that has the raw services output.
+
+Some commands will return an object with additional methods on them depending if a parser exists for that command. [Parsers can be seen here](https://github.com/zaphyous/atheme-ruby/tree/develop/lib/atheme/parsers)
+
+## Testing
+
+In order to be able to generate VCR cassettes properly when testing (minus those that already exist!) you must run a local IRC server with Atheme with httpd and XMLRPC enabled (listening on `localhost:1234`).
 
 ## Contributing
 

data/Rakefile

@@ -1 +1,6 @@
 require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/atheme.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ['james@Zaphyous.com', 'robert@Zaphyous.com']
   spec.description   = %q{A ruby wrapper around the Atheme IRC Services XMLRPC interface}
   spec.summary       = %q{atheme-ruby is an easy way to integrate your ruby application with the Atheme IRC Services XMLRPC interface}
-  spec.homepage      = 'https://github.com/zaphyous/atheme'
+  spec.homepage      = 'https://github.com/zaphyous/atheme-ruby'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files`.split($/)
@@ -24,4 +24,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard-rspec'
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rb-fsevent'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'webmock'
 end

data/lib/atheme.rb

@@ -1,5 +1,6 @@
 module Atheme
   SERVICES = []
+  PARSERS  = {}
 end
 
 require 'xmlrpc/client'
@@ -7,17 +8,28 @@ require 'atheme/version'
 require 'atheme/errors'
 require 'atheme/configuration'
 require 'atheme/authenticate'
-require 'atheme/service'
 require 'atheme/objectified_hash'
+require 'atheme/support'
+require 'atheme/parser'
+require 'atheme/parser_helper'
+
+Dir[File.expand_path('../atheme/parsers/*.rb', __FILE__)].each { |file| require file }
 
-Dir[File.expand_path('../atheme/services/*.rb', __FILE__)].each { |file| require file }
+require 'atheme/service'
 
 module Atheme
   extend Configuration
   extend Authenticate
 
+  %w(ALIS ChanServ GameServ Global GroupServ HelpServ HostServ InfoServ MemoServ NickServ OperServ RPGServ StatServ).each do |name|
+    module_eval <<-RUBY
+      class Atheme::#{name} < Atheme::Service
+      end
+    RUBY
+  end
+
   def self.server
-    XMLRPC::Client.new2("#{Atheme.protocol}://#{Atheme.hostname}:#{Atheme.port}/xmlrpc")
+    XMLRPC::Client.new2("#{Atheme.options.protocol}://#{Atheme.options.hostname}:#{Atheme.options.port}/xmlrpc")
   end
 
   def self.call(*args)

data/lib/atheme/configuration.rb

@@ -1,9 +1,21 @@
 module Atheme::Configuration
-  attr_accessor :hostname, :port, :protocol
+  REQUIRED_OPTIONS = [:hostname, :port]
 
-  def configure
-    self.protocol ||= 'http'
+  def configure(opts = {})
+    unless validate_options(opts)
+      raise Atheme::Error::InvalidConfiguration, "Missing configuration options: #{REQUIRED_OPTIONS.delete_if { |x| opts.has_key?(x) }.join(', ')}"
+    end
 
-    yield self
+    opts[:protocol] ||= 'http'
+
+    @options = opts
+  end
+
+  def options
+    Atheme::ObjectifiedHash.new(@options)
+  end
+
+  def validate_options(opts)
+    REQUIRED_OPTIONS.delete_if { |x| opts.has_key?(x) }.count == 0
   end
 end

data/lib/atheme/errors.rb

@@ -1,4 +1,4 @@
 module Atheme::Error
-  class NoUserSet < StandardError
-  end
+  class InvalidUser < StandardError; end
+  class InvalidConfiguration < StandardError; end
 end

data/lib/atheme/parser.rb

@@ -0,0 +1,47 @@
+module Atheme::Parser
+  def self.included(klass)
+    if klass.name.split('::').count > 3
+      service = klass.name.sub('Atheme::Parser::', '').gsub(/::.*/, '')
+      command = klass.name.sub('Atheme::Parser::', '').gsub(/.*::/, '').downcase
+
+      Atheme::PARSERS[service] ||= []
+
+      (Atheme::PARSERS[service] << command) unless command == ''
+
+      Atheme::PARSERS[service].uniq!
+    end
+  end
+
+  def command(name, &block)
+    @commands << [name, block]
+  end
+
+  def parse(name)
+    @commands = []
+
+    create_parser(name)
+
+    yield if block_given?
+
+    create_commands if @commands.count > 0
+  end
+
+  private
+
+  def create_parser(name)
+    @parser = "Atheme::Parser::#{self.name.gsub('Atheme::Parser::', '')}::#{name.capitalize}"
+
+    module_eval <<-RUBY
+      module #{@parser}
+        include Atheme::Parser
+        include Atheme::ParserHelper
+      end
+    RUBY
+  end
+
+  def create_commands
+    @commands.each do |command, block|
+      Atheme::Support.constantize(@parser).send(:define_method, command, block)
+    end
+  end
+end

data/lib/atheme/parser_helper.rb

@@ -0,0 +1,5 @@
+module Atheme::ParserHelper
+  def match(expression)
+    expression.match(raw_services_output)[1]
+  end
+end

data/lib/atheme/parsers/chanserv.rb

@@ -0,0 +1,15 @@
+module Atheme::Parser::ChanServ
+  extend Atheme::Parser
+
+  parse :info do
+    command(:founder) { match(/Founder\s+:\s+(\w+)/) }
+
+    command :registered do
+      Date.parse(match(/Registered\s+:\s+(\w+ [0-9]{2} [0-9(:?)]+ [0-9]{4})/)).to_time
+    end
+
+    command :successor do
+      raw_services_output.match(/Successor\s+:\s+\(none\)/) ? nil : match(/Successor\s+:\s+(\w+)/)
+    end
+  end
+end

data/lib/atheme/service.rb

@@ -1,11 +1,39 @@
 class Atheme::Service
+  attr_reader :raw_services_output
+
+  def initialize(output)
+    @raw_services_output = output
+  end
+
   def self.inherited(klass)
     Atheme::SERVICES << klass.name.gsub('Atheme::', '')
   end
 
+  def self.create_service_object(method, service, atheme_data)
+    if parser_for?(service, method)
+      parser = Atheme::Support.constantize("Atheme::Parser::#{service}::#{method.capitalize}")
+
+      self.new(atheme_data).extend(parser)
+    else
+      self.new(atheme_data)
+    end
+  end
+
   def self.method_missing(method, *args, &block)
-    raise Atheme::Error::NoUserSet, 'No user has been set' if Atheme.user.nil?
+    raise Atheme::Error::InvalidUser, 'No user has been set' if Atheme.user.nil?
+
+    service = self.name.gsub('Atheme::', '')
+
+    self.create_service_object(method, service, Atheme.call('atheme.command',
+      Atheme.user.cookie, Atheme.user.username, Atheme.user.ip,
+      service, method, *args))
+  end
 
-    Atheme.call('atheme.command', Atheme.user.cookie, Atheme.user.username, Atheme.user.ip, self.name.gsub('Atheme::', ''), method, *args)
+  def self.parser_for?(service, command)
+    if Atheme::PARSERS.include?(service)
+      Atheme::PARSERS[service].include?(command.to_s)
+    else
+      false
+    end
   end
 end

data/lib/atheme/support.rb

@@ -0,0 +1,14 @@
+module Atheme::Support
+  def self.constantize(camel_cased_word)
+    names = camel_cased_word.split('::')
+    names.shift if names.empty? || names.first.empty?
+
+    constant = Object
+
+    names.each do |name|
+        constant = constant.const_defined?(name) ? constant.const_get(name) : constant.const_missing(name)
+    end
+
+    constant
+  end
+end

data/lib/atheme/version.rb

@@ -1,3 +1,3 @@
 module Atheme
-  VERSION = '0.0.4'
+  VERSION = '0.1.0'
 end

data/spec/config.yml

@@ -0,0 +1,9 @@
+hostname: localhost
+port: 1234
+protocol: http
+
+nick: username
+password: password
+ip: 127.0.0.1
+
+channel: '#channel'

data/spec/lib/authenticate_spec.rb

@@ -2,19 +2,25 @@ require 'spec_helper'
 
 describe Atheme::Authenticate do
   it 'should get a cookie when logging in' do
-    expect(Atheme.login(atheme_config['nick'], atheme_config['password'])).to match(/([a-z]){20}/)
+    VCR.use_cassette('authenticate_success') do
+      expect(Atheme.login(atheme_config['nick'], atheme_config['password'])).to match(/([a-z]){20}/)
+    end
   end
 
   it 'should get a XMLRPC::FaultException when incorrect login information is provided' do
-    expect { Atheme.login(atheme_config['nick'], 'bad-password') }.to raise_error XMLRPC::FaultException
+    VCR.use_cassette('authenticate_error') do
+      expect { Atheme.login(atheme_config['nick'], 'bad-password') }.to raise_error XMLRPC::FaultException
+    end
   end
 
   it 'should remember a user when set' do
-    cookie = Atheme.login(atheme_config['nick'], atheme_config['password'])
+    VCR.use_cassette('authenticate_success') do
+      cookie = Atheme.login(atheme_config['nick'], atheme_config['password'])
 
-    Atheme.set_user(cookie, atheme_config['nick'], atheme_config['ip'])
+      Atheme.set_user(cookie, atheme_config['nick'], atheme_config['ip'])
 
-    expect(Atheme.user.cookie).to eql cookie
-    expect(Atheme.user.username).to eql atheme_config['nick']
+      expect(Atheme.user.cookie).to eql cookie
+      expect(Atheme.user.username).to eql atheme_config['nick']
+    end
   end
 end

data/spec/lib/configuration_spec.rb

@@ -2,14 +2,14 @@ require 'spec_helper'
 
 describe Atheme::Configuration do
   it 'should have a port' do
-    expect(Atheme.port).to eql atheme_config['port']
+    expect(Atheme.options.port).to eql 1234
   end
 
-  it 'should have a url' do
-    expect(Atheme.hostname).to eql atheme_config['hostname']
+  it 'should have a hostname' do
+    expect(Atheme.options.hostname).to eql 'localhost'
   end
 
   it 'should have a protocol' do
-    expect(Atheme.protocol).to eql atheme_config['protocol']
+    expect(Atheme.options.protocol).to eql 'http'
   end
 end

data/spec/lib/parser_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe Atheme::Parser do
+  before do
+    module Atheme::Parser::ChanServ
+      extend Atheme::Parser
+    end
+  end
+
+  context '#parse' do
+    module Atheme::Parser::ChanServ
+      parse :info
+    end
+
+    it 'should create a parser module' do
+      expect(Atheme::Parser::ChanServ::Info).to be_true
+    end
+
+    it 'should create multiple parser modules' do
+      module Atheme::Parser::ChanServ
+        parse :help
+      end
+
+      expect(Atheme::Parser::ChanServ::Info).to be_true
+      expect(Atheme::Parser::ChanServ::Help).to be_true
+    end
+  end
+
+  context '#command' do
+    module Atheme::Parser::ChanServ
+      parse :info do
+        command(:one) { 'one' }
+      end
+    end
+
+    it 'should create a method on the parser' do
+      expect(Atheme::Parser::ChanServ::Info.method_defined?(:one)).to be_true
+    end
+
+    it 'should create multiple methods on the parser' do
+      module Atheme::Parser::ChanServ
+        parse :help do
+          command(:one) { 'one' }
+          command(:two) { 'two' }
+        end
+      end
+
+      [:one, :two].each do |method|
+        expect(Atheme::Parser::ChanServ::Help.method_defined?(method)).to be_true
+      end
+    end
+  end
+end

data/spec/lib/parsers/chanserv_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Atheme::Parser::ChanServ do
+  context '.info' do
+    before { authenticate }
+
+    let(:info) do
+      VCR.use_cassette('chanserv_info') do
+        Atheme::ChanServ.info atheme_config['channel']
+      end
+    end
+
+    it 'has a founder' do
+      expect(info.founder).to eql atheme_config['nick']
+    end
+
+    it 'has a successor' do
+      expect(info.successor).to eql 'username_'
+    end
+
+    it 'should have a registered date' do
+      expect(info.registered).to eql Date.parse('2013-02-08').to_time
+    end
+  end
+end

data/spec/lib/service_spec.rb

@@ -8,12 +8,26 @@ describe 'Atheme::Service' do
   it 'should be able to query services' do
     authenticate
 
-    expect(Atheme::ChanServ.help).to be_true
+    VCR.use_cassette('chanserv_help') do
+      expect(Atheme::ChanServ.help).to be_true
+    end
+  end
+
+  it 'should error when an invalid services command is used' do
+    VCR.use_cassette('bad_service_command') do
+      expect{ Atheme::ChanServ.bad_method }.to raise_error XMLRPC::FaultException
+    end
+  end
+
+  it 'should have raw xmlrpc output in to_raw' do
+    VCR.use_cassette('chanserv_help') do
+      expect(Atheme::ChanServ.help.raw_services_output).to include('***** ChanServ Help *****')
+    end
   end
 
   it 'should raise an error when no user is set' do
     Atheme.user = nil
 
-    expect { Atheme::ChanServ.help }.to raise_error Atheme::Error::NoUserSet
+    expect { Atheme::ChanServ.help }.to raise_error Atheme::Error::InvalidUser
   end
 end

data/spec/spec_helper.rb

@@ -1,6 +1,8 @@
 require 'rspec'
 require 'pry'
 require 'atheme'
+require 'vcr'
+require 'webmock/rspec'
 
 Dir[File.expand_path('../support/**/*.rb', __FILE__)].each { |file| require file }
 
@@ -9,19 +11,22 @@ def atheme_config
 end
 
 def configure_atheme
-  Atheme.configure do |config|
-    config.port = atheme_config['port']
-    config.hostname = atheme_config['hostname']
-    config.protocol = atheme_config['protocol']
-  end
+  Atheme.configure port: 1234, hostname: 'localhost'
 end
 
-def authenticate
-  cookie = Atheme.login(atheme_config['nick'], atheme_config['password'])
+RSpec.configure do |config|
+  config.before { configure_atheme }
+end
 
-  Atheme.set_user(cookie, atheme_config['nick'], atheme_config['ip'])
+VCR.configure do |config|
+  config.cassette_library_dir = 'spec/vcr_cassettes'
+  config.hook_into :webmock
 end
 
-RSpec.configure do |config|
-  config.before(:each) { configure_atheme }
+def authenticate
+  VCR.use_cassette('authenticate_success') do
+    cookie = Atheme.login(atheme_config['nick'], atheme_config['password'])
+
+    Atheme.set_user(cookie, atheme_config['nick'], atheme_config['ip'])
+  end
 end

data/spec/vcr_cassettes/authenticate_error.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:1234/xmlrpc
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" ?><methodCall><methodName>atheme.login</methodName><params><param><value><string>username</string></value></param><param><value><string>bad-password</string></value></param></params></methodCall>
+    headers:
+      User-Agent:
+      - XMLRPC::Client (Ruby 2.0.0)
+      Content-Type:
+      - text/xml; charset=utf-8
+      Content-Length:
+      - '214'
+      Connection:
+      - keep-alive
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Atheme/7.0.5
+      Content-Type:
+      - text/xml
+      Content-Length:
+      - '363'
+    body:
+      encoding: UTF-8
+      string: "<?xml version=\"1.0\"?>\r\n<methodResponse>\r\n <fault>\r\n  <value>\r\n
+        \  <struct>\r\n    <member>\r\n     <name>faultCode</name>\r\n     <value><int>5</int></value>\r\n
+        \   </member>\r\n    <member>\r\n     <name>faultString</name>\r\n     <value><string>The
+        password is not valid for this account.</string></value>\r\n    </member>\r\n
+        \  </struct>\r\n  </value>\r\n </fault>\r\n</methodResponse>"
+    http_version: 
+  recorded_at: Thu, 11 Apr 2013 07:09:35 GMT
+recorded_with: VCR 2.4.0

data/spec/vcr_cassettes/authenticate_success.yml

@@ -0,0 +1,40 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:1234/xmlrpc
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" ?><methodCall><methodName>atheme.login</methodName><params><param><value><string>username</string></value></param><param><value><string>password</string></value></param></params></methodCall>
+    headers:
+      User-Agent:
+      - XMLRPC::Client (Ruby 2.0.0)
+      Content-Type:
+      - text/xml; charset=utf-8
+      Content-Length:
+      - '212'
+      Connection:
+      - keep-alive
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Atheme/7.0.5
+      Content-Type:
+      - text/xml
+      Content-Length:
+      - '165'
+    body:
+      encoding: UTF-8
+      string: "<?xml version=\"1.0\"?>\r\n<methodResponse>\r\n<params>\r\n <param>\r\n
+        \ <value>\r\n   <string>qiyrmryiqqdrqqtswqnk</string>\r\n  </value>\r\n </param>\r\n</params>\r\n</methodResponse>"
+    http_version: 
+  recorded_at: Thu, 11 Apr 2013 07:08:42 GMT
+recorded_with: VCR 2.4.0

data/spec/vcr_cassettes/bad_service_command.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:1234/xmlrpc
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" ?><methodCall><methodName>atheme.command</methodName><params><param><value><string>qiyrmryiqqdrqqtswqnk</string></value></param><param><value><string>username</string></value></param><param><value><string>127.0.0.1</string></value></param><param><value><string>ChanServ</string></value></param><param><value><string>bad_method</string></value></param></params></methodCall>
+    headers:
+      User-Agent:
+      - XMLRPC::Client (Ruby 2.0.0)
+      Content-Type:
+      - text/xml; charset=utf-8
+      Content-Length:
+      - '392'
+      Connection:
+      - keep-alive
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Atheme/7.0.5
+      Content-Type:
+      - text/xml
+      Content-Length:
+      - '341'
+    body:
+      encoding: UTF-8
+      string: "<?xml version=\"1.0\"?>\r\n<methodResponse>\r\n <fault>\r\n  <value>\r\n
+        \  <struct>\r\n    <member>\r\n     <name>faultCode</name>\r\n     <value><int>3</int></value>\r\n
+        \   </member>\r\n    <member>\r\n     <name>faultString</name>\r\n     <value><string>Invalid
+        command name.</string></value>\r\n    </member>\r\n   </struct>\r\n  </value>\r\n
+        </fault>\r\n</methodResponse>"
+    http_version: 
+  recorded_at: Thu, 11 Apr 2013 07:11:24 GMT
+recorded_with: VCR 2.4.0

data/spec/vcr_cassettes/chanserv_help.yml

@@ -0,0 +1,70 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:1234/xmlrpc
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" ?><methodCall><methodName>atheme.command</methodName><params><param><value><string>qiyrmryiqqdrqqtswqnk</string></value></param><param><value><string>username</string></value></param><param><value><string>127.0.0.1</string></value></param><param><value><string>ChanServ</string></value></param><param><value><string>help</string></value></param></params></methodCall>
+    headers:
+      User-Agent:
+      - XMLRPC::Client (Ruby 2.0.0)
+      Content-Type:
+      - text/xml; charset=utf-8
+      Content-Length:
+      - '386'
+      Connection:
+      - keep-alive
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Atheme/7.0.5
+      Content-Type:
+      - text/xml
+      Content-Length:
+      - '2460'
+    body:
+      encoding: UTF-8
+      string: "<?xml version=\"1.0\"?>\r\n<methodResponse>\r\n<params>\r\n <param>\r\n
+        \ <value>\r\n   <string>***** ChanServ Help *****\nChanServ gives normal users
+        the ability to maintain controlof a channel, without the need of a bot. Channel
+        takeovers arevirtually impossible when a channel is registered with ChanServ.Registration
+        is a quick and painless process. Once registered,the founder can maintain
+        complete and total control over the channel.\nPlease note that channels will
+        expire after 30 days of inactivity,or if there are no eligible channel successors.Activity
+        is defined as a user with one of +FORforsv being on the channel.\nSuccessors
+        are primarily those who have the +R flagset on their account in the channel,
+        although otherpeople may be chosen depending on their accesslevel and activity.\n
+        \nCommands can also be given on channel by prefixing one of '.'and omitting
+        the channel name. These are called &quot;fantasy&quot;commands and can also
+        be disabled on a per-channel basis.\n \nFor more information on a command,
+        type:\n/msg ChanServ help &lt;command&gt;\nFor a verbose listing of all commands,
+        type:\n/msg ChanServ help commands\n \nThe following commands are available:\nCLOSE
+        \          Closes a channel.\nFDROP           Forces dropping of a channel
+        registration.\nFFLAGS          Forces a flags change on a channel.\nFLAGS
+        \          Manipulates specific permissions on a channel.\nFTRANSFER       Forces
+        foundership transfer of a channel.\nINVITE          Invites you to a channel.\nOP
+        \             Gives channel ops to a user.\nRECOVER         Regain control
+        of your channel.\nREGISTER        Registers a channel.\nSET             Sets
+        various control flags.\nUNBAN           Removes a ban on a channel.\n \nOther
+        commands: ACCESS, ACTIVATE, AKICK, BADWORDS, BAN, \n                CALC,
+        CLEAR, CLONE, COUNT, DEOP, DEVOICE, \n                DF, DOWN, DROP, EIGHTBALL,
+        FREGISTER, GETKEY, \n                HELP, HOLD, INFO, KICK, KICKBAN, LIST,
+        LOTTERY, \n                MARK, NAMEGEN, NWOD, PING, QUIET, REJECT, \n                ROLE,
+        ROLL, ROULETTE, RPS, STATUS, SYNC, \n                TAXONOMY, TEMPLATE, TOPIC,
+        TOPICAPPEND, \n                TOPICPREPEND, UNQUIET, UP, USERINFO, VOICE,
+        \n                WAITING, WHY, WOD\n***** End of Help *****\nIf you're having
+        trouble or you need some additional help, you may want to join the help channel
+        #help or visit the help webpage http://www.stack.nl/~jilles/irc/atheme-help/</string>\r\n
+        \ </value>\r\n </param>\r\n</params>\r\n</methodResponse>"
+    http_version: 
+  recorded_at: Thu, 11 Apr 2013 07:08:42 GMT
+recorded_with: VCR 2.4.0

data/spec/vcr_cassettes/chanserv_info.yml

@@ -0,0 +1,44 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://localhost:1234/xmlrpc
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" ?><methodCall><methodName>atheme.command</methodName><params><param><value><string>qiyrmryiqqdrqqtswqnk</string></value></param><param><value><string>username</string></value></param><param><value><string>127.0.0.1</string></value></param><param><value><string>ChanServ</string></value></param><param><value><string>info</string></value></param><param><value><string>#channel</string></value></param></params></methodCall>
+    headers:
+      User-Agent:
+      - XMLRPC::Client (Ruby 2.0.0)
+      Content-Type:
+      - text/xml; charset=utf-8
+      Content-Length:
+      - '442'
+      Connection:
+      - keep-alive
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Atheme/7.0.5
+      Content-Type:
+      - text/xml
+      Content-Length:
+      - '476'
+    body:
+      encoding: UTF-8
+      string: "<?xml version=\"1.0\"?>\r\n<methodResponse>\r\n<params>\r\n <param>\r\n
+        \ <value>\r\n   <string>Information on #channel:\nFounder    : username\nSuccessor
+        \ : username_\nRegistered : Feb 08 15:09:32 2013 (8 weeks, 5 days, 08:03:27 ago)\nMode
+        lock  : +nstr\nURL        : http://example.com\nEmail      : username@example.com\nFlags
+        \     : VERBOSE RESTRICTED KEEPTOPIC TOPICLOCK GUARD FANTASY\nPrefix     :
+        . (default)\n*** End of Info ***</string>\r\n  </value>\r\n </param>\r\n</params>\r\n</methodResponse>"
+    http_version: 
+  recorded_at: Thu, 11 Apr 2013 07:14:07 GMT
+recorded_with: VCR 2.4.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atheme
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors:
 - James Newton
@@ -31,7 +31,7 @@ cert_chain:
   IdasO+EybhhmNT32weebimCM21ychbBqkWzJGPlIfqgvmOMbQc/TwQcwkYPgoX6l
   QdB79NrQet5m6RR7qA5joVvZhZA=
   -----END CERTIFICATE-----
-date: 2013-04-10 00:00:00.000000000 Z
+date: 2013-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -117,6 +117,34 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  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'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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 ruby wrapper around the Atheme IRC Services XMLRPC interface
 email:
 - james@Zaphyous.com
@@ -138,27 +166,25 @@ files:
 - lib/atheme/configuration.rb
 - lib/atheme/errors.rb
 - lib/atheme/objectified_hash.rb
+- lib/atheme/parser.rb
+- lib/atheme/parser_helper.rb
+- lib/atheme/parsers/chanserv.rb
 - lib/atheme/service.rb
-- lib/atheme/services/alis.rb
-- lib/atheme/services/chanserv.rb
-- lib/atheme/services/gameserv.rb
-- lib/atheme/services/global.rb
-- lib/atheme/services/groupserv.rb
-- lib/atheme/services/helpserv.rb
-- lib/atheme/services/hostserv.rb
-- lib/atheme/services/infoserv.rb
-- lib/atheme/services/memoserv.rb
-- lib/atheme/services/nickserv.rb
-- lib/atheme/services/operserv.rb
-- lib/atheme/services/rpgserv.rb
-- lib/atheme/services/statserv.rb
+- lib/atheme/support.rb
 - lib/atheme/version.rb
-- spec/config.yml.example
+- spec/config.yml
 - spec/lib/authenticate_spec.rb
 - spec/lib/configuration_spec.rb
+- spec/lib/parser_spec.rb
+- spec/lib/parsers/chanserv_spec.rb
 - spec/lib/service_spec.rb
 - spec/spec_helper.rb
-homepage: https://github.com/zaphyous/atheme
+- spec/vcr_cassettes/authenticate_error.yml
+- spec/vcr_cassettes/authenticate_success.yml
+- spec/vcr_cassettes/bad_service_command.yml
+- spec/vcr_cassettes/chanserv_help.yml
+- spec/vcr_cassettes/chanserv_info.yml
+homepage: https://github.com/zaphyous/atheme-ruby
 licenses:
 - MIT
 metadata: {}
@@ -184,8 +210,15 @@ specification_version: 4
 summary: atheme-ruby is an easy way to integrate your ruby application with the Atheme
   IRC Services XMLRPC interface
 test_files:
-- spec/config.yml.example
+- spec/config.yml
 - spec/lib/authenticate_spec.rb
 - spec/lib/configuration_spec.rb
+- spec/lib/parser_spec.rb
+- spec/lib/parsers/chanserv_spec.rb
 - spec/lib/service_spec.rb
 - spec/spec_helper.rb
+- spec/vcr_cassettes/authenticate_error.yml
+- spec/vcr_cassettes/authenticate_success.yml
+- spec/vcr_cassettes/bad_service_command.yml
+- spec/vcr_cassettes/chanserv_help.yml
+- spec/vcr_cassettes/chanserv_info.yml

data/lib/atheme/services/alis.rb

@@ -1,2 +0,0 @@
-class Atheme::ALIS < Atheme::Service
-end

data/lib/atheme/services/chanserv.rb

@@ -1,2 +0,0 @@
-class Atheme::ChanServ < Atheme::Service
-end

data/lib/atheme/services/gameserv.rb

@@ -1,2 +0,0 @@
-class Atheme::GameServ < Atheme::Service
-end

data/lib/atheme/services/global.rb

@@ -1,2 +0,0 @@
-class Atheme::Global < Atheme::Service
-end

data/lib/atheme/services/groupserv.rb

@@ -1,2 +0,0 @@
-class Atheme::GroupServ < Atheme::Service
-end

data/lib/atheme/services/helpserv.rb

@@ -1,2 +0,0 @@
-class Atheme::HelpServ < Atheme::Service
-end

data/lib/atheme/services/hostserv.rb

@@ -1,2 +0,0 @@
-class Atheme::HostServ < Atheme::Service
-end

data/lib/atheme/services/infoserv.rb

@@ -1,2 +0,0 @@
-class Atheme::InfoServ < Atheme::Service
-end

data/lib/atheme/services/memoserv.rb

@@ -1,2 +0,0 @@
-class Atheme::MemoServ < Atheme::Service
-end

data/lib/atheme/services/nickserv.rb

@@ -1,2 +0,0 @@
-class Atheme::NickServ < Atheme::Service
-end

data/lib/atheme/services/operserv.rb

@@ -1,2 +0,0 @@
-class Atheme::OperServ < Atheme::Service
-end

data/lib/atheme/services/rpgserv.rb

@@ -1,2 +0,0 @@
-class Atheme::RPGServ < Atheme::Service
-end

data/lib/atheme/services/statserv.rb

@@ -1,2 +0,0 @@
-class Atheme::StatServ < Atheme::Service
-end

data/spec/config.yml.example

@@ -1,10 +0,0 @@
-# Change this to your testing services xmlrpc information
-
-hostname: example.com
-port: 1234
-protocol: http
-
-nick: a_nick_that_exists
-password: the_nicks_password
-ip: 127.0.0.1
-