resourcerer 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9e93c37e2be8821f943067ec855db980a6f9d988
-  data.tar.gz: 0ccf7f26495abab03c38fc3d6e02615c573262ed
+  metadata.gz: b06994a58d730b98de201b5c3da0223f380e2dd5
+  data.tar.gz: cef7fd6af87ee0d92761c70c22f7ce0796da21e1
 SHA512:
-  metadata.gz: 37c61ffbf52613e9bcabe9267a8043195dfb6ba591967c547aafec9958fce936a3cfa80a20ed5b35f36418001b2fe7572df10270a075e7844504d141db1691a3
-  data.tar.gz: f3c3b7e8d6c420891dd48b8e6185a804c13cb900a73046e688980eb78edf2fdcbd66d06777368f418434e4119085af23d538698e5278e81e5bdaf7c828649be9
+  metadata.gz: fde5d21d084804512b05fa28cfc7b09e59a54c34d97ac8f95502274b4e262a8b25264f832767ba1b2e63ce5c359e9e6c2d9415b50785b36b4141bffb9cfe8f6b
+  data.tar.gz: 670c8bf4194bf8e3482d1b0cb9c8a9a0acc8e5474a66a63f76bea8d59355826b1621169396ad31b67e134e16bbebc33899790584b036e790e1b222e1291f65af

data/README.md

@@ -1,4 +1,4 @@
-Resourcerer
+Resourcerer [![Gem Version](https://badge.fury.io/rb/resourcerer.svg)](http://badge.fury.io/rb/resourcerer) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ElMassimo/queryable/blob/master/LICENSE.txt)
 =====================
 What `resourcerer` proposes is that you go from this:
 
@@ -29,7 +29,7 @@ class PersonController < ApplicationController
       render :edit
     end
   end
-  
+
   private
     def person_params
       params.require(:person).permit(:name)
@@ -41,7 +41,9 @@ To something like this:
 
 ```ruby
 class PersonController < ApplicationController
-  resource :person
+  resource :person do
+    permit [:name]
+  end
 
   def create
     if person.save
@@ -58,11 +60,6 @@ class PersonController < ApplicationController
       render :edit
     end
   end
-  
-  private
-    def person_params
-      params.require(:person).permit(:name)
-    end
 end
 ```
 
@@ -103,6 +100,28 @@ resource :person
 
 ### Configuration
 
+### DSL
+Resourcer also features a nice DSL, which is helpful when you need more control over the resource
+lifecycle.
+
+You can also access every configuration option available above:
+```ruby
+resource(:employee) do
+  model :person
+  find_by :name
+  find {|name| company.find_employee(name) }
+  build { company.new_employee }
+  assign { params.require(:employee).permit(:name) }
+  permit [:name, :description]
+end
+# is the same as:
+resource(:employee, model: :person, finder_attribute: :name, finder: ->(name){ company.find_employee(name) }, builder: ->{ company.new_employee }, attributes: ->{ params.require(:employee).permit(:name) })
+```
+The DSL is more convenient when you have an object oriented design and want to allow an object to handle its collections, or as a quick way to set the StrongParameters method.
+
+Configuration options play well together, and the defaults try to make intelligent use of them. For example,
+setting the `finder_attribute` in the example above changes the `finder_param` to `person_name` instead of `person_id`, and the value of that parameter is provided to the finder block.
+
 Let's take a look at some of the things you can do:
 
 **Specify the model name:**
@@ -133,27 +152,6 @@ resource(:employee, attributes_method: :person_params)
 resource(:person, param_key: :employee)
 ```
 
-### DSL
-Resourcer also features a nice DSL, which is helpful when you need more control over the resource
-lifecycle.
-
-You can also access every configuration option available above:
-```ruby
-resource(:employee) do
-  model :person
-  find_by :name
-  find {|name| company.find_employee(name) }
-  build { company.new_employee }
-  assign { params.require(:employee).permit(:name) }
-end
-# is the same as:
-resource(:employee, model: :person, finder_attribute: :name, finder: ->(name){ company.find_employee(name) }, builder: ->{ company.new_employee }, attributes: ->{ params.require(:employee).permit(:name) })
-```
-The DSL is more convenient when you have an object oriented design and want to allow an object to handle its collections, or as a quick way to set the StrongParameters method.
-
-Configuration options play well together, and the defaults try to make intelligent use of them. For example,
-setting the `finder_attribute` in the example above changes the `finder_param` to `person_name` instead of `person_id`, and the value of that parameter is provided to the finder block.
-
 ### Setting a distinct object for a single action
 
 There are times when one action in a controller is different from the
@@ -163,12 +161,9 @@ controller's setter methods. This example uses [presenter_rails](https://github.
 ```ruby
 resource(:article)
 
-def show_oldest
+def oldest
   self.article = Article.find_oldest
-end
-
-present :article do
-  ArticlePresenter.new(article)
+  render :show
 end
 ```
 
@@ -231,7 +226,7 @@ class PersonController < ApplicationController
       render :edit
     end
   end
-  
+
   private
     def person_params
       params.require(:person).permit(:name)
@@ -243,8 +238,10 @@ To something like this by adding [presenter_rails](https://github.com/ElMassimo/
 
 ```ruby
 class PersonController < ApplicationController
-  resource(:person)
-  
+  resource :person do
+    permit :name
+  end
+
   present :person do
     person.decorate
   end
@@ -264,11 +261,6 @@ class PersonController < ApplicationController
       render :edit
     end
   end
-
-  private
-    def person_params
-      params.require(:person).permit(:name)
-    end
 end
 ```
 
@@ -280,7 +272,7 @@ Resourcerer is heavily inspired on [decent exposure](https://github.com/voxdolo/
 Both allow you to find or initialize a resource and assign attributes, removing the boilerplate from most CRUD actions.
 
 #### Differences
-Resourcerer does not expose an object to the view in any way, scope the query to a collection method if defined, nor deal with collections.
+Resourcerer does not expose an object to the view in any way, scope the query to a collection method if defined, nor deal with collections. It also has better support for strong parameters.
 
 
 ### Caveats

data/lib/resourcerer/resource_configuration.rb

@@ -37,5 +37,13 @@ module Resourcerer
     def assign(&block)
       options[:attributes] = block
     end
+
+    def collection(proc=nil, &block)
+      if proc = (proc || block)
+        options[:collection] = proc
+      else
+        options[:collection]
+      end
+    end
   end
 end

data/lib/resourcerer/strategies/default_strategy.rb

@@ -18,16 +18,12 @@ module Resourcerer
         @id ||= params[finder_param] || params[finder_attribute]
       end
 
-      def finder_param
-        config.finder_param || inflector.finder_param
-      end
-
       def find_resource(id)
-        controller_eval(config.finder, id) || model.find_by(finder_attribute => id)
+        controller_eval(config.finder, id) || collection.find_by(finder_attribute => id)
       end
 
       def build_resource
-        controller_eval(config.builder) || model.new
+        controller_eval(config.builder) || collection.new
       end
 
       protected
@@ -35,6 +31,10 @@ module Resourcerer
       def controller_eval(proc, *args)
         controller.instance_exec(*args, &proc) if proc
       end
+
+      def collection
+        controller_eval(config.collection) || model
+      end
     end
   end
 end

data/lib/resourcerer/strategy.rb

@@ -44,6 +44,12 @@ module Resourcerer
       config.find_by || :id
     end
 
+    def finder_param
+      config.finder_param ||
+        (config.param_key && "#{config.param_key}_#{finder_attribute}") ||
+        inflector.finder_param
+    end
+
     def params
       controller.params
     end

metadata

@@ -1,41 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: resourcerer
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Máximo Mussini
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-12 00:00:00.000000000 Z
+date: 2014-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: pakiderm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Define resources to automate finding a record and assigning attributes.
@@ -67,17 +67,17 @@ licenses:
 metadata: {}
 post_install_message: 
 rdoc_options:
-- "--charset=UTF-8"
+- --charset=UTF-8
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []