linker 0.0.9 → 0.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 649af5b02f108cc0845bce6e6ff29976782fd752
-  data.tar.gz: 6b03c70603069decf64f7851a809bb097449d156
+  metadata.gz: 202e246d9b8bba56438ee91d84cf718d61307e8c
+  data.tar.gz: bb02b4dd6d5672839ad67f88efabb552cae8e475
 SHA512:
-  metadata.gz: b3eea6edd014d9d59032168f360618631e708afc5555db3d5f8470fad5c0417f7f3a306bd745441e93582f23267232ed950cc6fbdf20e0770e9be3ac66cc47d1
-  data.tar.gz: 6cc4e1c49383406fa85f180fb84ce74b05fa36b8b251302509888a04949deae9b0f950df6a9b5778487b241900074ce276bdd3290bb605030caf0589cc29f5dd
+  metadata.gz: 6e05c2b3f2805cc9364ab4c3e7ce5a692e97462a51e0e5adb1ad1f1b635284b56eed847bdbd85e997e9590753c4b96a060a5c4fda98120d3ce6e03169ebe5d9e
+  data.tar.gz: 757b6f285cc457725fe4d7a4554e27b545b331dbc31f5ea6f1750e42accdf40a6e8d7ba53f7bfc2c73ebdb6397645b7c3f721f23a60fe4a6a2370d0ce81f8436

data/README.md

@@ -44,6 +44,10 @@ class UserForm
   include Linker
   
   main_model User # or :user or 'User'
+
+  # Use relationship's name followed by "__" plus attribute's name 
+  # to validate has_one and belongs_to associations
+  validates :name, :address__street, :company__name, presence: true
 end
 ```
 
@@ -99,6 +103,39 @@ It will also create `params=` and `save` methods responsible to set new objects
 
 You can check out a demo project using Linker gem [here](https://github.com/glaucocustodio/linker_demo). [Click here](http://linker-demo.herokuapp.com/) to see it live.
 
+## Callbacks
+
+There are some callbacks you can override to keep your controllers DRY:
+
+* `before_set_params(params)`: run before `params=` method. Can be used to change params inside the form class, like string formatting.
+* `before_save`: run before save method.
+* `after_save`: run after save method. You can enqueue some background job here for ie.
+
+Example:
+
+```ruby
+class CarsForm
+  include Linker
+  attr_accessor :before_save_checked
+
+  main_model :car
+
+  validates :name, presence: true
+
+  def before_set_params params
+    params['name'] = "#{params['name']} 2000"
+  end
+
+  def before_save
+    @before_save_checked = true
+  end
+
+  def after_save
+    HardWorker.perform_async('bob', 5)
+  end
+end
+```
+
 ## Contributing
 
 1. Fork it

data/lib/linker/forms/params.rb

@@ -6,6 +6,7 @@ module Linker
 
     included do
       def params= params
+        before_set_params(params)
         params.each do |param, value|
           if value.is_a?(Hash)
             table = param.gsub(%r{_attributes$}, '')
@@ -55,14 +56,33 @@ module Linker
         end
       end
 
+      # Saves main model with its associated records, with or without validation
+      # (defaults to `:true`, with validation)
+      #
+      # @param validate [boolean] a boolean declaring if the form class must be validated.
+      # @return [boolean] a boolean representing if the form class was validated (or no, if `validate` is `false`) and
+      # saved successfully
       def save validate: true
         main_model = _get_main_model
+        before_save
 
         if validate
-          self.valid? && main_model.save
+          r = (self.valid? && main_model.save)
+          after_save
         else
-          main_model.save
+          r = main_model.save
+          after_save
         end
+        r
+      end
+
+      def before_set_params params
+      end
+
+      def before_save
+      end
+
+      def after_save
       end
 
     end

data/lib/linker/version.rb

@@ -1,3 +1,3 @@
 module Linker
-  VERSION = "0.0.9"
+  VERSION = "0.0.10"
 end

data/spec/cars_form_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe CarsForm do
+  let(:cars_form) { CarsForm.new(Car.new) }
+
+  context 'before_set_params' do
+    before do
+      cars_form.params = {
+        'name' => "Uno"
+      }
+      cars_form.save
+    end
+
+    it { expect(cars_form.car.name).to eq('Uno 2000') }
+    it { expect(cars_form.before_save_checked).to eq(true) }
+    it { expect(cars_form.after_save_checked).to eq(true) }
+  end
+end

data/spec/fake_app/active_record/models.rb

@@ -41,6 +41,9 @@ end
 class Phone < ActiveRecord::Base
 end
 
+class Car < ActiveRecord::Base
+end
+
 #migrations
 class CreateAllTables < ActiveRecord::Migration
   def self.up
@@ -111,6 +114,12 @@ class CreateAllTables < ActiveRecord::Migration
       t.timestamps
     end
 
+    create_table :cars do |t|
+      t.string :name
+
+      t.timestamps
+    end
+
   end
 end
 ActiveRecord::Migration.verbose = false

data/spec/fake_app/forms/cars_form.rb

@@ -0,0 +1,22 @@
+require 'linker'
+
+class CarsForm
+  include Linker
+  attr_accessor :before_save_checked, :after_save_checked
+
+  main_model :car
+
+  validates :name, presence: true
+
+  def before_set_params params
+    params['name'] = "#{params['name']} 2000"
+  end
+
+  def before_save
+    @before_save_checked = true
+  end
+
+  def after_save
+    @after_save_checked = true
+  end
+end

data/spec/fake_app/rails_app.rb

@@ -17,6 +17,7 @@ app.initialize!
 require_relative 'active_record/models'
 require_relative 'forms/dependent_user_form'
 require_relative 'forms/users_form'
+require_relative 'forms/cars_form'
 # controllers
 # class ApplicationController < ActionController::Base; end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: linker
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.10
 platform: ruby
 authors:
 - Glauco Custódio
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-18 00:00:00.000000000 Z
+date: 2015-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -148,9 +148,11 @@ files:
 - lib/linker/forms/params.rb
 - lib/linker/version.rb
 - linker.gemspec
+- spec/cars_form_spec.rb
 - spec/dependent_user_form_spec.rb
 - spec/fake_app/active_record/models.rb
 - spec/fake_app/config/database.yml
+- spec/fake_app/forms/cars_form.rb
 - spec/fake_app/forms/dependent_user_form.rb
 - spec/fake_app/forms/users_form.rb
 - spec/fake_app/rails_app.rb
@@ -176,16 +178,19 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.1
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: A wrapper to form objects in ActiveRecord. Forget accepts_nested_attributes_for.
 test_files:
+- spec/cars_form_spec.rb
 - spec/dependent_user_form_spec.rb
 - spec/fake_app/active_record/models.rb
 - spec/fake_app/config/database.yml
+- spec/fake_app/forms/cars_form.rb
 - spec/fake_app/forms/dependent_user_form.rb
 - spec/fake_app/forms/users_form.rb
 - spec/fake_app/rails_app.rb
 - spec/spec_helper.rb
 - spec/users_form_spec.rb
+has_rdoc: