castle-her 1.0.1

data/spec/model/dirty_spec.rb

@@ -0,0 +1,91 @@
+# encoding: utf-8
+require File.join(File.dirname(__FILE__), "../spec_helper.rb")
+
+describe "Her::Model and ActiveModel::Dirty" do
+  context "checking dirty attributes" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+        builder.adapter :test do |stub|
+          stub.get("/users/1") { |env| [200, {}, { :id => 1, :fullname => "Lindsay Fünke" }.to_json] }
+          stub.get("/users/2") { |env| [200, {}, { :id => 2, :fullname => "Maeby Fünke" }.to_json] }
+          stub.get("/users/3") { |env| [200, {}, { :user_id => 3, :fullname => "Maeby Fünke" }.to_json] }
+          stub.put("/users/1") { |env| [200, {}, { :id => 1, :fullname => "Tobias Fünke" }.to_json] }
+          stub.put("/users/2") { |env| [400, {}, { :errors => ["Email cannot be blank"] }.to_json] }
+          stub.post("/users") { |env| [200, {}, { :id => 1, :fullname => "Tobias Fünke" }.to_json] }
+        end
+      end
+
+      spawn_model "Foo::User" do
+        attributes :fullname, :email
+      end
+      spawn_model "Dynamic::User" do
+        primary_key :user_id
+      end
+    end
+
+    context "for existing resource" do
+      let(:user) { Foo::User.find(1) }
+      it "has no changes" do
+        expect(user.changes).to be_empty
+        expect(user).not_to be_changed
+      end
+      context "with successful save" do
+        it "tracks dirty attributes" do
+          user.fullname = "Tobias Fünke"
+          expect(user.fullname_changed?).to be_truthy
+          expect(user.email_changed?).to be_falsey
+          expect(user).to be_changed
+          user.save
+          expect(user).not_to be_changed
+        end
+
+        it "tracks only changed dirty attributes" do
+          user.fullname = user.fullname
+          expect(user.fullname_changed?).to be_falsey
+        end
+
+        it "tracks previous changes" do
+          user.fullname = "Tobias Fünke"
+          user.save
+          expect(user.previous_changes).to eq({"fullname"=>"Lindsay Fünke"})
+        end
+
+        it 'tracks dirty attribute for mass assign for dynamic created attributes' do
+          user = Dynamic::User.find(3)
+          user.assign_attributes(:fullname => 'New Fullname')
+          expect(user.fullname_changed?).to be_truthy
+          expect(user).to be_changed
+          expect(user.changes.length).to eq(1)
+        end
+      end
+
+      context "with erroneous save" do
+        it "tracks dirty attributes" do
+          user = Foo::User.find(2)
+          user.fullname = "Tobias Fünke"
+          expect(user.fullname_changed?).to be_truthy
+          expect(user.email_changed?).to be_falsey
+          expect(user).to be_changed
+          user.save
+          expect(user).to be_changed
+        end
+      end
+    end
+
+    context "for new resource" do
+      let(:user) { Foo::User.new(:fullname => "Lindsay Fünke") }
+      it "has changes" do
+        expect(user).to be_changed
+      end
+      it "tracks dirty attributes" do
+        user.fullname = "Tobias Fünke"
+        expect(user.fullname_changed?).to be_truthy
+        expect(user).to be_changed
+        user.save
+        expect(user).not_to be_changed
+      end
+    end
+  end
+end

data/spec/model/http_spec.rb

@@ -0,0 +1,158 @@
+# encoding: utf-8
+require File.join(File.dirname(__FILE__), "../spec_helper.rb")
+
+describe Her::Model::HTTP do
+  context "binding a model with an API" do
+    let(:api1) { Her::API.new :url => "https://api1.example.com" }
+    let(:api2) { Her::API.new :url => "https://api2.example.com" }
+
+    before do
+      spawn_model("Foo::User")
+      spawn_model("Foo::Comment")
+      Her::API.setup :url => "https://api.example.com"
+    end
+
+    context "when binding a model to its superclass' her_api" do
+      before do
+        spawn_model "Foo::Superclass"
+        Foo::Superclass.uses_api api1
+        Foo::Subclass = Class.new(Foo::Superclass)
+      end
+
+      specify { expect(Foo::Subclass.her_api).to eq(Foo::Superclass.her_api) }
+    end
+
+    context "when changing her_api without changing the parent class' her_api" do
+      before do
+        spawn_model "Foo::Superclass"
+        Foo::Subclass = Class.new(Foo::Superclass)
+        Foo::Superclass.uses_api api1
+        Foo::Subclass.uses_api api2
+      end
+
+      specify { expect(Foo::Subclass.her_api).not_to eq(Foo::Superclass.her_api) }
+    end
+  end
+
+  context "making HTTP requests" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+        builder.adapter :test do |stub|
+          stub.get("/users") { |env| [200, {}, [{ :id => 1 }].to_json] }
+          stub.get("/users/1") { |env| [200, {}, { :id => 1 }.to_json] }
+          stub.get("/users/popular") do |env|
+            if env[:params]["page"] == "2"
+              [200, {}, [{ :id => 3 }, { :id => 4 }].to_json]
+            else
+              [200, {}, [{ :id => 1 }, { :id => 2 }].to_json]
+            end
+          end
+        end
+      end
+
+      spawn_model "Foo::User"
+    end
+
+    describe :get do
+      subject { Foo::User.get(:popular) }
+      its(:length) { should == 2 }
+      specify { expect(subject.first.id).to eq(1) }
+    end
+
+    describe :get_raw do
+      context "with a block" do
+        specify do
+          Foo::User.get_raw("/users") do |parsed_data, response|
+            expect(parsed_data[:data]).to eq([{ :id => 1 }])
+          end
+        end
+      end
+
+      context "with a return value" do
+        subject { Foo::User.get_raw("/users") }
+        specify { expect(subject[:parsed_data][:data]).to eq([{ :id => 1 }]) }
+      end
+    end
+
+    describe :get_collection do
+      context "with a String path" do
+        subject { Foo::User.get_collection("/users/popular") }
+        its(:length) { should == 2 }
+        specify { expect(subject.first.id).to eq(1) }
+      end
+
+      context "with a Symbol" do
+        subject { Foo::User.get_collection(:popular) }
+        its(:length) { should == 2 }
+        specify { expect(subject.first.id).to eq(1) }
+      end
+
+      context "with extra parameters" do
+        subject { Foo::User.get_collection(:popular, :page => 2) }
+        its(:length) { should == 2 }
+        specify { expect(subject.first.id).to eq(3) }
+      end
+    end
+
+    describe :get_resource do
+      context "with a String path" do
+        subject { Foo::User.get_resource("/users/1") }
+        its(:id) { should == 1 }
+      end
+
+      context "with a Symbol" do
+        subject { Foo::User.get_resource(:"1") }
+        its(:id) { should == 1 }
+      end
+    end
+
+    describe :get_raw do
+      specify do
+        Foo::User.get_raw(:popular) do |parsed_data, response|
+          expect(parsed_data[:data]).to eq([{ :id => 1 }, { :id => 2 }])
+        end
+      end
+    end
+  end
+
+  context "setting custom HTTP requests" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |connection|
+        connection.use Her::Middleware::FirstLevelParseJSON
+        connection.adapter :test do |stub|
+          stub.get("/users/popular") { |env| [200, {}, [{ :id => 1 }, { :id => 2 }].to_json] }
+          stub.post("/users/from_default") { |env| [200, {}, { :id => 4 }.to_json] }
+        end
+      end
+
+      spawn_model "Foo::User"
+    end
+
+    subject { Foo::User }
+
+    describe :custom_get do
+      context "without cache" do
+        before { Foo::User.custom_get :popular, :recent }
+        it { should respond_to(:popular) }
+        it { should respond_to(:recent) }
+
+        context "making the HTTP request" do
+          subject { Foo::User.popular }
+          its(:length) { should == 2 }
+        end
+      end
+    end
+
+    describe :custom_post do
+      before { Foo::User.custom_post :from_default }
+      it { should respond_to(:from_default) }
+
+      context "making the HTTP request" do
+        subject { Foo::User.from_default(:name => "Tobias Fünke") }
+        its(:id) { should == 4 }
+      end
+    end
+  end
+end

data/spec/model/introspection_spec.rb

@@ -0,0 +1,76 @@
+# encoding: utf-8
+require File.join(File.dirname(__FILE__), "../spec_helper.rb")
+
+describe Her::Model::Introspection do
+  context "introspecting a resource" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+        builder.adapter :test do |stub|
+          stub.post("/users")     { |env| [200, {}, { :id => 1, :name => "Tobias Funke" }.to_json] }
+          stub.get("/users/1")    { |env| [200, {}, { :id => 1, :name => "Tobias Funke" }.to_json] }
+          stub.put("/users/1")    { |env| [200, {}, { :id => 1, :name => "Tobias Funke" }.to_json] }
+          stub.delete("/users/1") { |env| [200, {}, { :id => 1, :name => "Tobias Funke" }.to_json] }
+          stub.get("/projects/1/comments") { |env| [200, {}, [{ :id => 1, :body => "Hello!" }].to_json] }
+        end
+      end
+
+      spawn_model "Foo::User"
+      spawn_model "Foo::Comment" do
+        collection_path "projects/:project_id/comments"
+      end
+    end
+
+    describe "#inspect" do
+      it "outputs resource attributes for an existing resource" do
+        @user = Foo::User.find(1)
+        expect(["#<Foo::User(users/1) name=\"Tobias Funke\" id=1>", "#<Foo::User(users/1) id=1 name=\"Tobias Funke\">"]).to include(@user.inspect)
+      end
+
+      it "outputs resource attributes for an not-saved-yet resource" do
+        @user = Foo::User.new(:name => "Tobias Funke")
+        expect(@user.inspect).to eq("#<Foo::User(users) name=\"Tobias Funke\">")
+      end
+
+      it "outputs resource attributes using getters" do
+        @user = Foo::User.new(:name => "Tobias Funke", :password => "Funke")
+        @user.instance_eval {def password; 'filtered'; end}
+        expect(@user.inspect).to include("name=\"Tobias Funke\"")
+        expect(@user.inspect).to include("password=\"filtered\"")
+        expect(@user.inspect).not_to include("password=\"Funke\"")
+      end
+
+      it "support dash on attribute" do
+        @user = Foo::User.new(:'life-span' => "3 years")
+        expect(@user.inspect).to include("life-span=\"3 years\"")
+      end
+    end
+
+    describe "#inspect with errors in resource path" do
+      it "prints the resource path as “unknown”" do
+        @comment = Foo::Comment.where(:project_id => 1).first
+        path = '<unknown path, missing `project_id`>'
+        expect(["#<Foo::Comment(#{path}) body=\"Hello!\" id=1>", "#<Foo::Comment(#{path}) id=1 body=\"Hello!\">"]).to include(@comment.inspect)
+      end
+    end
+  end
+
+  describe "#her_nearby_class" do
+    context "for a class inside of a module" do
+      before do
+        spawn_model "Foo::User"
+        spawn_model "Foo::AccessRecord"
+        spawn_model "AccessRecord"
+        spawn_model "Log"
+      end
+
+      it "returns a sibling class, if found" do
+        expect(Foo::User.her_nearby_class("AccessRecord")).to eq(Foo::AccessRecord)
+        expect(AccessRecord.her_nearby_class("Log")).to eq(Log)
+        expect(Foo::User.her_nearby_class("Log")).to eq(Log)
+        expect(Foo::User.her_nearby_class("X")).to eq(nil)
+      end
+    end
+  end
+end

data/spec/model/nested_attributes_spec.rb

@@ -0,0 +1,134 @@
+# encoding: utf-8
+require File.join(File.dirname(__FILE__), "../spec_helper.rb")
+
+describe Her::Model::NestedAttributes do
+  context "with a belongs_to association" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+      end
+
+      spawn_model "Foo::User" do
+        belongs_to :company, :path => "/organizations/:id", :foreign_key => :organization_id
+        accepts_nested_attributes_for :company
+      end
+
+      spawn_model "Foo::Company"
+
+      @user_with_data_through_nested_attributes = Foo::User.new :name => "Test", :company_attributes => { :name => "Example Company" }
+    end
+
+    context "when child does not yet exist" do
+      it "creates an instance of the associated class" do
+        expect(@user_with_data_through_nested_attributes.company).to be_a(Foo::Company)
+        expect(@user_with_data_through_nested_attributes.company.name).to eq("Example Company")
+      end
+    end
+
+    context "when child does exist" do
+      it "updates the attributes of the associated object" do
+        @user_with_data_through_nested_attributes.company_attributes = { :name => "Fünke's Company" }
+        expect(@user_with_data_through_nested_attributes.company).to be_a(Foo::Company)
+        expect(@user_with_data_through_nested_attributes.company.name).to eq("Fünke's Company")
+      end
+    end
+  end
+
+  context "with a has_one association" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+      end
+
+      spawn_model "Foo::User" do
+        has_one :pet
+        accepts_nested_attributes_for :pet
+      end
+
+      spawn_model "Foo::Pet"
+
+      @user_with_data_through_nested_attributes = Foo::User.new :name => "Test", :pet_attributes => { :name => "Hasi" }
+    end
+
+    context "when child does not yet exist" do
+      it "creates an instance of the associated class" do
+        expect(@user_with_data_through_nested_attributes.pet).to be_a(Foo::Pet)
+        expect(@user_with_data_through_nested_attributes.pet.name).to eq("Hasi")
+      end
+    end
+
+    context "when child does exist" do
+      it "updates the attributes of the associated object" do
+        @user_with_data_through_nested_attributes.pet_attributes = { :name => "Rodriguez" }
+        expect(@user_with_data_through_nested_attributes.pet).to be_a(Foo::Pet)
+        expect(@user_with_data_through_nested_attributes.pet.name).to eq("Rodriguez")
+      end
+    end
+  end
+
+  context "with a has_many association" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+      end
+
+      spawn_model "Foo::User" do
+        has_many :pets
+        accepts_nested_attributes_for :pets
+      end
+
+      spawn_model "Foo::Pet"
+
+      @user_with_data_through_nested_attributes = Foo::User.new :name => "Test", :pets_attributes => [{ :name => "Hasi" }, { :name => "Rodriguez" }]
+    end
+
+    context "when children do not yet exist" do
+      it "creates an instance of the associated class" do
+        expect(@user_with_data_through_nested_attributes.pets.length).to eq(2)
+        expect(@user_with_data_through_nested_attributes.pets[0]).to be_a(Foo::Pet)
+        expect(@user_with_data_through_nested_attributes.pets[1]).to be_a(Foo::Pet)
+        expect(@user_with_data_through_nested_attributes.pets[0].name).to eq("Hasi")
+        expect(@user_with_data_through_nested_attributes.pets[1].name).to eq("Rodriguez")
+      end
+    end
+  end
+
+  context "with a has_many association as a Hash" do
+    before do
+      Her::API.setup :url => "https://api.example.com" do |builder|
+        builder.use Her::Middleware::FirstLevelParseJSON
+        builder.use Faraday::Request::UrlEncoded
+      end
+
+      spawn_model "Foo::User" do
+        has_many :pets
+        accepts_nested_attributes_for :pets
+      end
+
+      spawn_model "Foo::Pet"
+
+      @user_with_data_through_nested_attributes_as_hash = Foo::User.new :name => "Test", :pets_attributes => { '0' => { :name => "Hasi" }, '1' => { :name => "Rodriguez" }}
+    end
+
+    context "when children do not yet exist" do
+      it "creates an instance of the associated class" do
+        expect(@user_with_data_through_nested_attributes_as_hash.pets.length).to eq(2)
+        expect(@user_with_data_through_nested_attributes_as_hash.pets[0]).to be_a(Foo::Pet)
+        expect(@user_with_data_through_nested_attributes_as_hash.pets[1]).to be_a(Foo::Pet)
+        expect(@user_with_data_through_nested_attributes_as_hash.pets[0].name).to eq("Hasi")
+        expect(@user_with_data_through_nested_attributes_as_hash.pets[1].name).to eq("Rodriguez")
+      end
+    end
+  end
+
+  context "with an unknown association" do
+    it "raises an error" do
+      expect {
+        spawn_model("Foo::User") { accepts_nested_attributes_for :company }
+      }.to raise_error(Her::Errors::AssociationUnknownError, 'Unknown association name :company')
+    end
+  end
+end