horza 0.3.5 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3788b00b2fdf18bc5cbd7ca93fff81cb78b66e98
-  data.tar.gz: 67bbeccedbcfa604055a2dc0e4e5ae9bae9154ed
+  metadata.gz: 3e0c5a3f309830bcdf12d45b896c194edd65564a
+  data.tar.gz: 0abdd19ad225b57350ef96861620ef52b5977d7b
 SHA512:
-  metadata.gz: 997bb4746b4dd08b4e407be0f6ceb903be24b4332aa1b23eb25462258f4997bfe8376c0c2e5208476f7f78094ab1f57436cb1e239a01712f9494665655b90080
-  data.tar.gz: 47f30e2a60aba80c94b226c7bb8a352eb673fa099ad1a13df777f482c056636f3940338975a528ad7c3a043a0939bb9ce7f6c31b605e1beb8585ffe3f5a7017d
+  metadata.gz: 96e4b16fb9944e3b4e5ea6bbdf9d0cf90902a59316f35facda683b3831d6e37d9f189121293c922e6a68800910dc7f7df9b00ffe7633ee8faaf9cb6f237580c3
+  data.tar.gz: 21a843a404376023ed172d82c7d6bc4f0638f599a113b6219e853464656fa3b131a04f33b01ab5455697f7aa632940040093fd2147600e1467b0ae5c5b437122

data/README.md

@@ -21,17 +21,31 @@ user = Horza.adapt(User)
 # Examples
 user.get(id) # Find by id - Return nil on fail
 user.get!(id) # Find by id - Error on fail
+
 user.find_first(options) # Find 1 user - Orders by id desc by default - Return nil on fail
 user.find_first!(options) # Find 1 user - Orders by id desc by default - Error nil on fail
+
 user.find_all(options) # Find all users that match parameters
+
 user.create(options) # Create record - return nil on fail
 user.create!(options) # Create record - raise error on fail
+
 user.update(options) # Update record - return nil on fail
 user.update!(options) # Update record - raise error on fail
+
 user.delete(options) # Delete record - return nil on fail
 user.delete!(options) # Delete record - raise error on fail
+
 user.association(target: :employer, via: []) # Traverse association
 
+# Special case: create a child record when mass-assignment is disabled for parent instance_methods
+# klass is a symbol version of your model name, ie Employer is :employer, SportsCar is :sports_car
+parent = { id: parent_id, klass: :employer }
+
+user.create_as_child(parent, options) # Create record - return nil on fail
+user.create_as_child!(parent, options) # Create record - raise error on fail
+
+# With args
 conditions = { last_name: 'Turner' }
 
 # Ordering

data/lib/horza.rb

@@ -22,5 +22,13 @@ module Horza
     def adapt(klass)
       adapter.new(klass)
     end
+
+    def single(params = {})
+      Horza::Entities::Single.new(params)
+    end
+
+    def collection(items = [])
+      Horza::Entities::Collection.new(items)
+    end
   end
 end

data/lib/horza/adapters/abstract_adapter.rb

@@ -33,6 +33,10 @@ module Horza
         not_implemented_error
       end
 
+      def create_as_child!(parent, options = {})
+        not_implemented_error
+      end
+
       def delete!(id)
         not_implemented_error
       end

data/lib/horza/adapters/active_record.rb

@@ -40,6 +40,13 @@ module Horza
         end
       end
 
+      def create_as_child!(parent_args, options = {})
+        run_and_convert_exceptions do
+          parent = Horza.adapter.context_for_entity(parent_args[:klass]).find(parent_args[:id])
+          create!(options.merge(parent_args[:klass] => parent))
+        end
+      end
+
       def update!(id, options = {})
         run_and_convert_exceptions do
           record = @context.find(id)

data/lib/horza/adapters/instance_methods.rb

@@ -18,6 +18,10 @@ module Horza
         run_quietly { create!(options) }
       end
 
+      def create_as_child(parent_id, options = {})
+        run_quietly { create_as_child!(parent_id, options) }
+      end
+
       def delete(id)
         run_quietly { delete!(id) }
       end

data/spec/active_record_spec.rb

@@ -274,6 +274,63 @@ describe Horza do
       end
     end
 
+    describe '#create_as_child' do
+      let(:employer) { HorzaSpec::Employer.create }
+      let(:parent) do
+        {
+          id: employer.id,
+          klass: :employer
+        }
+      end
+      let(:action) { user_adapter.create_as_child(parent, last_name: last_name) }
+
+      context 'when parameters are valid' do
+        it 'creates the record' do
+          expect { action }.to change(HorzaSpec::User, :count).by(1)
+        end
+
+        it 'returns the entity' do
+          expect(action.last_name).to eq last_name
+          expect(action.employer_id).to eq employer.id
+        end
+      end
+
+      context 'when parameters are invalid' do
+        let(:parent) do
+          {
+            id: 999,
+            klass: :employer
+          }
+        end
+
+        it 'does not create the record' do
+          expect { action }.to change(HorzaSpec::User, :count).by(0)
+        end
+
+        it 'returns nil' do
+          expect(action).to be nil
+        end
+      end
+    end
+
+    describe '#create_as_child!' do
+      let(:employer) { HorzaSpec::Employer.create }
+      let(:action) { user_adapter.create_as_child!(parent, last_name: last_name) }
+
+      context 'when parameters are invalid' do
+        let(:parent) do
+          {
+            id: 999,
+            klass: :employer
+          }
+        end
+
+        it 'throws error' do
+          expect { action }.to raise_error Horza::Errors::RecordNotFound
+        end
+      end
+    end
+
     describe '#update' do
       let(:customer) { HorzaSpec::Customer.create(last_name: last_name) }
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: horza
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors:
 - Blake Turner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-18 00:00:00.000000000 Z
+date: 2015-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie