allplayers 0.1.0

data/README.md

@@ -0,0 +1,27 @@
+allplayers.rb
+=============
+
+AllPlayers.com ruby client  https://www.allplayers.com
+
+AllPlayer.com, Inc. Ruby client for importing users, groups, events, etc via
+REST API.
+
+Requires Ruby + Rubygems and the following:
+
+sudo apt-get install ruby libopenssl-ruby
+
+# nokogiri requirements
+sudo apt-get install libxslt-dev libxml2-dev
+
+# install bundler
+sudo gem install bundler
+
+# run bundler
+bundle install
+
+export APCI_REST_TEST_HOST=host.allplayers.com
+export APCI_REST_TEST_USER=user
+export APCI_REST_TEST_PASS=password
+
+then 'rake test'.
+

data/Rakefile

@@ -0,0 +1,53 @@
+# 
+# To change this template, choose Tools | Templates
+# and open the template in the editor.
+ 
+
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+require 'ci/reporter/rake/test_unit'
+require 'rspec/core/rake_task'
+require 'ci/reporter/rake/rspec'
+
+spec = Gem::Specification.new do |s|
+  s.name = 'allplayers-ruby-client'
+  s.version = '0.0.1'
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README', 'LICENSE']
+  s.summary = 'Your summary here'
+  s.description = s.summary
+  s.author = ''
+  s.email = ''
+  # s.executables = ['your_executable_here']
+  s.files = %w(LICENSE README Rakefile) + Dir.glob("{bin,lib,spec}/**/*")
+  s.require_path = "lib"
+  s.bindir = "bin"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+Rake::RDocTask.new do |rdoc|
+  files =['README', 'LICENSE', 'lib/**/*.rb']
+  rdoc.rdoc_files.add(files)
+  rdoc.main = "README" # page to start on
+  rdoc.title = "allplayers-ruby-client Docs"
+  rdoc.rdoc_dir = 'doc/rdoc' # rdoc output folder
+  rdoc.options << '--line-numbers'
+end
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*.rb']
+end
+
+RSpec::Core::RakeTask.new(:spec => ["ci:setup:rspec"]) do |t|
+  t.pattern = 'spec/*_spec.rb'
+end
+

data/allplayers.gemspec

@@ -0,0 +1,23 @@
+# encoding: utf-8
+Gem::Specification.new do |spec|
+  spec.add_dependency 'activesupport', ['2.3.10']
+  spec.add_dependency 'addressable', ['~> 2.2.7']
+  spec.add_dependency 'rake', ['~> 0.9.2.2']
+  spec.add_dependency 'rest-client', ['~> 1.6.7']
+  spec.add_dependency 'xml-simple', ['~> 1.1.1']
+  spec.add_development_dependency 'rspec'
+  spec.authors = ["AllPlayers.com"]
+  spec.description = %q{A Ruby interface to the AllPlayers API.}
+  spec.email = ['support@allplayers.com']
+  spec.files = %w(README.md Rakefile allplayers.gemspec)
+  spec.files += Dir.glob("lib/**/*.rb")
+  spec.files += Dir.glob("spec/**/*")
+  spec.homepage = 'http://www.allplayers.com/'
+  spec.licenses = ['MIT']
+  spec.name = 'allplayers'
+  spec.require_paths = ['lib']
+  spec.required_rubygems_version = Gem::Requirement.new('>= 1.3.6')
+  spec.summary = spec.description
+  spec.test_files = Dir.glob("spec/**/*")
+  spec.version = '0.1.0'
+end

data/lib/allplayers/api.rb

@@ -0,0 +1,42 @@
+require 'addressable/uri'
+require 'xmlsimple'
+require 'logger'
+require 'active_support/base64'
+require 'restclient'
+require 'allplayers/authentication'
+require 'allplayers/request'
+
+module AllPlayers
+  class API
+    include Request
+    include Authentication
+    attr_accessor :logger
+
+    def initialize(api_key = nil, server = 'sandbox.allplayers.com', protocol = 'https://', auth = 'session')
+      if (auth == 'session')
+        extend AllPlayers::Authentication
+      end
+      @base_uri = Addressable::URI.join(protocol + server, '')
+      @key = api_key # TODO - Not implemented in API yet.
+      @session_cookies = {}
+      @headers = {}
+    end
+
+    def log(target)
+      @log = target
+      RestClient.log = target
+    end
+
+    # Add header method, preferably use array of symbols, e.g. {:USER-AGENT => 'RubyClient'}.
+    def add_headers(header = {})
+      @headers.merge!(header) unless header.nil?
+    end
+
+    # Remove headers from a session.
+    def remove_headers(headers = {})
+      headers.each do |header, value|
+        @headers.delete(header)
+      end
+    end
+  end
+end

data/lib/allplayers/authentication.rb

@@ -0,0 +1,15 @@
+module AllPlayers
+  module Authentication
+    def login(name, pass)
+      begin
+        post 'users/login' , {:username => name, :password => pass}
+      end
+    end
+
+    def logout()
+      begin
+        post 'users/logout'
+      end
+    end
+  end
+end

data/lib/allplayers/client/events.rb

@@ -0,0 +1,19 @@
+module AllPlayers
+  module Events
+    def event_create(title, description, groups, date_start, date_end, more_params = {})
+      required_params = {
+        :groups => groups,
+        :title => title,
+        :description => description,
+        :date_time => {
+            :start => date_start,
+            :end => date_end,
+          }
+      }
+      response = post 'events', required_params.merge(more_params)
+    end
+    def event_update(uuid, update_params)
+      put 'events/'+uuid, update_params
+    end
+  end
+end

data/lib/allplayers/client/groups.rb

@@ -0,0 +1,45 @@
+module AllPlayers
+  module Groups
+    def group_create(title, description, location, categories, more_params = {})
+      required_params = {
+        :title => title,
+        :description => description,
+        :location => location,
+        :category => categories
+      }
+      post 'groups', required_params.merge(more_params)
+    end
+
+    def group_set_manager(group_uuid, user_uuid, remove_previous = false)
+      post 'groups/' + group_uuid.to_s + '/setmanager/' + user_uuid.to_s, {:remove_previous => remove_previous}
+    end
+
+    def group_clone(target_uuid, origin_uuid, groups_above_setting = nil)
+      post 'groups/' + target_uuid + '/copy/' + origin_uuid, {:groups_above => groups_above_setting}
+    end
+
+    def group_get(group_uuid)
+      get 'groups/' + group_uuid
+    end
+
+    def group_search(params = {})
+      get 'groups', params
+    end
+
+    def group_delete(group_uuid)
+      delete 'groups/' + group_uuid.to_s
+    end
+
+    def group_update(group_uuid, params = {})
+      put 'groups/' + group_uuid, params
+    end
+
+    def group_members_list(group_uuid, user_uuid = '', params = {})
+      get 'groups/' + group_uuid + '/members/' + user_uuid, params
+    end
+
+    def group_roles_list(group_uuid, user_uuid = '', params = {})
+      get 'groups/' + group_uuid + '/roles/' + user_uuid, params
+    end
+  end
+end

data/lib/allplayers/client/users.rb

@@ -0,0 +1,48 @@
+module AllPlayers
+  module Users
+    def user_create(email, firstname, lastname, birthday, gender, more_params = {})
+      required_params = {
+        :email => email,
+        :firstname => firstname,
+        :lastname => lastname,
+        :birthday => birthday,
+        :gender => gender,
+      }
+      post 'users', required_params.merge(more_params)
+    end
+
+    def user_get_email(email = nil)
+      get 'users', {:email => email} if !email.nil?
+    end
+
+    def user_get(uuid = nil)
+      get 'users/' + uuid.to_s() if !uuid.nil?
+    end
+
+    def user_children_list(uuid)
+      get 'users/' + uuid.to_s() + '/children'
+    end
+
+    def user_create_child(parent_uuid, firstname, lastname, birthday, gender, more_params = {})
+      required_params = {
+        :firstname => firstname,
+        :lastname => lastname,
+        :birthday => birthday,
+        :gender => gender,
+      }
+      post 'users/' + parent_uuid.to_s() + '/addchild', required_params.merge(more_params)
+    end
+
+    def user_groups_list(user_uuid, params = {})
+      get 'users/' + user_uuid + '/groups', params
+    end
+
+    def user_join_group(group_uuid, user_uuid, role_name = nil, options = {}, webform_ids = {})
+      post 'groups/' + group_uuid + '/join/' + user_uuid, {:org_webform_id => webform_ids, :role_name => role_name.to_s, :role_options => options}
+    end
+
+    def user_group_add_role(group_uuid, user_uuid, role_uuid, params = {})
+      post 'groups/' + group_uuid + '/addrole/' + user_uuid + '/' + role_uuid, params
+    end
+  end
+end

data/lib/allplayers/client.rb

@@ -0,0 +1,16 @@
+require 'allplayers/api'
+
+module AllPlayers
+  class Client < API
+    require 'rubygems'
+    require 'bundler/setup'
+    require 'restclient'
+    require 'addressable/uri'
+    require 'allplayers/client/events'
+    require 'allplayers/client/users'
+    require 'allplayers/client/groups'
+    include AllPlayers::Events
+    include AllPlayers::Users
+    include AllPlayers::Groups
+  end
+end

data/lib/allplayers/configuration.rb

@@ -0,0 +1,8 @@
+module AllPlayers
+  module Configuration
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+  end
+end

data/lib/allplayers/monkey_patches/rest_client.rb

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'restclient'
+
+# monkey patch RestClient to support custom timeouts.
+module RestClient
+
+  def self.get(url, headers={}, &block)
+    Request.execute(:method => :get, :url => url, :headers => headers, :timeout => @timeout, :open_timeout => @open_timeout, &block)
+  end
+
+  def self.post(url, payload, headers={}, &block)
+    Request.execute(:method => :post, :url => url, :payload => payload, :headers => headers, :timeout => @timeout, :open_timeout => @open_timeout, &block)
+  end
+
+  def self.put(url, payload, headers={}, &block)
+    Request.execute(:method => :put, :url => url, :payload => payload, :headers => headers, :timeout => @timeout, :open_timeout => @open_timeout, &block)
+  end
+
+  def self.delete(url, headers={}, &block)
+    Request.execute(:method => :delete, :url => url, :headers => headers, :timeout => @timeout, :open_timeout => @open_timeout, &block)
+  end
+
+  def self.head(url, headers={}, &block)
+    Request.execute(:method => :head, :url => url, :headers => headers, :timeout => @timeout, :open_timeout => @open_timeout, &block)
+  end
+
+  def self.options(url, headers={}, &block)
+    Request.execute(:method => :options, :url => url, :headers => headers, :timeout => @timeout, :open_timeout => @open_timeout, &block)
+  end
+
+  class << self
+    attr_accessor :timeout
+    attr_accessor :open_timeout
+  end
+end
+
+# monkey patch some pretty error messages into RestClient library exceptions.
+RestClient::STATUSES.each_pair do |code, message|
+  RestClient::Exceptions::EXCEPTIONS_MAP[code].send(:define_method, :message) {
+    response_error = ''
+    if !self.response.nil?
+        response_error = ' : ' + CGI::unescapeHTML(self.response.gsub(/<\/?[^>]*>/, " ").strip.gsub(/\r\n?/, ', ').squeeze(' '))
+    end
+    "#{http_code ? "#{http_code} " : ''}#{message}#{response_error}"
+  }
+end

data/lib/allplayers/request.rb

@@ -0,0 +1,54 @@
+module AllPlayers
+  module Request
+    # GET, PUT, POST, DELETE, etc.
+    def get(path, query = {}, headers = {})
+      # @TODO - cache here (HTTP Headers?)
+      request(:get, path, query, {}, headers)
+    end
+
+    def post(path, payload = {}, headers = {})
+      request(:post, path, {}, payload, headers)
+    end
+
+    def put(path, payload = {}, headers = {})
+      request(:put, path, {}, payload, headers)
+    end
+
+    def delete(path, headers = {})
+      request(:delete, path, {}, {}, headers)
+    end
+
+    private
+
+    # Perform an HTTP request
+    def request(verb, path, query = {}, payload = {}, headers = {})
+      begin
+        uri = Addressable::URI.join(@base_uri, 'api/v1/rest/'+path.to_s)
+        uri.query_values = query unless query.empty?
+        headers.merge!(@headers) unless @headers.empty?
+        RestClient.log = @log
+        RestClient.open_timeout = 600
+        RestClient.timeout = 600
+        if [:patch, :post, :put].include? verb
+          response = RestClient.send(verb, uri.to_s, payload, headers)
+        else
+          response = RestClient.send(verb, uri.to_s, headers)
+        end
+        # Had to remove any html tags before the xml because xmlsimple was reading the hmtl errors on pdup and was crashing.
+        return response unless response.net_http_res.body
+        xml_response =  '<?xml' + response.split("<?xml").last
+        html_response = response.split("<?xml").first
+        puts html_response if !html_response.empty?
+        # @TODO - There must be a way to change the base object (XML string to
+        #   Hash) while keeping the methods...
+        array_response = XmlSimple.xml_in(xml_response, { 'ForceArray' => ['item'] })
+        return array_response if array_response.empty? || array_response.include?('item') || array_response['item'].nil?
+        return array_response['item'].first if array_response['item'].length == 1
+        array_response['item']
+      rescue REXML::ParseException => xml_err
+        # XML Parser error
+        raise "Failed to parse server response."
+      end
+    end
+  end
+end

data/lib/allplayers.rb

@@ -0,0 +1,14 @@
+# Require minimal files needed for AllPlayers public API here.
+require 'allplayers/monkey_patches/rest_client'
+require 'allplayers/api'
+require 'allplayers/client'
+require 'allplayers/configuration'
+
+module AllPlayers
+  extend Configuration
+  class << self
+    def new(options={})
+      AllPlayers::Client.new(options)
+    end
+  end
+end

data/lib/helpers/http_encoding_helper.rb

@@ -0,0 +1,49 @@
+# Intended to extend the Net::HTTP response object
+# and adds support for decoding gzip and deflate encoded pages
+#
+# Author: Jason Stirk <http://griffin.oobleyboo.com>
+# Home: http://griffin.oobleyboo.com/projects/http_encoding_helper
+# Created: 5 September 2007
+# Last Updated: 23 November 2007
+#
+# Usage:
+#
+# require 'net/http'
+# require 'http_encoding_helper'
+# headers={'Accept-Encoding' => 'gzip, deflate' }
+# http = Net::HTTP.new('griffin.oobleyboo.com', 80)
+# http.start do |h|
+#   request = Net::HTTP::Get.new('/', headers)
+#   response = http.request(request)
+#   content=response.plain_body     # Method from our library
+#   puts "Transferred: #{response.body.length} bytes"
+#   puts "Compression: #{response['content-encoding']}"
+#   puts "Extracted: #{response.plain_body.length} bytes"
+# end
+#
+
+require 'zlib'
+require 'stringio'
+
+class Net::HTTPResponse
+  # Return the uncompressed content
+  def plain_body
+    encoding=self['content-encoding']
+    content=nil
+    if encoding then
+      case encoding
+        when 'gzip'
+          i=Zlib::GzipReader.new(StringIO.new(self.body))
+          content=i.read
+        when 'deflate'
+          i=Zlib::Inflate.new
+          content=i.inflate(self.body)
+        else
+          raise "Unknown encoding - #{encoding}"
+      end
+    else
+      content=self.body
+    end
+    return content
+  end
+end

data/spec/allplayers/api_spec.rb

@@ -0,0 +1,79 @@
+require 'helper'
+
+describe AllPlayers::API do
+  before do
+    def get_args
+      # If any environment variable set, skip argument handling.
+      if ENV.has_key?('APCI_REST_TEST_HOST')
+        $apci_rest_test_host = ENV['APCI_REST_TEST_HOST']
+        $apci_rest_test_user = ENV['APCI_REST_TEST_USER']
+        $apci_rest_test_pass = ENV['APCI_REST_TEST_PASS']
+        return
+      end
+
+      $apci_rest_test_user = Etc.getlogin if $apci_rest_test_user.nil?
+      $apci_rest_test_pass = nil if $apci_rest_test_pass.nil?
+
+      opts = GetoptLong.new(
+        [ '--help', '-h', GetoptLong::NO_ARGUMENT ],
+        [ '-p',       GetoptLong::REQUIRED_ARGUMENT]
+      )
+
+      opts.each do |opt, arg|
+        case opt
+          when '--help'
+            RDoc::usage
+          when '-p'
+            $apci_rest_test_pass = arg
+        end
+      end
+
+      RDoc::usage if $apci_rest_test_pass.nil?
+
+      # Handle default argument => host to target for import and optional user,
+      # (i.e. user@sandbox.allplayers.com).
+      if ARGV.length != 1
+        puts "No host argument, connecting to default host (try --help)"
+        $apci_rest_test_host = nil
+      else
+        host_user = ARGV.shift.split('@')
+        $apci_rest_test_user = host_user.shift if host_user.length > 1
+        $apci_rest_test_host = host_user[0]
+        puts 'Connecting to ' + $apci_rest_test_host
+      end
+    end
+    if $login_response.nil?
+      if $apci_rest_test_user.nil? || $apci_rest_test_pass.nil?
+        get_args
+      end
+
+      if $apci_session.nil?
+        $apci_session = AllPlayers::Client.new(nil, $apci_rest_test_host)
+      end
+
+      # End arguments
+
+      # TODO - Log only with argument (-l)?
+      # Make a folder for some logs!
+      path = Dir.pwd + '/test_logs'
+      begin
+        FileUtils.mkdir(path)
+      rescue
+        # Do nothing, it's already there?  Perhaps catch a more specific error?
+      ensure
+        logger = Logger.new(path + '/test.log', 'daily')
+        logger.level = Logger::DEBUG
+        logger.info('initialize') { "Initializing..." }
+        $apci_session.log(logger)
+      end
+
+      # Account shouldn't be hard coded!
+      $login_response = $apci_session.login($apci_rest_test_user, $apci_rest_test_pass)
+    end
+    $apci_session = $apci_session
+  end
+  it "should return a valid session." do
+    $apci_session.should_not == nil
+  end
+
+end

data/spec/allplayers/client/events_spec.rb

@@ -0,0 +1,53 @@
+require 'helper'
+
+describe AllPlayers::Client do
+  describe "Event" do
+    before :all do
+      # Create Group.
+      $group_title = (0...8).map{65.+(rand(25)).chr}.join
+      more_params = {}
+      $location = {
+        :street => '122 Main ',
+        :city => 'Lewisville',
+        :state => 'TX',
+        :zip => '75067',
+      }
+      $group = $apci_session.group_create(
+        $group_title,
+        'This is a test group generated by event_spec.rb',
+        $location,
+        ['Sports', 'Baseball'],
+        more_params
+      )
+      
+      # Create Event.
+      $event_title = (0...8).map{65.+(rand(25)).chr}.join
+      more_params = {}
+      $event = $apci_session.event_create(
+        $event_title,
+        'This is a test event generated by event_spec.rb',
+        $group['uuid'],
+        '2012-09-15T08:05:00', # Generic Date
+        '2012-09-15T09:05:00',
+        more_params = {}
+      )
+    end
+
+    it "should be created properly." do
+      $event['title'].should == $event_title
+      $event['groups']['item'].should include($group['uuid'])
+    end
+
+    it "should be able to update" do
+      updated_description = 'This is a test event updated by event_spec.rb'
+      update_params = {
+        :description => updated_description
+      }
+      event = $apci_session.event_update(
+        $event['uuid'],
+        update_params
+      )
+      event['description'].should == updated_description
+    end
+  end
+end

data/spec/allplayers/client/groups_spec.rb

@@ -0,0 +1,80 @@
+require 'helper'
+
+describe AllPlayers::Client do
+  describe "Group" do
+    before :all do
+      # Create Group.
+      $random_title = (0...8).map{65.+(rand(25)).chr}.join
+      more_params = {}
+      $location = {
+        :street => '122 Main ',
+        :additional => 'Suite 303',
+        :city => 'Lewisville',
+        :province => 'TX',  # <-- Test Breaker!
+        :zip => '75067',
+        :country => 'us',
+      }
+      $group = $apci_session.group_create(
+        $random_title,
+        'This is a test group generated by group_spec.rb',
+        $location,
+        ['Sports', 'Baseball'],
+        more_params
+      )
+
+      # Create User.
+      $birthday = Date.new(1983,5,23)
+      $random_first = (0...8).map{65.+(rand(25)).chr}.join
+      $user = $apci_session.user_create(
+        $random_first + '@example.com',
+        $random_first,
+        'FakeLast',
+        $birthday,
+        'Male'
+      )
+      # User Join Group.
+      $apci_session.user_join_group($group['uuid'], $user['uuid'], 'Player')
+      $users = $apci_session.group_members_list($group['uuid'])
+      $users_uuids = []
+      $users['item'].each do | user |
+        $users_uuids.push(user['uuid'])
+      end
+
+      # User's Groups
+      $groups = $apci_session.user_groups_list($user['uuid'])
+
+      # Group Roles
+      $roles = $apci_session.group_roles_list($group['uuid'])
+      $roles.each do | uuid, role |
+        $role = uuid.dup if role['name'] == 'Fan'
+      end
+      $role[0] = ''
+    end
+
+    it "should be created properly." do
+      $group['uuid'].should_not == nil
+      group = $apci_session.group_get($group['uuid'])
+      group['title'].should == $random_title
+    end
+
+    it "should list users." do
+      $users['item'].first['uri'].should include($group['uuid'].to_s)
+      $users['item'].first['uuid'].should_not == nil
+    end
+
+    describe "User" do
+      it "should be able to join group." do
+        $users_uuids.include?($user['uuid'].to_s).should == true
+      end
+
+      it "should list groups." do
+        $groups['item'].first['uuid'].should == $group['uuid']
+      end
+
+      it "should be able to have a role assigned in a group." do
+        response = $apci_session.user_group_add_role($group['uuid'], $user['uuid'], $role)
+        ['1'].include?(response).should == TRUE
+      end
+    end
+  end
+end

data/spec/allplayers/client/users_spec.rb

@@ -0,0 +1,101 @@
+require 'helper'
+
+describe AllPlayers::Client do
+  describe "User" do
+    before :all do
+      # Create User.
+      $birthday = Date.new(1983,5,23)
+      $random_first = (0...8).map{65.+(rand(25)).chr}.join
+      $user = $apci_session.user_create(
+        $random_first + '@example.com',
+        $random_first,
+        'FakeLast',
+        $birthday,
+        'Male'
+      )
+    end
+
+    it "should be created properly." do
+      # Check user get response.
+      user = $apci_session.user_get($user['uuid'])
+      # Check mail.
+      user['email'].should == $random_first + '@example.com'
+      # Check username.
+      user['username'].should == $random_first + ' FakeLast'
+    end
+
+    describe "Child" do
+      it "should be created properly." do
+        random_first = (0...8).map{65.+(rand(25)).chr}.join
+        more_params = {
+          :email => random_first + '@example.com',
+        }
+        birthday = Date.new(2004,5,23)
+        $child = $apci_session.user_create_child(
+          $user['uuid'],
+          random_first,
+          'FakeLast',
+          birthday,
+          'm',
+          more_params
+        )
+        $child['uuid'].should_not == nil
+
+        # Get children from parent.
+        children = $apci_session.user_children_list($user['uuid'])
+        child_uuid = children['item'].first['uuid']
+
+        # Verify parent child relationship.
+        child_uuid.should == $child['uuid']
+
+        # Check email.
+        $child['email'].should == random_first + '@example.com'
+
+        # Check calculated username is only first.
+        $child['nickname'].should == random_first
+
+        # Check name.
+        $child['firstname'].should == random_first
+        $child['lastname'].should == 'FakeLast'
+
+        # Check gender.
+        $child['gender'].should == 'male'
+      end
+
+      it "should be created properly using an AllPlayers.net email." do
+        random_first = (0...8).map{65.+(rand(25)).chr}.join
+        birthday = '2004-05-21'
+        more_params = {}
+        $child = $apci_session.user_create_child(
+          $user['uuid'],
+          random_first,
+          'FakeLast',
+          birthday,
+          'm',
+          more_params
+        )
+        $child['uuid'].should_not == nil
+
+        # Get children from parent.
+        children = $apci_session.user_children_list($user['uuid'])
+        child_uuid = children['item'].last['uuid']
+
+        # Verify parent child relationship.
+        child_uuid.should == $child['uuid']
+
+        # Check email.
+        $child['email'].should == random_first + 'FakeLast@allplayers.net'
+
+        # Check calculated username is only first.
+        $child['nickname'].should == random_first
+
+        # Check name.
+        $child['firstname'].should == random_first
+        $child['lastname'].should == 'FakeLast'
+
+        # Check gender.
+        $child['gender'].should == 'male'
+      end
+    end
+  end
+end

data/spec/allplayers/start_apci_session.rb

@@ -0,0 +1,75 @@
+RSpec.configure do |c|
+  c.treat_symbols_as_metadata_keys_with_true_values = true
+  c.before(:all) {
+    def get_args
+      # If any environment variable set, skip argument handling.
+      if ENV.has_key?('APCI_REST_TEST_HOST')
+        $apci_rest_test_host = ENV['APCI_REST_TEST_HOST']
+        $apci_rest_test_user = ENV['APCI_REST_TEST_USER']
+        $apci_rest_test_pass = ENV['APCI_REST_TEST_PASS']
+        $ssl_check = ENV['SSL_CHECK']
+        return
+      end
+
+      $apci_rest_test_user = Etc.getlogin if $apci_rest_test_user.nil?
+      $apci_rest_test_pass = nil if $apci_rest_test_pass.nil?
+
+      opts = GetoptLong.new(
+        [ '--help', '-h', GetoptLong::NO_ARGUMENT ],
+        [ '-p',       GetoptLong::REQUIRED_ARGUMENT]
+      )
+
+      opts.each do |opt, arg|
+        case opt
+          when '--help'
+            RDoc::usage
+          when '-p'
+            $apci_rest_test_pass = arg
+        end
+      end
+
+      RDoc::usage if $apci_rest_test_pass.nil?
+
+      # Handle default argument => host to target for import and optional user,
+      # (i.e. user@sandbox.allplayers.com).
+      if ARGV.length != 1
+        puts "No host argument, connecting to default host (try --help)"
+        $apci_rest_test_host = nil
+      else
+        host_user = ARGV.shift.split('@')
+        $apci_rest_test_user = host_user.shift if host_user.length > 1
+        $apci_rest_test_host = host_user[0]
+        puts 'Connecting to ' + $apci_rest_test_host
+      end
+    end
+    if $login_response.nil?
+      if $apci_rest_test_user.nil? || $apci_rest_test_pass.nil?
+        get_args
+      end
+
+      if $apci_session.nil?
+        $apci_session = AllPlayers::Client.new(nil, $apci_rest_test_host)
+      end
+
+      # End arguments
+
+      # TODO - Log only with argument (-l)?
+      # Make a folder for some logs!
+      path = Dir.pwd + '/test_logs'
+      begin
+        FileUtils.mkdir(path)
+      rescue
+        # Do nothing, it's already there?  Perhaps catch a more specific error?
+      ensure
+        logger = Logger.new(path + '/test.log', 'daily')
+        logger.level = Logger::DEBUG
+        logger.info('initialize') { "Initializing..." }
+        $apci_session.log(logger)
+      end
+
+      # Account shouldn't be hard coded!
+      $login_response = $apci_session.login($apci_rest_test_user, $apci_rest_test_pass)
+    end
+    $apci_session = $apci_session
+  }
+end

data/spec/allplayers_spec.rb

@@ -0,0 +1,14 @@
+require 'helper'
+require 'allplayers/start_apci_session'
+require 'allplayers/api_spec'
+require 'allplayers/client/users_spec'
+require 'allplayers/client/groups_spec'
+require 'allplayers/client/events_spec'
+
+describe AllPlayers do
+  describe "New" do
+    it "should return an Allplayers::Client." do
+      AllPlayers.new.should be_a AllPlayers::Client
+    end
+  end
+end

data/spec/helper.rb

@@ -0,0 +1,13 @@
+$:.unshift File.join(File.dirname(__FILE__),'..','lib')
+
+require 'open-uri'
+require 'allplayers/client'
+require 'allplayers'
+require 'apci_field_mapping'
+require 'getoptlong'
+require 'rdoc/usage'
+require 'logger'
+require 'etc'
+require 'date'
+require 'rspec'
+require 'net/https'

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification 
+name: allplayers
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- AllPlayers.com
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-01-16 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 2
+        - 3
+        - 10
+        version: 2.3.10
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: addressable
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 2
+        - 7
+        version: 2.2.7
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 0
+        - 9
+        - 2
+        - 2
+        version: 0.9.2.2
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 1
+        - 6
+        - 7
+        version: 1.6.7
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: xml-simple
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 1
+        - 1
+        - 1
+        version: 1.1.1
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id006
+description: A Ruby interface to the AllPlayers API.
+email: 
+- support@allplayers.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- Rakefile
+- allplayers.gemspec
+- lib/allplayers/api.rb
+- lib/allplayers/authentication.rb
+- lib/allplayers/client/events.rb
+- lib/allplayers/client/groups.rb
+- lib/allplayers/client/users.rb
+- lib/allplayers/client.rb
+- lib/allplayers/configuration.rb
+- lib/allplayers/monkey_patches/rest_client.rb
+- lib/allplayers/request.rb
+- lib/allplayers.rb
+- lib/helpers/http_encoding_helper.rb
+- spec/allplayers/api_spec.rb
+- spec/allplayers/client/events_spec.rb
+- spec/allplayers/client/groups_spec.rb
+- spec/allplayers/client/users_spec.rb
+- spec/allplayers/start_apci_session.rb
+- spec/allplayers_spec.rb
+- spec/helper.rb
+homepage: http://www.allplayers.com/
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A Ruby interface to the AllPlayers API.
+test_files: 
+- spec/allplayers/api_spec.rb
+- spec/allplayers/client/events_spec.rb
+- spec/allplayers/client/groups_spec.rb
+- spec/allplayers/client/users_spec.rb
+- spec/allplayers/start_apci_session.rb
+- spec/allplayers_spec.rb
+- spec/helper.rb