decent_exposure 2.0.1 → 2.1.0

data/README.md

@@ -267,6 +267,22 @@ expose(:article, finder: :find_by_slug)
 expose(:article, finder_parameter: :slug)
 ```
 
+### Setting a distinct object for a single action
+
+There are times when one action in a controller is different from the
+rest of the actions. Rather than putting conditional logic in your
+exposure block, a better approach is the use the controller's setter
+methods:
+
+```ruby
+expose(:articles) { current_user.articles }
+expose(:article)
+
+def index
+  self.articles = Article.all
+end
+```
+
 ### Getting your hands dirty
 
 While we try to make things as easy for you as possible, sometimes you just
@@ -353,6 +369,39 @@ And opt into it like so:
 expose(:article, config: :sluggable)
 ```
 
+## Usage with Rails 4 (or strong\_parameters plugin)
+
+If you're using Rails 4 or
+[strong\_parameters](https://github.com/rails/strong_parameters), add the
+following to your ApplicationController:
+
+
+``` ruby
+class ApplicationController < ActionController::Base
+  decent_configuration do
+    strategy DecentExposure::StrongParametersStrategy
+  end
+end
+```
+
+Then, when you'd like parameters to be assigned to a model, add the
+`attributes` option to your exposure:
+
+```ruby
+class FooController < ApplicationController
+  expose(:foo, attributes: :foo_params)
+
+  private
+  def foo_params
+    params.require(:foo).permit(:bar, :baz)
+  end
+end
+```
+
+In the example above, `foo_params` will only be called on a PUT, POST or
+PATCH request.
+
+
 ## Testing
 
 Controller testing remains trivially easy. The shift is that you now set expectations on methods rather than instance variables. With RSpec, this mostly means avoiding `assign` and `assigns`.
@@ -401,4 +450,4 @@ end
 ```
 
 
-[1]: http://blog.voxdolo.me/a-diatribe-on-maintaining-state.html
+[1]: http://blog.voxdolo.me/a-diatribe-on-maintaining-state.html

data/lib/decent_exposure/expose.rb

@@ -5,7 +5,7 @@ module DecentExposure
   module Expose
     def self.extended(base)
       base.class_eval do
-        class_attribute :_default_exposure, :_decent_configurations
+        class_attribute :_decent_configurations
         self._decent_configurations ||= Hash.new(Configuration.new)
 
         def _resources
@@ -20,15 +20,7 @@ module DecentExposure
     end
 
     def decent_configuration(name=:default,&block)
-      _decent_configurations[name] = Configuration.new(&block)
-    end
-
-    def default_exposure(&block)
-      warn "[DEPRECATION] `default_exposure` is deprecated, and will " \
-      "be removed in DecentExposure 2.1 without a replacement.  Please " \
-      "use a custom strategy instead.\n" \
-      "#{caller.first}"
-      self._default_exposure = block
+      self._decent_configurations = _decent_configurations.merge(name => Configuration.new(&block))
     end
 
     def expose!(*args, &block)
@@ -36,7 +28,7 @@ module DecentExposure
       expose(*args, &block)
     end
 
-    def expose(name, options={:default_exposure => _default_exposure}, &block)
+    def expose(name, options={}, &block)
       if ActionController::Base.instance_methods.include?(name.to_sym)
         Kernel.warn "[WARNING] You are exposing the `#{name}` method, " \
           "which overrides an existing ActionController method of the same name. " \

data/lib/decent_exposure/strategizer.rb

@@ -1,22 +1,20 @@
 require 'decent_exposure/exposure'
 require 'decent_exposure/active_record_with_eager_attributes_strategy'
+require 'decent_exposure/strong_parameters_strategy'
 
 module DecentExposure
   class Strategizer
-    attr_accessor :name, :block, :default_exposure, :options, :custom_strategy_class
+    attr_accessor :name, :block, :options, :custom_strategy_class
 
     def initialize(name, options={})
       self.name = name
-      self.default_exposure = options.delete(:default_exposure)
       self.custom_strategy_class = options.delete(:strategy)
       self.options = options
       self.block = Proc.new if block_given?
     end
 
     def strategy
-      [block_strategy,
-       default_exposure_strategy,
-       exposure_strategy].detect(&applicable)
+      [block_strategy, exposure_strategy].detect(&applicable)
     end
 
     def model
@@ -37,21 +35,11 @@ module DecentExposure
       BlockStrategy.new(block) if block
     end
 
-    def default_exposure_strategy
-      DefaultStrategy.new(name, default_exposure) if default_exposure
-    end
-
     def exposure_strategy_class
       custom_strategy_class || ActiveRecordWithEagerAttributesStrategy
     end
   end
 
-  DefaultStrategy = Struct.new(:name, :block) do
-    def call(controller)
-      controller.instance_exec(name, &block)
-    end
-  end
-
   BlockStrategy = Struct.new(:block) do
     def call(controller)
       controller.instance_eval(&block)

data/lib/decent_exposure/strong_parameters_strategy.rb

@@ -0,0 +1,27 @@
+require 'decent_exposure/active_record_strategy'
+
+module DecentExposure
+  class StrongParametersStrategy < ActiveRecordStrategy
+    delegate :get?,    :to => :request
+    delegate :delete?, :to => :request
+
+    def singular?
+      !plural?
+    end
+
+    def attributes
+      return @attributes if defined?(@attributes)
+      @attributes = controller.send(options[:attributes]) if options[:attributes]
+    end
+
+    def assign_attributes?
+      singular? && !get? && !delete? && attributes.present?
+    end
+
+    def resource
+      super.tap do |r|
+        r.attributes = attributes if assign_attributes?
+      end
+    end
+  end
+end

data/lib/decent_exposure/version.rb

@@ -1,3 +1,3 @@
 module DecentExposure #:nodoc
-  VERSION = "2.0.1"
+  VERSION = "2.1.0"
 end

metadata

@@ -2,7 +2,7 @@
 name: decent_exposure
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Stephen Caudill
@@ -11,14 +11,14 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-14 00:00:00.000000000 Z
+date: 2013-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.11'
     none: false
   name: rspec
   type: :development
@@ -27,14 +27,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.11'
     none: false
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.11'
     none: false
   name: rspec-rails
   type: :development
@@ -43,39 +43,39 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.11'
     none: false
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: 3.1.0
     none: false
   name: actionpack
   type: :development
   prerelease: false
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: 3.1.0
     none: false
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: 3.1.0
     none: false
   name: activesupport
   type: :development
   prerelease: false
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: 3.1.0
     none: false
 description: ! "\n    DecentExposure helps you program to an interface, rather than
   an\n    implementation in your Rails controllers.  The fact of the matter is that\n
@@ -96,6 +96,7 @@ files:
 - lib/decent_exposure/inflector.rb
 - lib/decent_exposure/strategizer.rb
 - lib/decent_exposure/strategy.rb
+- lib/decent_exposure/strong_parameters_strategy.rb
 - lib/decent_exposure/version.rb
 - lib/decent_exposure.rb
 - README.md