civicrm 1.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+/pkg
+.rvmrc

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0

data/CONTRIBUTORS

@@ -0,0 +1 @@
+Iskander Haziev <gvalmon@gmail.com>

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/Gemfile.lock

@@ -0,0 +1,47 @@
+PATH
+  remote: .
+  specs:
+    civicrm (1.0.1)
+      activemodel
+      activesupport
+      nokogiri
+      rest-client (~> 1.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (3.2.13)
+      activesupport (= 3.2.13)
+      builder (~> 3.0.0)
+    activesupport (3.2.13)
+      i18n (= 0.6.1)
+      multi_json (~> 1.0)
+    builder (3.0.4)
+    diff-lcs (1.2.1)
+    i18n (0.6.1)
+    metaclass (0.0.1)
+    mime-types (1.22)
+    mocha (0.10.5)
+      metaclass (~> 0.0.1)
+    multi_json (1.7.2)
+    nokogiri (1.5.9)
+    rake (10.0.3)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  civicrm!
+  mocha
+  rake
+  rspec

data/History.txt

@@ -0,0 +1,11 @@
+=== 1.0 2013-04-8
+
+* 1 major enhancement:
+  * Initial release
+
+=== 1.1 2013-05-8
+
+* 3 minor enhancements:
+  * Fix gem specs
+  * added CiviCrm::XML.encode method
+  * CiviCrm::Client.request not accepts only 2 params, "path" option is removed

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2013 CiviCrm.com. (https://civicrm.com)
+
+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,31 @@
+## Installation
+
+* $ gem install civicrm
+
+## Getting started
+
+```ruby
+* CiviCrm.site_key = 'YOUR_SITE_KEY'
+* // More info about site_key:
+* // http://wiki.civicrm.org/confluence/display/CRMDOC43/Managing+Scheduled+Jobs
+* CiviCrm.api_base = 'https://www.example.org/path/to/civi/codebase/'
+* CiviCrm.authenticate('demo', 'demo')
+```
+
+## CiviCrm Objects
+
+```ruby
+* CiviCrm::Contact.all    # get list of contacts
+* CiviCrm::Contact.create(contact_type: 'Organization', organization_name: 'test') # create contact
+* CiviCrm::Contact.find(1).delete      # find and delete
+```
+
+## Testing
+```
+rspec spec
+```
+
+## Useful links
+
+* http://wiki.civicrm.org/confluence/display/CRMDOC43/REST+interface
+* http://drupal.demo.civicrm.org/civicrm/api/explorer

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake'
+require 'rspec/core/rake_task'
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = %w[--color]
+end
+
+task :default => [:spec]

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/bin/civicrm

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/civicrm'}"
+puts "Loading CiviCrm gem"
+exec "#{irb} #{libs} --simple-prompt"

data/civicrm.gemspec

@@ -0,0 +1,29 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'civicrm/version'
+
+spec = Gem::Specification.new do |s|
+  s.name = 'civicrm'
+  s.version = CiviCrm::VERSION
+  s.summary = 'Ruby bindings for the CiviCRM API'
+  s.description = 'See http://civicrm.org for details.'
+  s.authors = ['Iskander Haziev']
+  s.email = ['gvalmon@gmail.com']
+  s.homepage = 'http://civicrm.org'
+  s.executables = 'civicrm'
+  s.require_paths = %w{lib}
+
+  s.add_dependency('rest-client', '~> 1.4')
+  s.add_dependency('activesupport')
+  s.add_dependency('activemodel')
+  s.add_dependency('nokogiri')
+
+  s.add_development_dependency('rake')
+  s.add_development_dependency('rspec')
+  s.add_development_dependency('mocha')
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- test/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+end

data/lib/civicrm.rb

@@ -0,0 +1,47 @@
+require 'active_support/deprecation'
+require 'active_support/core_ext/module'
+require 'active_support/core_ext/hash'
+require 'active_support/inflector'
+require 'rest-client'
+require 'nokogiri'
+
+# utils
+require 'civicrm/client'
+require 'civicrm/xml'
+require 'civicrm/resource'
+require 'civicrm/version'
+
+# actions
+require 'civicrm/actions/list'
+require 'civicrm/actions/create'
+require 'civicrm/actions/update'
+require 'civicrm/actions/destroy'
+require 'civicrm/actions/find'
+
+# exceptions
+require 'civicrm/errors'
+
+# resources
+require 'civicrm/resources/base'
+
+module CiviCrm
+  @@api_key = nil
+  @@site_key = nil
+  @@api_base = 'https://www.example.org/path/to/civi/codebase'
+  @@api_version = 'v3'
+  @@user_authenticated = false
+
+  mattr_accessor :api_key, :api_base, :api_version, :site_key
+
+  def self.api_url(path = '')
+    base = "#{api_base}/civicrm/extern/rest.php?#{path}"
+    base += "&api_key=#{@@api_key}" if @@api_key
+    base += "&key=#{@@site_key}" if @@site_key
+    base
+  end
+
+  def self.authenticate(name, password)
+    auth = Client.request(:post, q: 'civicrm/login', name: name, pass: password)
+    @@api_key = auth[0]['api_key']
+  end
+end

data/lib/civicrm/actions/create.rb

@@ -0,0 +1,17 @@
+module CiviCrm
+  module Actions
+    module Create
+      module ClassMethods
+        def create(attrs = {})
+          params = {'entity' => entity_class_name, 'action' => 'create'}
+          response = CiviCrm::Client.request(:post, params.merge(attrs))
+          Resource.build_from(response.first, params)
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/civicrm/actions/destroy.rb

@@ -0,0 +1,11 @@
+module CiviCrm
+  module Actions
+    module Destroy
+      def delete
+        params = {'entity' => self.class.entity_class_name, 'action' => 'delete', 'id' => id}
+        response = CiviCrm::Client.request(:post, params)
+        refresh_from(response.first.to_hash)
+      end
+    end
+  end
+end

data/lib/civicrm/actions/find.rb

@@ -0,0 +1,17 @@
+module CiviCrm
+  module Actions
+    module Find
+      module ClassMethods
+        def find(id)
+          params = {'entity' => entity_class_name, 'action' => 'getsingle', 'id' => id}
+          response = CiviCrm::Client.request(:get, params)
+          Resource.build_from(response.first, params)
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/civicrm/actions/list.rb

@@ -0,0 +1,29 @@
+module CiviCrm
+  module Actions
+    module List
+      module ClassMethods
+        def all(params = {})
+          params.merge!('entity' => entity_class_name, 'action' => 'get')
+          response = CiviCrm::Client.request(:get, params)
+          Resource.build_from(response, params)
+        end
+
+        def count
+          all.count
+        end
+
+        def first
+          all.first
+        end
+
+        def last
+          all.last
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/civicrm/actions/update.rb

@@ -0,0 +1,19 @@
+module CiviCrm
+  module Actions
+    module Update
+      # TODO: this method doesn't work yet
+      def update(attrs = {})
+        params = {'entity' => self.class.entity_class_name, 'action' => 'replace', 'id' => id}
+        new_attrs = attributes.merge(attrs)
+        response = CiviCrm::Client.request(:post, params.merge(values: new_attrs))
+        refresh_from(response.first.to_hash)
+      end
+
+      def save
+        @previously_changed = changes
+        @changed_attributes.clear
+        update()
+      end
+    end
+  end
+end

data/lib/civicrm/client.rb

@@ -0,0 +1,70 @@
+module CiviCrm
+  class Client
+    class << self
+
+      # Returns parsed class inherited from CiviCrm::Resource
+      def request(method, params = {})
+        unless CiviCrm.site_key
+          raise CiviCrm::Errors::Unauthorized, "Please specify CiviCrm.site_key"
+        end
+        headers = {
+          :user_agent => "CiviCrm RubyClient/#{CiviCrm::VERSION}"
+        }
+
+        opts = {
+          :method => method,
+          :timeout => 80,
+          :headers => headers
+        }
+
+        # build params
+        case method.to_s.downcase.to_sym
+        when :get, :head, :delete
+          path = params.count > 0 ? stringify_params(params) : ''
+        else
+          opts[:payload] = stringify_params(params)
+        end
+        opts[:url] = CiviCrm.api_url(path)
+        response = execute(opts)
+        body, code = response.body, response.code
+        CiviCrm::XML.parse(body)
+      end
+
+      def execute(opts)
+        RestClient::Request.execute(opts)
+      rescue RuntimeError => e
+        case e.http_code.to_i
+        when 400
+          raise CiviCrm::Errors::BadRequest, e.http_body
+        when 401
+          raise CiviCrm::Errors::Unauthorized, e.http_body
+        when 403
+          raise CiviCrm::Errors::Forbidden, e.http_body
+        when 404
+          raise CiviCrm::Errors::NotFound, e.http_body
+        when 500
+          raise CiviCrm::Errors::InternalError, e.http_body
+        else
+          raise e
+        end
+      end
+
+      def uri_escape(key)
+        URI.escape(key.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
+      end
+
+      def flatten_params(params, parent_key = nil)
+        result = []
+        params.each do |key, value|
+          flatten_key = parent_key ? "#{parent_key}[#{uri_escape(key)}]" : uri_escape(key)
+          result += value.is_a?(Hash) ? flatten_params(value, flatten_key) : [[flatten_key, value]]
+        end
+        result
+      end
+
+      def stringify_params(params)
+        flatten_params(params).collect{|key, value| "#{key}=#{uri_escape(value)}"}.join('&')
+      end
+    end
+  end
+end

data/lib/civicrm/errors.rb

@@ -0,0 +1,9 @@
+module CiviCrm
+  module Errors
+    class Unauthorized < Exception; end;
+    class InternalError < Exception; end;
+    class Forbidden < Exception; end;
+    class BadRequest < Exception; end;
+    class NotFound < Exception; end;
+  end
+end

data/lib/civicrm/resource.rb

@@ -0,0 +1,84 @@
+require 'active_model/dirty'
+module CiviCrm
+  class Resource
+    include ActiveModel::Dirty
+    class_attribute :entity_name
+
+    def initialize(values = {})
+      @values = {}
+      @id = values['id'] if values['id']
+      refresh_from(values)
+      self.class.define_attribute_methods(attributes.keys)
+    end
+
+    # we will use this method for creating nested resources
+    def refresh_from(values)
+      values.each do |key, value|
+        @values[key] = value
+      end
+    end
+
+    def to_s(*opts)
+      @values.to_json
+    end
+
+    def inspect
+      id_string = !@id.nil? ? " id=#{@id}" : ""
+      "#<#{self.class}:0x#{self.object_id.to_s(16)}#{id_string}> #{attributes}"
+    end
+
+    def method_missing(name, *opts)
+      if name[-1] == '='
+        name = name.to_s.gsub(/\=$/, '')
+        send(:"#{name}_will_change!")
+        @values[name.to_s] = opts.first if @values.has_key?(name.to_s)
+      else
+        @values[name.to_s] if @values.has_key?(name.to_s)
+      end
+    end
+
+    def to_json(*opts)
+      CiviCrm::JSON.encode(@values)
+    end
+
+    def as_json(*opts)
+      @values.as_json(*a)
+    end
+
+    def to_hash
+      @values
+    end
+
+    def attributes
+      to_hash.reject{ |k, v| v.is_a? (CiviCrm::Resource)}
+    end
+
+    def attribute(key)
+      to_hash[key]
+    end
+
+    class << self
+      def entity(name = nil)
+        self.entity_name = name
+      end
+
+      def entity_class_name
+        self.entity_name.to_s.classify
+      end
+
+      def build_from(resp, request_params = {})
+        entity = request_params['entity']
+        case resp
+        when Array
+          resp.map { |values| build_from(values, request_params) }
+        when Hash
+          klass = "CiviCrm::#{entity.classify}".constantize
+          resource = klass.new(resp)
+          resource
+        else
+          resp
+        end
+      end
+    end
+  end
+end

data/lib/civicrm/resources/base.rb

@@ -0,0 +1,140 @@
+module CiviCrm
+  class BaseResource < CiviCrm::Resource
+    include CiviCrm::Actions::List
+    include CiviCrm::Actions::Find
+    include CiviCrm::Actions::Create
+    include CiviCrm::Actions::Update
+    include CiviCrm::Actions::Destroy
+  end
+end
+module CiviCrm
+  class Activity < BaseResource
+    entity :activity
+  end
+  class ActivityType < BaseResource
+    entity :activity_type
+  end
+  class Address < BaseResource
+    entity :address
+  end
+  class Batch < BaseResource
+    entity :batch
+  end
+  class Campaign < BaseResource
+    entity :campaign
+  end
+  class Case < BaseResource
+    entity :case
+  end
+  class Constant < BaseResource
+    entity :constant
+  end
+  class Contact < BaseResource
+    entity :contact
+  end
+  class ContactType < BaseResource
+    entity :contact_type
+  end
+  class Contribution < BaseResource
+    entity :contribution
+  end
+  class ContributionPage < BaseResource
+    entity :contribution_page
+  end
+  class ContributionRecur < BaseResource
+    entity :contribution_recur
+  end
+  class CustomField < BaseResource
+    entity :custom_field
+  end
+  class CustomGroup < BaseResource
+    entity :custom_group
+  end
+  class CustomSearch < BaseResource
+    entity :custom_search
+  end
+  class CustomValue < BaseResource
+    entity :custom_value
+  end
+  class Domain < BaseResource
+    entity :domain
+  end
+  class Email < BaseResource
+    entity :email
+  end
+  class Entity < BaseResource
+    entity :entity
+  end
+  class EntityTag < BaseResource
+    entity :entity_tag
+  end
+  class Event < BaseResource
+    entity :event
+  end
+  class Extension < BaseResource
+    entity :extension
+  end
+  class File < BaseResource
+    entity :file
+  end
+  class Grant < BaseResource
+    entity :grant
+  end
+  class Group < BaseResource
+    entity :group
+  end
+  class GroupContact < BaseResource
+    entity :group_contact
+  end
+  class GroupNesting < BaseResource
+    entity :group_nesting
+  end
+  class GroupOrganization < BaseResource
+    entity :group_organization
+  end
+  class Im < BaseResource
+    entity :im
+  end
+  class Job < BaseResource
+    entity :job
+  end
+  class LineItem < BaseResource
+    entity :line_item
+  end
+  class LocBlock < BaseResource
+    entity :loc_block
+  end
+  class Location < BaseResource
+    entity :location
+  end
+  class LocationType < BaseResource
+    entity :location_type
+  end
+  class MailSettings < BaseResource
+    entity :mail_settings
+  end
+  class Mailing < BaseResource
+    entity :mailing
+  end
+  class Membership < BaseResource
+    entity :membership
+  end
+  class Note < BaseResource
+    entity :note
+  end
+  class Phone < BaseResource
+    entity :phone
+  end
+  class Profile < BaseResource
+    entity :profile
+  end
+  class Setting < BaseResource
+    entity :setting
+  end
+  class Survey < BaseResource
+    entity :survey
+  end
+  class SurveyRespondant < BaseResource
+    entity :survey_respondant
+  end
+end

data/lib/civicrm/version.rb

@@ -0,0 +1,3 @@
+module CiviCrm
+  VERSION = '1.0.1'
+end

data/lib/civicrm/xml.rb

@@ -0,0 +1,33 @@
+module CiviCrm
+  class XML
+    class << self
+      def parse(text)
+        doc = Nokogiri::XML.parse(text.to_s.gsub("\n", ''))
+        results = doc.xpath('//Result')
+        results.map do |result|
+          hash = {}
+          result.children.each do |attribute|
+            next unless attribute.is_a?(Nokogiri::XML::Element)
+            hash[attribute.name] = attribute.children[0].text rescue nil
+          end
+          hash
+        end
+      end
+      def encode(resources)
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.ResultSet do
+            Array.wrap(resources).each do |resource|
+              attributes = resource.respond_to?(:attributes) ? resource.attributes : resource
+              xml.Result do
+                attributes.each do |key, value|
+                  xml.send key.to_sym, value
+                end
+              end
+            end
+          end
+        end
+        builder.to_xml
+      end
+    end
+  end
+end

data/spec/requests/base_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+require 'rest_client'
+require 'ostruct'
+describe "API Bindings" do
+
+  before :all do
+    @client = authorized_civicrm_client
+  end
+
+  it "should not fetch from network while initializing a new Resource" do
+    @client.expects(:get).never
+    CiviCrm::Contact.new(id: "someid")
+  end
+
+  it "should run authentication" do
+    @client.expects(:post).once.returns(test_response(api_key: 'test'))
+    CiviCrm.authenticate("test", "test")
+  end
+
+  describe "exception handler" do
+
+    before :all do
+      @client = CiviCrm::Client
+    end
+
+    it "should raise CiviCrm::Errors::BadRequest on 400" do
+      exception = RestClient::Exception.new(OpenStruct.new(code: 400, body: 'message'))
+      RestClient::Request.stubs(:execute).raises(exception)
+      expect { @client.execute!({}) }.to raise_error(CiviCrm::Errors::BadRequest)
+    end
+
+    it "should raise CiviCrm::Errors::Unauthorized on 401" do
+      exception = RestClient::Exception.new(OpenStruct.new(code: 401, body: 'message'))
+      RestClient::Request.stubs(:execute).raises(exception)
+      expect { @client.execute!({}) }.to raise_error(CiviCrm::Errors::Unauthorized)
+    end
+
+    it "should raise CiviCrm::Errors::Forbidden on 403" do
+      exception = RestClient::Exception.new(OpenStruct.new(code: 403, body: 'message'))
+      RestClient::Request.stubs(:execute).raises(exception)
+      expect { @client.execute!({}) }.to raise_error(CiviCrm::Errors::Forbidden)
+    end
+
+    it "should raise CiviCrm::Errors::NotFound on 404" do
+      exception = RestClient::Exception.new(OpenStruct.new(code: 404, body: 'message'))
+      RestClient::Request.stubs(:execute).raises(exception)
+      expect { @client.execute!({}) }.to raise_error(CiviCrm::Errors::NotFound)
+    end
+
+    it "should raise CiviCrm::Errors::InternalError on 500" do
+      exception = RestClient::Exception.new(OpenStruct.new(code: 500, body: 'message'))
+      RestClient::Request.stubs(:execute).raises(exception)
+      expect { @client.execute!({}) }.to raise_error(CiviCrm::Errors::InternalError)
+    end
+
+    it "should raise CiviCrm::Errors::Unauthorized if site_key is not provided" do
+      CiviCrm.site_key = nil
+      RestClient::Request.stubs(:execute).returns('test')
+      expect { @client.request('get', 'test') }.to raise_error(CiviCrm::Errors::Unauthorized)
+    end
+  end
+end

data/spec/resources/contact_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+describe CiviCrm::Contact do
+  it { should be_listable_resource }
+  #it { should be_updatable_resource }
+
+  it "should return contact on create" do
+    client = authorized_civicrm_client
+
+    client.expects(:post).once.returns(test_response(test_contact))
+    c = CiviCrm::Contact.create
+    c.should be_a_kind_of(CiviCrm::Contact)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'civicrm'
+require 'support/civicrm'
+require 'support/civicrm_responses'
+require 'support/test_matchers'
+RSpec.configure do |config|
+  include CiviCrm::TestResponses
+  config.mock_with :mocha
+end

data/spec/support/civicrm.rb

@@ -0,0 +1,27 @@
+module CiviCrm
+  class Client
+    class << self
+      @mock_rest_client = nil
+      def mock_rest_client(mock_client)
+        @mock_rest_client = mock_client
+      end
+
+      alias_method :execute!, :execute
+      def execute(opts)
+        get_params = (opts[:headers] || {})[:params]
+        post_params = opts[:payload]
+        case opts[:method]
+        when :get then @mock_rest_client.get opts[:url], get_params, post_params
+        when :post then @mock_rest_client.post opts[:url], get_params, post_params
+        when :put then @mock_rest_client.put opts[:url], get_params, post_params
+        when :delete then @mock_rest_client.delete opts[:url], get_params, post_params
+        end
+      end
+    end
+  end
+end
+def authorized_civicrm_client
+  CiviCrm.api_key = 'civicrm'
+  CiviCrm.site_key = 'civicrm'
+  CiviCrm::Client.mock_rest_client(mock)
+end

data/spec/support/civicrm_responses.rb

@@ -0,0 +1,31 @@
+ module CiviCrm::TestResponses
+  def test_response(body, code = 200)
+    body = CiviCrm::XML.encode(body) if !(body.kind_of? String)
+    m = mock
+    m.instance_variable_set('@data', { body: body, code: code})
+    def m.body; @data[:body]; end
+    def m.code; @data[:code]; end
+    m
+  end
+
+  def test_contact(params = {})
+    {
+      :id => '1',
+      :contact_id => '1',
+      :contact_type => 'Organization',
+      :sort_name => 'Inner City Arts',
+      :display_name => 'Inner City Arts',
+      :name => 'Bruce Lee',
+      :description => 'Foo bar',
+      :created => '1345537759',
+      :livemode => false
+    }.merge(params)
+  end
+
+  def test_contact_array
+    {
+      :count => 3, :is_error => 0,
+      :values => [test_contact, test_contact, test_contact]
+    }
+  end
+end

data/spec/support/test_matchers.rb

@@ -0,0 +1,37 @@
+RSpec::Matchers.define :be_listable_resource do |expected|
+  match do |actual|
+    client = authorized_civicrm_client
+    subject = actual.class
+    test_response_hash = send(:"test_#{subject.name.demodulize.underscore}_array")
+
+    client.expects(:get).once.returns(test_response(test_response_hash))
+    c = subject.all
+
+    c.should be_a_kind_of(Array)
+  end
+end
+RSpec::Matchers.define :be_updatable_resource do |expected|
+  match do |actual|
+    client = authorized_civicrm_client
+    subject = actual.class
+
+    client.expects(:get).once.returns(test_response(test_contact({name: "foo"})))
+    client.expects(:put).once.returns(test_response(test_contact({name: "bar"})))
+    c = subject.find("resource_id")
+    c.name.should == "foo"
+    c.name = "bar"
+    c.save
+    c.name.should == "bar"
+  end
+end
+RSpec::Matchers.define :be_deleteable_resource do |expected|
+  match do |actual|
+    client = authorized_civicrm_client
+    subject = actual.class
+
+    client.expects(:get).once.returns(test_response(test_contact({name: "foo"})))
+    client.expects(:delete).once.returns(test_response(test_contact({name: "bar"})))
+    c = subject.find("resource_id")
+    c.delete
+  end
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: civicrm
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Iskander Haziev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: See http://civicrm.org for details.
+email:
+- gvalmon@gmail.com
+executables:
+- civicrm
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- CONTRIBUTORS
+- Gemfile
+- Gemfile.lock
+- History.txt
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- bin/civicrm
+- civicrm.gemspec
+- lib/civicrm.rb
+- lib/civicrm/actions/create.rb
+- lib/civicrm/actions/destroy.rb
+- lib/civicrm/actions/find.rb
+- lib/civicrm/actions/list.rb
+- lib/civicrm/actions/update.rb
+- lib/civicrm/client.rb
+- lib/civicrm/errors.rb
+- lib/civicrm/resource.rb
+- lib/civicrm/resources/base.rb
+- lib/civicrm/version.rb
+- lib/civicrm/xml.rb
+- spec/requests/base_spec.rb
+- spec/resources/contact_spec.rb
+- spec/spec_helper.rb
+- spec/support/civicrm.rb
+- spec/support/civicrm_responses.rb
+- spec/support/test_matchers.rb
+homepage: http://civicrm.org
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -4533903245477044172
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -4533903245477044172
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Ruby bindings for the CiviCRM API
+test_files: []