smooth_operator 1.8.0 → 1.8.3

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MjU3NWQ2OTMyMjE4ODBjZGMzZWJmMmRlMzcxZDBmMWZjYmU5YjYwOQ==
+    N2JjYWE0YjEwY2U0MTk1NWIwZTYxMzlkZTQxNjcwM2M3NDNlZGI4Zg==
   data.tar.gz: !binary |-
-    Y2E5MDEyYmYxODcwNmQ4MzY2MWFlMmViYTQ3Y2QxN2FlOWU2ZTJiOA==
+    ZGQxNjU4NDk4OGFhZmM5NjdmYzAwNWVjOTE3YmQzMDdjZjVhMTc4YQ==
 SHA512:
   metadata.gz: !binary |-
-    NzlmOGZhNzVhYTVkOTE0YTI4OGZkMjhjNDlkYWE1NWEzZmE0YmIzY2RmMGVk
-    NzcyYTlmY2ZhZmNmZmU4MzIyOWY4ZjU2MmFlYTU4ZjRmNzI2OTczYmM3MGNi
-    ZDUyMGZkOGYwZDBkZThmNTE5ZTQxMTkxN2JjZWRiYTFlNzg4Nzk=
+    NjVhMWJmNzE3YTM2YzI0OTQ1YjIyNTBjYTFiODk2Y2NmZmM1YzIzY2E3M2E0
+    NzI1OGM4YWRhOTQyNzVkNmRjMzAwMDM3MzI0MjJlOGFlODYwODNkMjg2Y2Nm
+    OWNiNjE3NzZlYjc0OGRmY2Y4NTVhNGFlODI2N2JjYmNkNGRkZDI=
   data.tar.gz: !binary |-
-    YWI0YjkzNDVmN2JhMmY0MzYxMmE4NGQ1ZDAxMDM1NzZkYThiZjZhMmYxZmE2
-    NzIzYTQ5MzA0NDg4NzE5ZmM2ODgzOTFmYjkwNzMxYjZiMTdmZjRjZDUzYjM4
-    YzQzZTc3NzJkM2I2OGM5MzFhYTQ0NDc5MWU1MGI0NmE0MzkzNGM=
+    NjM1ZDQ5NTI5YzI3MmE2Mjk2ZDQ3NmY0OGQ2OGU3ZjkzMWE5ZTVmZDNiMzQ3
+    ZjA5YWIyYWNhZWZhNTY4NDhiOTc4MWUzY2ZlYWYyMDQzM2M0MWU4ZjE0M2Vl
+    OWVhOTMzYzAzNTI4YmQzNTkzMDEwYjA5MGU1MTY3ODM5NTI1ZmM=

data/Gemfile

@@ -3,6 +3,8 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in smooth_operator.gemspec
 gemspec
 
+gem 'simplecov', :require => false, :group => :test
+
 group :development, :test do
   gem "pry"
   gem "sinatra"

data/README.md

@@ -7,8 +7,9 @@ Depends only on Faraday gem, no need for ActiveSupport or any other Active* gem.
 
 Although if I18n is present it will respond to .human_attribute_name method and if ActiveModel is present it will make use of 'ActiveModel::Name' to improve .model_name method.
 
+---
 
-## Installation
+## 1) Installation
 
 Add this line to your application's Gemfile:
 
@@ -22,15 +23,252 @@ Or install it yourself as:
 
     $ gem install smooth_operator
 
+---
 
-## Usage
+## 2) Usage and Examples
 
-TODO: Write usage instructions here
+```ruby
+class MyBlogResource < SmoothOperator::Base
+  self.endpoint = 'http://myblog.com/api/v0'
 
+  # HTTP BASIC AUTH
+  self.endpoint_user = 'admin'
+  self.endpoint_pass = 'admin'
+end
 
-## TODO
+class Post < MyBlogResource
+end
+```
 
-1. FinderMethods specs
-2. serialization_specs to test the json options for nested classes
-3. model_schema_specs
-4. Cache 
+---
+
+### 2.1) Creating a .new 'Post' and #save it
+
+```ruby
+post = Post.new(body: 'my first post', author: 'John Doe')
+
+post.new_record?     # true
+post.persisted?     # false
+post.body           # 'my first post'
+post.author         # 'John Doe'
+post.something_else # will raise NoMethodError
+
+save_result = post.save # will make a http POST call to 'http://myblog.com/api/v0/posts'
+                        # with `{ post: { body: 'my first post', author: 'John Doe' } }`
+
+post.last_remote_call # will contain a SmoothOperator::RemoteCall instance containing relevant information about the save remote call.
+
+# If the server response is positive (http code between 200 and 299):
+save_result       # true
+post.new_record?  # false
+post.persisted?   # true
+# server response contains { id: 1 } on its body
+post.id # 1
+
+# If the server response is negative (http code between 400 and 499):
+save_result       # false
+post.new_record?  # true
+post.persisted?   # false
+# server response contains { errors: { body: ['must be less then 10 letters'] } }
+post.errors.body # Array
+
+# If the server response is an error (http code between 500 and 599), or the connection was broke:
+save_result       # nil
+post.new_record?  # true
+post.persisted?   # false
+# server response contains { errors: { body: ['must be less then 10 letters'] } }
+post.errors # will raise NoMethodError
+
+  # In the positive and negative server response comes with a json,
+  # e.g. { id: 1 }, post will reflect that new data
+  post.id # 1
+
+  # In case of error and the server response contains a json,
+  # e.g. { id: 1 }, post will NOT reflect that data
+  post.id # raise NoMethodError
+
+```
+
+---
+
+### 2.2) Editing an existing record
+```ruby
+post = Post.find(2)
+
+post.body = 'editing my second page'
+
+post.save
+```
+
+---
+
+### 2.3) Customize #save 'url', 'params' and 'options'
+```ruby
+post = Post.new(id: 2, body: 'editing my second page')
+
+post.new_record? # false
+post.persisted?  # true
+
+post.save("#{post.id}/save_and_add_to_list", { admin: true, post: { author: 'Agent Smith', list_id: 1 } }, { timeout: 1 })
+# Will make a PUT to 'http://myblog.com/api/v0/posts/2/save_and_add_to_list'
+# with { admin: true, post: { body: 'editing my second page', list_id: 1 } }
+# and will only wait 1sec for the server to respond.
+```
+
+---
+
+### 2.4) Saving using HTTP Patch verb
+```ruby
+class Page < MyBlogResource
+  self.save_http_verb = :patch
+end
+
+page = Page.find(2)
+
+page.body = 'editing my second page'
+
+page.save # will make a http PATCH call to 'http://myblog.com/api/v0/pages/2'
+          # with `{ page: { body: 'editing my second page' } }`
+```
+
+---
+
+### 2.5) Retrieving remote objects - 'index' REST action
+
+```ruby
+remote_call = Page.find(:all) # Will make a GET call to 'http://myblog.com/api/v0/pages'
+                              # and will return a SmoothOperator::RemoteCall instance
+
+pages = remote_call.objects # 'pages = remote_call.data' also works
+
+# If the server response is positive (http code between 200 and 299):
+  remote_call.success? # true
+  remote_call.failure? # false
+  remote_call.error? # false
+  remote_call.status # true
+  pages = remote_call.data # array of Page instances
+  remote_call.http_status # server_response code
+
+# If the server response is negative (http code between 400 and 499):
+  remote_call.success? # false
+  remote_call.failure? # true
+  remote_call.error? # false
+  remote_call.status # false
+  remote_call.http_status # server_response code
+
+# If the server response is an error (http code between 500 and 599), or the connection broke:
+  remote_call.success? # false
+  remote_call.failure? # false
+  remote_call.error? # true
+  remote_call.status # nil
+  remote_call.http_status # server_response code or 0 if connection broke
+```
+
+---
+
+### 2.6) Retrieving remote objects - 'show' REST action
+
+```ruby
+remote_call = Page.find(2) # Will make a GET call to 'http://myblog.com/api/v0/pages/2'
+                           # and will return a SmoothOperator::RemoteCall instance
+
+page = remote_call.object # 'page = remote_call.data' also works
+```
+
+---
+
+### 2.7) Retrieving remote objects - custom query
+```ruby
+remote_call = Page.find('my_pages', { q: body_contains: 'link' }, { endpoint_user: 'admin', endpoint_pass: 'new_password' })
+# will make a GET call to 'http://myblog.com/api/v0/pages/my_pages?q={body_contains="link"}'
+# and will change the HTTP BASIC AUTH credentials to user: 'admin' and pass: 'new_password' for this connection only.
+
+# If the server json response is an Array [{ id: 1 }, { id: 2 }]
+  pages = remote.data # will return an array with 2 Page's instances
+  pages[0].id # 1
+  pages[1].id # 2
+
+# If the server json response is a Hash { id: 3 }
+  page = remote.data # will return a single Page instance
+  page.id # 3
+
+# If the server json response is Hash with a key called 'pages' { page: 1, total: 3, pages: [{ id: 4 }, { id: 5 }] }
+  pages = remote.data # will return a single ArrayWithMetaData instance, that will allow you to access to both the Page's instances array and the metadata.
+  pages.page # 1
+  pages.total # 3
+
+  pages[0].id # 4
+  pages[1].id # 5
+```
+
+---
+
+## 3) Methods
+
+---
+
+### 3.1) Persistence methods
+
+Methods | Behaviour | Arguments | Return
+------- | --------- | ------ | ---------
+.create | Generates a new instance of the class with *attributes and calls #save with the rest of its arguments| Hash attributes = nil, String relative_path = nil, Hash data = {}, Hash options = {} | Class instance
+#new_record? | Returns @new_record if defined, else populates it with true if #id is present or false if blank. | - | Boolean
+#destroyed?| Returns @destroyed if defined, else populates it with false. | - | Boolean
+#persisted?| Returns true if both #new_record? and #destroyed? return false, else returns false. | - | Boolean
+#save | if #new_record? makes a HTTP POST, else a PUT call. If !#new_record? and relative_path is blank, sets relative_path = id.to_s. If the server POST response is positive, sets @new_record = false. See 4.2) for more behaviour info. | String relative_path = nil, Hash data = {}, Hash options = {} | Boolean or Nil
+#save! | Executes the same behaviour as #save, but will raise RecordNotSaved if the returning value is not true | String relative_path = nil, Hash data = {}, Hash options = {} | Boolean or Nil
+#destroy | Does nothing if !persisted? else makes a HTTP DELETE call. If server response it positive, sets @destroyed = true. If relative_path is blank, sets relative_path = id.to_s. See 4.2) for more behaviour info. | String relative_path = nil, Hash data = {}, Hash options = {} | Boolean or Nil
+
+---
+
+### 3.2) Finder methods
+
+Methods | Behaviour | Arguments | Return
+------- | --------- | ------ | ---------
+.all | calls .find(:all, data, options) | Hash data = {}, Hash options = {} | Class instance, Array of Class instances or an ArrayWithMetaData instance
+.find | If relative_path == :all, sets relative_path = ''. Makes a Get call and initiates Class objects with the server's response data. See 4.3) and 4.4) for more behaviour info. | String relative_path, Hash data = {}, Hash options = {} | Class instance, Array of Class instances or an ArrayWithMetaData instance
+
+---
+
+### 3.3) Operator methods
+...
+
+---
+
+### 3.3) Remote call methods
+...
+
+---
+
+## 4) Behaviours
+
+---
+
+### 4.1) Delegation behaviour
+...
+
+---
+
+### 4.2) Persistent operator behaviour
+...
+
+---
+
+### 4.3) Operator behaviour
+...
+
+---
+
+### 4.4) Remote call behaviour
+...
+
+---
+
+## 4) TODO
+
+1. Finish "Methods" and "Behaviours" documentation;
+2. Allow changing the HTTP verb for a specific connection;
+3. FinderMethods specs;
+4. serialization_specs to test the json options for nested classes;
+5. model_schema_specs;
+6. Cache.

data/lib/smooth_operator/array_with_meta_data.rb

@@ -8,7 +8,7 @@ module SmoothOperator
 
     attr_reader :meta_data, :internal_array, :table_name, :object_class
 
-    def_delegators :internal_array, :length, :<<
+    def_delegators :internal_array, :length, :<<, :[]
 
     def initialize(attributes, table_name, object_class)
       _attributes = attributes.dup

data/lib/smooth_operator/finder_methods.rb

@@ -12,7 +12,7 @@ module SmoothOperator
       relative_path = '' if relative_path == :all
 
       get(relative_path, data, options).tap do |remote_call|
-        remote_call.object = build_object(remote_call.parsed_response, options)
+        remote_call.object = build_object(remote_call.parsed_response, options) if remote_call.success?
       end
     end
 

data/lib/smooth_operator/helpers.rb

@@ -39,8 +39,6 @@ module SmoothOperator
       case object
       when String
         object.to_s == ''
-      when Array
-        object.empty?
       else
         object.nil?
       end

data/lib/smooth_operator/model_schema.rb

@@ -28,7 +28,7 @@ module SmoothOperator
       attr_writer :table_name
 
       def table_name
-        @table_name ||= self.model_name.to_s.downcase.pluralize
+        @table_name ||= self.model_name.to_s.underscore.pluralize
       end
 
       def schema(structure)
@@ -49,19 +49,23 @@ module SmoothOperator
         if defined? ActiveModel
           rails_model_name_method
         else
-          name.split('::').last.underscore.capitalize
+          @_model_name_namespace ||= name.split('::').last.underscore.capitalize
         end
       end
 
+      def model_name=(name)
+        @_model_name_namespace = name
+      end
       
+
       protected ############## PROTECTED #############
 
       def rails_model_name_method
         @_model_name ||= begin
-          namespace = self.parents.detect do |n|
+          @_model_name_namespace ||= self.parents.detect do |n|
             n.respond_to?(:use_relative_model_naming?) && n.use_relative_model_naming?
           end
-          ActiveModel::Name.new(self, namespace)
+          ActiveModel::Name.new(self, @_model_name_namespace)
         end
       end
 

data/lib/smooth_operator/operator.rb

@@ -29,7 +29,7 @@ module SmoothOperator
       url, timeout = (options[:endpoint] || self.endpoint), (options[:timeout] || self.timeout)
 
       Faraday.new(url: url) do |builder|
-        builder.options.params_encoder = Faraday::NestedParamsEncoder # to properly encode arrays
+        # builder.options.params_encoder = Faraday::NestedParamsEncoder # to properly encode arrays
         builder.options.timeout = timeout unless Helpers.blank?(timeout)
         builder.request :url_encoded
         builder.adapter adapter
@@ -38,7 +38,7 @@ module SmoothOperator
 
 
     protected ################ PROTECTED ################
-
+    #COMPLEX
     def make_the_call(http_verb, relative_path = '', data = {}, options = {})
       params, body = strip_params(http_verb, data)
 
@@ -58,7 +58,8 @@ module SmoothOperator
         end
 
         RemoteCall::Base.new(response)
-      rescue Faraday::ConnectionFailed
+      # rescue Faraday::ConnectionFailed
+      rescue Faraday::Error::ConnectionFailed
         RemoteCall::ConnectionFailed.new
       end
     end

data/lib/smooth_operator/persistence.rb

@@ -1,5 +1,5 @@
 module SmoothOperator
-  
+
   module Persistence
 
     def self.included(base)
@@ -15,13 +15,13 @@ module SmoothOperator
       [:create, :save, :destroy].each do |method|
         define_method("#{method}_http_verb=") { |http_verb| methods_http_verbs[method] = http_verb }
       end
-      
+
       def create(attributes = nil, relative_path = nil, data = {}, options = {})
-        if attributes.is_a?(Array)
-          attributes.map { |array_entry| create(array_entry, relative_path, data, options) }
-        else
+        # if attributes.is_a?(Array)
+        #   attributes.map { |array_entry| create(array_entry, relative_path, data, options) }
+        # else
           new(attributes).tap { |object| object.save(relative_path, data, options) }
-        end
+        # end
       end
 
     end
@@ -29,16 +29,14 @@ module SmoothOperator
 
     def new_record?
       return @new_record if defined?(@new_record)
-      
+
       @new_record = Helpers.blank?(get_internal_data("id"))
     end
-    
+
     def destroyed?
-      @destroyed || false
-    end
+      return @destroyed if defined?(@destroyed)
 
-    def last_remote_call
-      @last_remote_call
+      @destroyed = false
     end
 
     def persisted?
@@ -56,8 +54,8 @@ module SmoothOperator
     def destroy(relative_path = nil, data = {}, options = {})
       return false unless persisted?
 
-      relative_path = "#{id}" if Helpers.blank?(relative_path)
-      
+      relative_path = id.to_s if Helpers.blank?(relative_path)
+
       success = make_remote_call(self.class.methods_http_verbs[:destroy], relative_path, data, options)
 
       @destroyed = true if success
@@ -81,7 +79,7 @@ module SmoothOperator
     end
 
     def update(relative_path, data, options)
-      relative_path = "#{id}" if Helpers.blank?(relative_path)
+      relative_path = id.to_s if Helpers.blank?(relative_path)
 
       make_remote_call(self.class.methods_http_verbs[:save], relative_path, data, options)
     end
@@ -95,7 +93,7 @@ module SmoothOperator
       @last_remote_call = self.class.send(http_verb, relative_path, data, options)
 
       returning_data = @last_remote_call.parsed_response
-      
+
       if !@last_remote_call.error? && returning_data.is_a?(Hash)
         assign_attributes returning_data.include?(model_name) ? returning_data[model_name] : returning_data
       end
@@ -105,7 +103,7 @@ module SmoothOperator
 
     def build_remote_call_args(http_verb, data, options)
       return [data, options] if http_verb == :delete
-      
+
       hash = serializable_hash(options[:serializable_options]).dup
       hash.delete('id')
 
@@ -113,5 +111,5 @@ module SmoothOperator
     end
 
   end
-  
+
 end

data/lib/smooth_operator/remote_call.rb

@@ -14,6 +14,8 @@ module SmoothOperator
 
       def_delegators :response, :success?, :headers, :body
 
+      alias :ok? :success?
+
       def initialize(response, object_class = nil)
         @response, @object_class = response, object_class
       end
@@ -53,7 +55,7 @@ module SmoothOperator
 
     class ConnectionFailed
 
-      attr_reader :data, :object, :objects, :status, :headers, :body
+      attr_reader :data, :object, :objects, :parsed_response, :status, :headers, :body
 
       def http_status; 0; end
 
@@ -67,4 +69,4 @@ module SmoothOperator
 
   end
 
-end
+end

data/lib/smooth_operator/serialization.rb

@@ -6,7 +6,8 @@ module SmoothOperator
       Helpers.symbolyze_keys serializable_hash(options)
     end
     
-    alias :attributes :to_hash
+    # alias :attributes :to_hash
+    def attributes; to_hash; end
     
     def to_json(options = nil)
       require 'json' unless defined? JSON
@@ -18,9 +19,25 @@ module SmoothOperator
       send(attribute)
     end
 
-    def serializable_hash(options = nil) # Code inspired in ActiveSupport#serializable_hash
+    def serializable_hash(options = nil)
+      hash = {}
       options ||= {}
 
+      attribute_names(options).each do |attribute_name|
+        hash[attribute_name] = read_attribute_for_hashing(attribute_name, options)
+      end
+
+      method_names(options).each do |method_name|
+        hash[method_name.to_s] = send(method_name)
+      end
+
+      hash
+    end
+
+
+    protected ##################### PROTECTED ###################
+    #COMPLEX
+    def attribute_names(options)
       attribute_names = internal_data.keys.sort
 
       if only = options[:only]
@@ -29,18 +46,12 @@ module SmoothOperator
         attribute_names -= [*except].map(&:to_s)
       end
 
-      method_names = [*options[:methods]].select { |n| respond_to?(n) }
-
-      hash = {}
-      
-      attribute_names.each { |attribute_name| hash[attribute_name] = read_attribute_for_hashing(attribute_name, options) }
-      method_names.each { |method_name| hash[method_name.to_s] = send(method_name) }
-
-      hash
+      attribute_names
     end
 
-
-    protected ##################### PROTECTED ###################
+    def method_names(options)
+      [*options[:methods]].select { |n| respond_to?(n) }
+    end
 
     def read_attribute_for_hashing(attribute_name, options)
       object = read_attribute_for_serialization(attribute_name)

data/lib/smooth_operator/type_converter.rb

@@ -11,22 +11,22 @@ module SmoothOperator
         value.to_s
       
       when :int, :integer, Integer, Fixnum
-        TypeConverter.to_int(value)
+        to_int(value)
 
       when :date, Date
-        TypeConverter.to_date(value)
+        to_date(value)
 
       when :float, Float
-        TypeConverter.to_float(value)
+        to_float(value)
 
       when :bool, :boolean
-        TypeConverter.to_boolean(value)
+        to_boolean(value)
 
       when :datetime, :date_time, DateTime
-        TypeConverter.to_datetime(value)
+        to_datetime(value)
 
       else
-        value
+        Helpers.duplicate(value)
       end
     end
 

data/lib/smooth_operator/version.rb

@@ -1,3 +1,3 @@
 module SmoothOperator
-  VERSION = "1.8.0"
+  VERSION = "1.8.3"
 end

data/smooth_operator.gemspec

@@ -24,5 +24,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.3"
   
   spec.add_dependency "json"
-  spec.add_dependency 'faraday', '> 0.9.0.rc5'
+  # spec.add_dependency 'faraday', '> 0.9.0.rc5'
+  spec.add_dependency 'faraday', '~> 0.8.1'
 end

data/spec/smooth_operator/finder_methods_spec.rb

@@ -1,11 +1,56 @@
 require "spec_helper"
 
 describe SmoothOperator::FinderMethods do
-  subject { User }
+  subject { UserWithAddressAndPosts::Son }
 
+  describe ".all" do
+    xit "should can .find(:all) with the same arguments that it as received" do
+      
+    end
+  end
 
   describe ".find" do
-    
+    context "when the server returns a single hash" do
+      it "it should return a RemoteCall instance with a subject's class instance populated with the returned hash" do
+        remote_call = subject.find(5)
+        user = remote_call.object
+
+        expect(user).to be_instance_of(subject)
+        expect(user.attributes).to eq(attributes_for(:user_with_address_and_posts))
+      end
+    end
+
+    context "when the server returns an array" do
+      it "it should return a RemoteCall instance an array that contains a subject's class instance, one for every array's entry" do
+        remote_call = subject.find(:all)
+        users = remote_call.objects
+
+        expect(users).to be_instance_of(Array)
+        expect(users[0]).to be_instance_of(subject)
+        expect(users[1]).to be_instance_of(subject)
+      end
+
+      it "if any of the array entries is not a hash, it shall not be converted or alteread" do
+        remote_call = subject.find('misc_array')
+        users = remote_call.objects
+
+        expect(users).to be_instance_of(Array)
+        expect(users[0]).to be_instance_of(subject)
+        expect(users[1]).to be(2)
+      end
+    end
+
+    context "when the server returns a hash with a key (equal to subject's call.table_name) containing an array" do
+      it "it should return a RemoteCall instance an instance of ArrayWithMetaData" do
+        remote_call = subject.find('with_metadata')
+        users = remote_call.data
+
+        expect(users).to be_instance_of(SmoothOperator::ArrayWithMetaData)
+        expect(users.page).to be(1)
+        expect(users.total).to be(6)
+        users.each { |user| expect(user).to be_instance_of(subject) }
+      end
+    end
   end
 
 end

data/spec/smooth_operator/persistence_spec.rb

@@ -24,6 +24,7 @@ shared_examples_for "persistent remote call" do
 
     it "it should return true" do
       execute_method
+      expect(subject.last_remote_call.success?).to be true
       expect(subject.last_remote_call.status).to be true
     end
 
@@ -40,6 +41,7 @@ shared_examples_for "persistent remote call" do
 
     it "it should return false" do
       execute_method
+      expect(subject.last_remote_call.failure?).to be true
       expect(subject.last_remote_call.status).to be false
     end
 
@@ -56,6 +58,7 @@ shared_examples_for "persistent remote call" do
 
     it "it should return nil" do
       execute_method
+      expect(subject.last_remote_call.error?).to be true
       expect(subject.last_remote_call.status).to be_nil
     end
 
@@ -89,10 +92,10 @@ describe SmoothOperator::Persistence, helpers: :persistence do
 
   describe ".create" do
     
+    subject { created_subject }
     let(:method_arguments) { [] }
 
     context "when attributes DON'T contain an ID" do
-      subject { created_subject }
       let(:method_to_execute) { :create_without_id }
       let(:persistence_state) { { 200 => true, 422 => false, 500 => false } }
 
@@ -107,7 +110,6 @@ describe SmoothOperator::Persistence, helpers: :persistence do
     end
 
     context "when attributes contain an ID" do
-      subject { created_subject }
       let(:method_to_execute) { :create_with_id }
       let(:persistence_state) { { 200 => true, 422 => true, 500 => true } }
 

data/spec/smooth_operator/remote_call_spec.rb

@@ -0,0 +1,98 @@
+require "spec_helper"
+
+describe SmoothOperator::RemoteCall do
+  subject { User }
+
+  describe "#success?" do
+    context "when the server response has a http code in the 200 range" do
+      it "should return true" do
+      end
+    end
+
+    context "when the server response has a http code NOT in the 200 range" do
+      it "should return false" do
+      end
+    end
+
+    context "when the server response connection fails" do
+      it "should return false" do
+      end
+    end
+  end
+
+  describe "#failure?" do
+    context "when the server response has a http code in the 400 range" do
+      it "should return true" do
+      end
+    end
+
+    context "when the server response has a http code NOT in the 400 range" do
+      it "should return false" do
+      end
+    end
+
+    context "when the server response connection fails" do
+      it "should return false" do
+      end
+    end
+  end
+
+  describe "#error?" do
+    context "when the server response has a http code in the 500 range" do
+      it "should return true" do
+      end
+    end
+
+    context "when the server response has a http code NOT in the 500 range" do
+      it "should return false" do
+      end
+    end
+
+    context "when the server response connection fails" do
+      it "should return true" do
+      end
+    end
+  end
+
+  describe "#parsed_response" do
+    context "when the server response's body contains valid json data" do
+      it "should return the parsed result of that data" do
+      end
+    end
+
+    context "when the server response's body does not contains valid json data" do
+      it "should return nil" do
+      end
+    end
+  end
+
+  describe "#status" do
+    context "when the #error? returns true" do
+      it "should return nil" do
+      end
+    end
+
+    context "when the #error? returns false and #success? returns true" do
+      it "should return true" do
+      end
+    end
+
+    context "when the #error? returns false and #success? returns false" do
+      it "should return false" do
+      end
+    end
+  end
+
+  describe "#http_status" do
+    context "when a server connection is established" do
+      it "should return the server's http response code" do
+      end
+    end
+
+    context "when a server connection fails" do
+      it "should return 0" do
+      end
+    end
+  end
+
+end

data/spec/smooth_operator/validations_spec.rb

@@ -0,0 +1,42 @@
+require "spec_helper"
+
+describe SmoothOperator::Validations do
+  subject { User.new(attributes_for(:user)) }
+
+  describe "#valid?" do
+    context "when executing a persistence method, and the server response has a hash with the key 'errors'" do
+      before { subject.save('send_error') }
+
+      it "it should return false" do
+        expect(subject.valid?).to be false
+      end
+    end
+
+    context "when executing a persistence method, and the server response does NOT have a hash with the key 'errors'" do
+      before { subject.save }
+
+      it "it should return true" do
+        expect(subject.valid?).to be true
+      end
+    end
+  end
+
+  describe "#invalid?" do
+    context "when executing a persistence method, and the server response has a hash with the key 'errors'" do
+      before { subject.save('send_error') }
+
+      it "it should return true" do
+        expect(subject.invalid?).to be true
+      end
+    end
+
+    context "when executing a persistence method, and the server response does NOT have a hash with the key 'errors'" do
+      before { subject.save }
+
+      it "it should return false" do
+        expect(subject.invalid?).to be false
+      end
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -1,3 +1,11 @@
+require 'simplecov'
+
+SimpleCov.start do
+  root('lib/')
+  project_name('SmoothOperator')
+  coverage_dir('../tmp/coverage/')
+end
+
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "..", "lib"))
 

data/spec/support/test_server.rb

@@ -25,7 +25,16 @@ class TestServer < Sinatra::Base
 
 
   get '/users' do
-    json [{ id: 1 }, { id: 2 }]
+    users = [FactoryGirl.attributes_for(:user_with_address_and_posts), FactoryGirl.attributes_for(:user_with_address_and_posts)]
+    
+    users[0][:id] = 1
+    users[1][:id] = 2
+
+    json users
+  end
+
+  get '/users/misc_array' do
+    json [FactoryGirl.attributes_for(:user_with_address_and_posts), 2]
   end
 
   get '/users/with_metadata' do
@@ -37,6 +46,11 @@ class TestServer < Sinatra::Base
     json FactoryGirl.attributes_for(:user_with_address_and_posts)
   end
 
+  put '/users/send_error' do
+    data_with_error = { id: 1, errors: { first_name: ["can't be blank"] } }
+    json data_with_error
+  end
+
 
   post '/users' do
     common_response

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smooth_operator
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.8.3
 platform: ruby
 authors:
 - João Gonçalves
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-25 00:00:00.000000000 Z
+date: 2014-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -42,16 +42,16 @@ dependencies:
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>'
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.0.rc5
+        version: 0.8.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>'
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.0.rc5
+        version: 0.8.1
 description: ActiveResource alternative
 email:
 - goncalves.joao@gmail.com
@@ -91,7 +91,9 @@ files:
 - spec/smooth_operator/model_schema_spec.rb
 - spec/smooth_operator/operator_spec.rb
 - spec/smooth_operator/persistence_spec.rb
+- spec/smooth_operator/remote_call_spec.rb
 - spec/smooth_operator/serialization_spec.rb
+- spec/smooth_operator/validations_spec.rb
 - spec/spec_helper.rb
 - spec/support/helpers/persistence_helper.rb
 - spec/support/localhost_server.rb
@@ -133,7 +135,9 @@ test_files:
 - spec/smooth_operator/model_schema_spec.rb
 - spec/smooth_operator/operator_spec.rb
 - spec/smooth_operator/persistence_spec.rb
+- spec/smooth_operator/remote_call_spec.rb
 - spec/smooth_operator/serialization_spec.rb
+- spec/smooth_operator/validations_spec.rb
 - spec/spec_helper.rb
 - spec/support/helpers/persistence_helper.rb
 - spec/support/localhost_server.rb