unidom-common-rspec 0.3 → 0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 423975fbbd2d45be90dad54b10bb33d9fca86ca3
-  data.tar.gz: 972f708c3a3cd7ce84ce54dca26b7db5ac5d5f82
+  metadata.gz: a86129997899c61c37b4c47cbb46b955d88f4cdc
+  data.tar.gz: 34c294a34e2dbf90b639831d2b4453428577a810
 SHA512:
-  metadata.gz: fe7a08d3627566465e51b205c9936bfa8bb5b9c7523c9a6b100c9243d2a4e36c7a9f2e93c9e051d2e3825060f663e18fa7dd57d8ba92a8ec10d0350e2d52701e
-  data.tar.gz: aae6459986887bfb5d5002d0c42363910f7ffb86de2ae1dd52ffbce38c814002ded13906ecd42af120d778371c4996bd1c144e4687ec14c47c7079e5e00492ec
+  metadata.gz: ae6bf1b9a027504ca10f02aefe702266143ed0de82eabf073a93beefc95fee3a74bd675cad1cc0a0afcbeed3779115a8e2c77f00bd5a2ca1d00e7d56fbc62fff
+  data.tar.gz: 16b681d61c787cf4aef24bf375a54a2f60acf627ac66340c4f8f7fa2d53f6bd7131718f4d9e04c6fd8f228b8a829f4b1be0e32e893744a86d46d3bb3d0b35031

data/CHANGELOG.md

@@ -8,3 +8,6 @@
 
 ## v0.3
 1. Model Extension shared examples
+
+## v0.4
+1. Has Many shared examples

data/README.md

@@ -111,7 +111,28 @@ describe Person, type: :model do
 
     tim_attributes = { name: 'Tim' }
 
-    it_behaves_like 'Unidom::Common::Concerns::ModelExtension', model_attributes
+    it_behaves_like 'Unidom::Common::Concerns::ModelExtension', tim_attributes
+
+  end
+
+end
+```
+
+### Has Many shared examples Has Many 共享用例
+
+Assume the model class is ``Person``, and the model alread defined the ``has_many :pets``, the ``person_spec.rb`` looks like the following:
+```ruby
+require 'rails_helper'
+
+describe Person, type: :model do
+
+  context do
+
+    tim_attributes = { name: 'Tim' }
+    cat_attributes = { name: 'Pearl',  species: 'Persian'   }
+    dog_attribtues = { name: 'Flower', species: 'Chihuahua' }
+
+    it_behaves_like 'has_many', tim_attributes, :pets, 'Pet', [ cat_attributes, dog_attribtues ]
 
   end
 

data/ROADMAP.md

@@ -8,3 +8,6 @@
 
 ## v0.3
 1. Model Extension shared examples
+
+## v0.4
+1. Has Many shared examples

data/lib/unidom/common/rspec.rb

@@ -4,10 +4,11 @@ require 'unidom/common/rspec/scope_shared_examples'
 require 'unidom/common/rspec/validates_shared_examples'
 require 'unidom/common/rspec/model_extension_shared_examples'
 
+require 'unidom/common/rspec/has_many_shared_examples'
+
 module Unidom
   module Common
     module RSpec
-      # Your code goes here...
     end
   end
 end

data/lib/unidom/common/rspec/has_many_shared_examples.rb

@@ -0,0 +1,81 @@
+shared_examples 'has_many' do |model_attributes, collection_name, item_class, item_attributes_collection|
+
+  describe "##{collection_name}" do
+
+    model_instance        = described_class.new model_attributes
+    collection            = model_instance.send collection_name.to_sym
+    item_instances        = item_attributes_collection.map do |item_attributes| item_class.new item_attributes end
+    macro_definition      = model_instance.association collection_name.to_sym
+    being_through         = macro_definition.is_a? ActiveRecord::Associations::ThroughAssociation
+    reflection            = macro_definition.reflection
+    association_readonly  = reflection.nested?
+    #association_immutable = reflection.source_reflection.blank? ? false : (:belongs_to != reflection.source_reflection.macro)
+    association_immutable = reflection.source_reflection.blank? ? false : being_through&&![ :belongs_to ].include?(reflection.source_reflection.macro)
+
+    [ collection_name, "#{collection_name}=", "#{collection_name.to_s.singularize}_ids", "#{collection_name.to_s.singularize}_ids=" ].each do |method|
+      describe "##{method}" do
+        it 'is responded to' do expect(model_instance).to respond_to(method.to_sym) end
+      end
+    end
+
+    %w{ << push concat build create create! size length count sum where empty? clear delete delete_all destroy destroy_all find exists? uniq reset }.each do |method|
+
+      describe "##{method}" do
+
+        before :each do collection.clear if collection.present? end
+        after  :each do collection.clear if collection.present? end
+
+        it 'is responded to' do expect(collection).to respond_to(method.to_sym) end
+
+        case method
+
+          when '<<'
+            if association_readonly || association_immutable
+            #if association_immutable
+              it 'nested association can not build' do
+                error_class = association_readonly ? ActiveRecord::HasManyThroughNestedAssociationsAreReadonly : ActiveRecord::HasManyThroughCantAssociateThroughHasOneOrManyReflection
+                expect { item_instances.each do |item_instance| collection << item_instance end }.to raise_error(error_class)
+              end
+            else
+              it 'adds items' do
+                expect(collection.size).to eq(0)
+                item_instances.each       do |item_instance| collection << item_instance                            end
+                item_instances.each_index do |index|         expect(collection[index]).to eq(item_instances[index]) end
+                expect(collection.size).to eq(item_instances.size)
+              end
+            end
+
+          when 'build'
+            if association_readonly #or association_immutable
+              it 'nested association can not build' do
+                error_class = association_readonly ? ActiveRecord::HasManyThroughNestedAssociationsAreReadonly : ActiveRecord::HasManyThroughCantAssociateThroughHasOneOrManyReflection
+                expect { collection.build }.to raise_error(error_class)
+              end
+            else
+              it 'builds an item instance' do
+                item_1 = collection.build
+                expect(item_1).to     be_an_instance_of(item_class)
+                expect(item_1).to     be_new_record
+                item_2 = collection.build
+                expect(item_2).to     be_an_instance_of(item_class)
+                expect(item_2).to     be_new_record
+                expect(item_1).to_not be(item_2)
+              end
+            end
+
+        end
+
+      end
+    end
+
+    # The following method(s) does not exist. Who know why?
+    %w{}.each do |method|
+      it "##{method}" do
+        pending ":#{method} method does not exist."
+        expect(collection).to respond_to(method.to_sym)
+      end
+    end
+
+  end
+
+end

data/lib/unidom/common/rspec/version.rb

@@ -1,7 +1,7 @@
 module Unidom
   module Common
     module RSpec
-      VERSION = '0.3'
+      VERSION = '0.4'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-common-rspec
 version: !ruby/object:Gem::Version
-  version: '0.3'
+  version: '0.4'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-12-27 00:00:00.000000000 Z
+date: 2016-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-rails
@@ -87,6 +87,7 @@ files:
 - bin/console
 - bin/setup
 - lib/unidom/common/rspec.rb
+- lib/unidom/common/rspec/has_many_shared_examples.rb
 - lib/unidom/common/rspec/model_extension_shared_examples.rb
 - lib/unidom/common/rspec/scope_shared_examples.rb
 - lib/unidom/common/rspec/validates_shared_examples.rb