let_me_mass_assign_protected_attributes 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in let_me_mass_assign_protected_attributes.gemspec
+gemspec

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/Readme.md

@@ -0,0 +1,97 @@
+Let me mass-assign protected attributes!
+========================================
+
+Normally when you try to do a mass-assignment (or a `new`/`create`) and you include in your attributes hash an attribute that is protected (by an `attr_accessible` or `attr_protected` somewhere in your model), Active Record will complain with a warning such as this in your log file:
+
+     WARNING: Can't mass-assign protected attributes: is_admin, state
+
+But what if you really *want* to mass-assign those protected attributes anyway and you have a legitimate reason for doing so?
+
+For example, sometimes you need to create a record in your tests with certain pre-determined values for all of its attributes, *including* the protected ones.
+
+You *could* always do a regular (non-mass) attribute assignment for each of your protected attributes after your main mass-assignment/`new`/`create`...
+
+    user = User.new(
+      name: 'Some Name',
+      email: 'test@example.com',
+      ...
+    ) do |user|
+      user.is_admin = true
+      user.state = :active
+    end
+
+But now there's an easier way!
+
+    user = User.unprotected_new(
+      name: 'Some Name',
+      email: 'test@example.com',
+      ...
+      is_admin: true,
+      state: :active
+    )
+
+In addition to `unprotected_new`, this gem provides these instance methods to `ActiveRecord::Base`:
+
+* `unprotected_attributes=`
+* `unprotected_update_attributes`/`unprotected_update_attributes!`
+
+and these class methods:
+
+* `unprotected_new`
+* `unprotected_create`/`unprotected_create!`
+
+Thank you, Active Record, for always protecting me when I want you to. But sometimes I don't. Don't protect me for a second while I sneak in and change some protected attributes...
+
+More examples:
+
+    user = User.unprotected_create!(
+      name: 'Some Name',
+      email: 'test@example.com',
+      ...
+      is_admin: true,
+      state: :active
+    )
+
+    if user.unprotected_update_attributes(name: 'New name', is_admin: false)
+      ...
+    end
+
+It also appears to work with associations:
+
+    user.memberships.unprotected_create!(state: 'active')
+
+Installation
+============
+
+Add to your Gemfile:
+
+    group :test do
+      gem 'let_me_mass_assign_protected_attributes'
+    end
+
+Further reading
+===============
+
+* http://api.rubyonrails.org/classes/ActiveRecord/Base.html (for information about `attr_accessible`/`attr_protected`)
+* http://railscasts.com/episodes/26-hackers-love-mass-assignment (for why you *should* be using `attr_accessible`/`attr_protected`)
+
+To do
+=====
+
+* Add tests
+
+Contributing
+============
+
+Comments and contributions are welcome.
+
+Please feel free to fork the project at https://github.com/TylerRick/let_me_mass_assign_protected_attributes and to send pull requests.
+
+Bugs can be reported at https://github.com/TylerRick/let_me_mass_assign_protected_attributes/issues
+
+License
+=======
+
+Copyright 2011, Tyler Rick
+
+This is free software, distributed under the terms of the MIT License.

data/let_me_mass_assign_protected_attributes.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "let_me_mass_assign_protected_attributes/version"
+
+Gem::Specification.new do |s|
+  s.name        = "let_me_mass_assign_protected_attributes"
+  s.version     = LetMeMassAssignProtectedAttributes::Version
+  s.authors     = ["Tyler Rick"]
+  s.email       = ["tyler@tylerrick.com"]
+  s.homepage    = ""
+  s.summary     = %q{Thank you, Active Record, for not letting me mass-assign protected attributes. But sometimes I want to anyway. This gem provides unprotected_update_attributes, unprotected_create, and related methods to ActiveRecord::Base.}
+  s.description = s.summary
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/let_me_mass_assign_protected_attributes.rb

@@ -0,0 +1,61 @@
+require "let_me_mass_assign_protected_attributes/version"
+
+module LetMeMassAssignProtectedAttributes
+  extend ActiveSupport::Concern
+
+  def unprotected_attributes=(attributes)
+    self.tap do
+      attributes.each do |key, value|
+        self.send "#{key}=", value
+      end
+    end
+  end
+
+  # update_attributes doesn't set attributes protected via attr_protected (instead, it logs a warning informing you that you are trying to mass-assign protected attributes), so this method is convenient if you have a hash of protected attributes that you want to set
+  def unprotected_update_attributes(attributes)
+    self.tap do
+      self.unprotected_attributes = attributes
+      save
+    end
+  end
+
+  # Updates an object just like Base.unprotected_update_attributes but calls save! instead of save so an exception is raised if the record is invalid.
+  def unprotected_update_attributes!(attributes)
+    self.tap do
+      self.unprotected_attributes = attributes
+      save!
+    end
+  end
+
+  module ClassMethods
+    # The same as a normal new, only it lets you initialize/set attr_protected attributes
+    def unprotected_new(attributes = {})
+      if attributes.is_a?(Array)
+        attributes.each {|attributes| unprotected_new(attributes) }
+      else
+        self.unprotected_attributes = attributes
+      end
+    end
+
+    # The same as a normal create, only it lets you initialize/set attr_protected attributes
+    def unprotected_create(attributes = {})
+      if attributes.is_a?(Array)
+        attributes.each {|attributes| unprotected_create(attributes) }
+      else
+        new.unprotected_update_attributes(attributes)
+      end
+    end
+
+    def unprotected_create!(attributes = {})
+      if attributes.is_a?(Array)
+        attributes.each {|attributes| unprotected_create!(attributes) }
+      else
+        new.unprotected_update_attributes!(attributes)
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.class_eval do
+  include LetMeMassAssignProtectedAttributes
+end

data/lib/let_me_mass_assign_protected_attributes/version.rb

@@ -0,0 +1,3 @@
+module LetMeMassAssignProtectedAttributes
+  Version = "0.0.1"
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: let_me_mass_assign_protected_attributes
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Tyler Rick
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-08 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Thank you, Active Record, for not letting me mass-assign protected attributes. But sometimes I want to anyway. This gem provides unprotected_update_attributes, unprotected_create, and related methods to ActiveRecord::Base.
+email: 
+- tyler@tylerrick.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- Readme.md
+- let_me_mass_assign_protected_attributes.gemspec
+- lib/let_me_mass_assign_protected_attributes.rb
+- lib/let_me_mass_assign_protected_attributes/version.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Thank you, Active Record, for not letting me mass-assign protected attributes. But sometimes I want to anyway. This gem provides unprotected_update_attributes, unprotected_create, and related methods to ActiveRecord::Base.
+test_files: []
+