stipulate 1.0.5

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 stipulate.gemspec
+gemspec

data/README

@@ -0,0 +1,38 @@
+== Info ===========================================================
+This gem was developed by Jonathan Martin for use in a number of Rails projects. Very often "statusesque" string fields are used for maximum flexibility in designing state-sensitive models, such as a "pending" order or an "inactive" user. Homebrew solutions leave the individual statuses undocumented and require string sensitive comparisons. This gem introduces readability and adds some convenient method generation so that code remains readable, but just as flexible as the string field backing it.
+
+Be sure to check out www.nybblr.com for other Rails goodies, and if you're looking for more of my gems (when I get around to it!) go to nybblr.com/gems.
+
+== Why Stipulate? ====================================================
+If you don't specify what conditions apply, you might get sued.
+
+== Usage ==========================================================
+From your ActiveRecord model, simply call the stipulate method for each enumeratable type field:
+
+class User < ActiveRecord::Base
+	# Example usages
+	stipulate :that => :status, :can_be => [:active, :inactive, :pending, :suspended]
+
+	stipulate :that => :type, :can_be => [:admin, :moderator, :end_user]
+	
+	puts statuses # => "[:active, :inactive, :pending, :suspended]"
+
+end
+
+The stipulate method adds some convenience methods. As shown, a class method with the enumerated types is generated (for use in dropdowns, like this simple_form example):
+
+<%= simple_form_for :user do |f| %>
+	<%= f.input :status,
+		:as => :select,
+		:collection => User.statuses.collect {|r| [r.to_s.titleize, r] } if can? :alter_role, f.object %>
+<% end %>
+
+For each enumeration, a boolean check method is generated:
+
+User.last.admin?
+
+To make sure CanCan works with cached DB objects, you can set the field as you normally would with a symbol or a string; both will be converted to a string, so in CanCan you can simply call:
+
+can :edit, User, :status => "active"
+
+...and not need to worry if a symbol was assigned to the in-memory object. Symbols are preferred for assigning because they emphasize the finiteness of inputs (there are only so many different statuses), they stand out from regular strings, and they enforce lowercase convention.

data/Rakefile

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

data/lib/stipulate.rb

@@ -0,0 +1,53 @@
+require "stipulate/version"
+
+module Stipulate
+	def self.included(mod)
+		mod.extend ClassMethods
+	end
+	
+	module ClassMethods
+		def stipulate(opts={})
+			method = opts[:that].to_s
+			enumeration = method.pluralize
+		
+			singleton_class.class_eval <<-"END"
+				cattr_accessor :#{enumeration}
+			END
+			
+			# If the method is customized, we want to retain changes through a wrapper
+			if instance_methods.include? method.to_sym
+				class_eval <<-"END"
+					# Ensure fields are converted to string
+					def #{method}_with_stipulation
+						v = #{method}_without_stipulation
+						v.nil? ? nil : v.to_s
+					end
+				END
+	
+				alias_method_chain method.to_sym, :stipulation
+			else
+				class_eval <<-"END"
+					# Ensure fields are converted to string
+					def #{method}
+						v = attributes["#{method}"]
+						v.nil? ? nil : v.to_s
+					end
+				END
+			end
+			
+			singleton_class.send :"#{enumeration}=", opts[:can_be]
+			
+			for enum in opts[:can_be] do
+				class_eval <<-"END"
+				  def #{enum}?
+						#{method}.to_s.to_sym == :#{enum}
+				  end
+				END
+			end
+		end
+	end
+end
+
+class ActiveRecord::Base
+	include Stipulate
+end

data/lib/stipulate/version.rb

@@ -0,0 +1,3 @@
+module Stipulate
+  VERSION = "1.0.5"
+end

data/stipulate.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "stipulate/version"
+
+Gem::Specification.new do |s|
+  s.name        = "stipulate"
+  s.version     = Stipulate::VERSION
+  s.authors     = ["Jonathan Martin"]
+  s.email       = ["me@nybblr.com"]
+  s.homepage    = "http://nybblr.com"
+  s.summary     = %q{Very often "statusesque" string fields are used for maximum flexibility in designing state-sensitive models, such as a "pending" order or an "inactive" user. Homebrew solutions leave the individual statuses undocumented and require string sensitive comparisons. This gem introduces readability and adds some convenient method generation so that code remains readable, but just as flexible as the string field backing it. Be sure to check out www.nybblr.com for other Rails goodies, and if you're looking for more of my gems (when I get around to it!) go to nybblr.com/gems.}
+  s.description = %q{Enumeration helper for ActiveRecord string fields}
+
+  s.rubyforge_project = "stipulate"
+
+  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"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: stipulate
+version: !ruby/object:Gem::Version
+  version: 1.0.5
+  prerelease: 
+platform: ruby
+authors:
+- Jonathan Martin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-10 00:00:00.000000000Z
+dependencies: []
+description: Enumeration helper for ActiveRecord string fields
+email:
+- me@nybblr.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- lib/stipulate.rb
+- lib/stipulate/version.rb
+- stipulate.gemspec
+homepage: http://nybblr.com
+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: stipulate
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Very often "statusesque" string fields are used for maximum flexibility in
+  designing state-sensitive models, such as a "pending" order or an "inactive" user.
+  Homebrew solutions leave the individual statuses undocumented and require string
+  sensitive comparisons. This gem introduces readability and adds some convenient
+  method generation so that code remains readable, but just as flexible as the string
+  field backing it. Be sure to check out www.nybblr.com for other Rails goodies, and
+  if you're looking for more of my gems (when I get around to it!) go to nybblr.com/gems.
+test_files: []