normalize_it 1.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+  gem "rcov", ">= 0"
+end
+
+group :test do
+  gem 'rspec', '~> 2.3.0'
+  gem 'rspec-rails'
+  gem 'activerecord', '~> 3.0.0'
+  gem 'sqlite3'
+end

data/Gemfile.lock

@@ -0,0 +1,77 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionpack (3.0.9)
+      activemodel (= 3.0.9)
+      activesupport (= 3.0.9)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.9)
+      activesupport (= 3.0.9)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.9)
+      activemodel (= 3.0.9)
+      activesupport (= 3.0.9)
+      arel (~> 2.0.10)
+      tzinfo (~> 0.3.23)
+    activesupport (3.0.9)
+    arel (2.0.10)
+    builder (2.1.2)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rack (1.2.3)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    railties (3.0.9)
+      actionpack (= 3.0.9)
+      activesupport (= 3.0.9)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.4)
+    rake (0.9.2)
+    rcov (0.9.9)
+    rdoc (3.9.2)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    rspec-rails (2.3.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.3.0)
+    sqlite3 (1.3.3)
+    thor (0.14.6)
+    tzinfo (0.3.29)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord (~> 3.0.0)
+  bundler (~> 1.0.0)
+  jeweler (~> 1.5.2)
+  rcov
+  rspec (~> 2.3.0)
+  rspec-rails
+  sqlite3

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Dave Havlicek
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,70 @@
+= normalize_it
+
+normalize_it makes it easy to seamlessly manage database tables that have been normalized.
+
+Example:
+
+  create_table :customer_statuses, :force => true do |t|
+    t.string :customer_status
+  end
+
+  create_table :email_addresses, :force => true do |t|
+    t.string :email_address
+  end
+
+  create_table :customers, :force => true do |t|
+    t.string  :name
+    t.integer :customer_status_id
+    t.integer :email_address_id
+  end
+
+  class CustomerStatus < ActiveRecord::Base
+    normalizes :customers, :with_field => :customer_status
+    validates :customer_status, :presence => true
+    validates_uniqueness_of :customer_status
+  end
+  
+  class EmailAddress < ActiveRecord::Base
+    normalizes :customers, :allow_inserts => true
+    validates :email_address, :presence => true
+    validates_uniqueness_of :email_address
+  end
+  
+  class Customer < ActiveRecord::Base
+    has_normalized :customer_status
+    has_normalized :email_address, :allow_inserts => true
+  end
+
+  after calling normalizes:
+    * if :allow_inserts is false (default), a :with_field argument must be passed in
+    ** new objects of CustomerStatus may not be created by the app
+    ** CustomerStatus objects may be referenced by [] notation, eg CustomerStatus[:new] or CustomerStatus['new']
+    ** CustomerStatus is given a has_many association to Customer, has_many options may be passed in to normalizes
+    * if :allow_inserts is true
+    ** only the has_many association is set up
+    ** [] notation may be used only if the :with_field option is passed
+
+  after calling has_normalized:
+    * if :allow_inserts is false (default)
+    ** customer.customer_status = 'new' will only search for CustomerStatus['new'] and assign it if it is found
+    * if :allow_inserts is true
+    ** customer.email_address = 'x@example.com' will search for the email address, and create it if not found
+    * all columns on the normalized tables are delegated to the parent object. e.g. customer.email_address
+    * static rails-like finders may be used. e.g. Customer.find_by_email_address 'x@example.com'
+    * new objects may be initialized either with attributes or through later assignment. e.g. Customer.new(:email_address => 'x@example.com')
+
+== Contributing to normalize_it
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Dave Havlicek. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "normalize_it"
+  gem.homepage = "http://github.com/snex/normalize_it"
+  gem.license = "MIT"
+  gem.summary = %Q{normalize_it makes it easy to seamlessly manage database tables that have been normalized.}
+  gem.description = %Q{Seamlessly deal with database tables with normalized info. Auto-generation of relationships
+                       and delegators.}
+  gem.email = "xens@comcast.net"
+  gem.authors = ["Dave Havlicek"]
+  gem.files.exclude '.rvmrc'
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "normalize_it #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/init.rb

@@ -0,0 +1 @@
+require 'normalize_it'

data/lib/normalize_it.rb

@@ -0,0 +1,168 @@
+module NormalizeIt
+
+  class NormalizeItException < Exception ; end
+
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+
+  #normalize_it makes it easy to seamlessly manage database tables that have been normalized.
+  #
+  #Example:
+  #
+  #  create_table :customer_statuses, :force => true do |t|
+  #    t.string :customer_status
+  #  end
+  #
+  #  create_table :email_addresses, :force => true do |t|
+  #    t.string :email_address
+  #  end
+  #
+  #  create_table :customers, :force => true do |t|
+  #    t.string  :name
+  #    t.integer :customer_status_id
+  #    t.integer :email_address_id
+  #  end
+  #
+  #  class CustomerStatus < ActiveRecord::Base
+  #    normalizes :customers, :with_field => :customer_status
+  #    validates :customer_status, :presence => true
+  #    validates_uniqueness_of :customer_status
+  #  end
+  #  
+  #  class EmailAddress < ActiveRecord::Base
+  #    normalizes :customers, :allow_inserts => true
+  #    validates :email_address, :presence => true
+  #    validates_uniqueness_of :email_address
+  #  end
+  #  
+  #  class Customer < ActiveRecord::Base
+  #    has_normalized :customer_status
+  #    has_normalized :email_address, :allow_inserts => true
+  #  end
+  #
+  #  after calling normalizes:
+  #    * if :allow_inserts is false (default), a :with_field argument must be passed in
+  #    ** new objects of CustomerStatus may not be created by the app
+  #    ** CustomerStatus objects may be referenced by [] notation, eg CustomerStatus[:new] or CustomerStatus['new']
+  #    ** CustomerStatus is given a has_many association to Customer, has_many options may be passed in to normalizes
+  #    * if :allow_inserts is true
+  #    ** only the has_many association is set up
+  #    ** [] notation may be used only if the :with_field option is passed
+  #
+  #  after calling has_normalized:
+  #    * if :allow_inserts is false (default)
+  #    ** customer.customer_status = 'new' will only search for CustomerStatus['new'] and assign it if it is found
+  #    * if :allow_inserts is true
+  #    ** customer.email_address = 'x@example.com' will search for the email address, and create it if not found
+  #    * all columns on the normalized tables are delegated to the parent object. e.g. customer.email_address
+  #    * static rails-like finders may be used. e.g. Customer.find_by_email_address 'x@example.com'
+  #    * new objects may be initialized either with attributes or through later assignment. e.g. Customer.new(:email_address => 'x@example.com')
+
+  module ClassMethods
+    attr_reader :_normalized_models
+    
+    def has_normalized(model, options = {})
+      include NormalizeIt::BaseClassMethods
+      @_normalized_models ||= []
+      allow_inserts = options.try(:delete, :allow_inserts) || false
+      opts = { :class_name  => model.to_s.camelize,
+               :autosave    => true,
+               :foreign_key => model.to_s.foreign_key }.merge!(options)
+      belongs_to "__#{opts[:class_name].underscore}".to_sym, opts
+      validates "__#{opts[:class_name].underscore}".to_sym, :presence => true
+      validates_associated "__#{opts[:class_name].underscore}".to_sym
+      @_normalized_models << opts.merge( { :allow_inserts => allow_inserts } )
+      opts[:class_name].constantize.content_columns.each do |column|
+        next if ['created_at', 'updated_at'].include?(column.name)
+        delegate "#{column.name}", "#{column.name}?", :to => "__#{opts[:class_name].underscore}".to_sym
+        if allow_inserts
+          delegate "#{column.name}=", :to => "__#{opts[:class_name].underscore}".to_sym
+        else
+          self.class_eval do
+            define_method "#{column.name}=" do |value|
+              self.send("__#{opts[:class_name].underscore}=",
+                        value.is_a?(opts[:class_name].constantize) ? value :
+                                    opts[:class_name].constantize[value]
+                       )
+            end
+          end
+        end
+        eval <<-NEWFINDERS
+          def self.find_by_#{column.name} value
+            self.send("find_by_#{opts[:foreign_key]}",
+                      #{opts[:class_name]}.send("find_by_#{column.name}", value)
+                     )
+          end
+          def self.find_all_by_#{column.name} value
+            self.send("find_all_by_#{opts[:foreign_key]}",
+                      #{opts[:class_name]}.send("find_by_#{column.name}", value)
+                     )
+          end
+        NEWFINDERS
+      end
+
+      before_validation :handle_normalized_objects if allow_inserts
+    end
+
+    def normalizes(model, options = {})
+      include NormalizeIt::NormalizedClassMethods
+      allow_inserts = options.try(:delete, :allow_inserts) || false
+      if !allow_inserts
+        normalized_field = options.try(:delete, :with_field)
+        raise NormalizeItException, "Normalized field must be specified on static tables!" unless normalized_field
+        before_create :disallow_create unless allow_inserts
+        if normalized_field
+          eval <<-HASHNOTATIONACCESS
+            def self.[] value
+              @@#{self.name.underscore.pluralize} ||= HashWithIndifferentAccess.new
+              @@#{self.name.underscore.pluralize}[value] ||= find_by_#{normalized_field.to_s}(value.to_s)
+              @@#{self.name.underscore.pluralize}[value]
+            end
+          HASHNOTATIONACCESS
+        end
+      end
+      has_many model, options
+    end
+  end
+
+  module BaseClassMethods
+    attr_reader :_normalized_attributes
+
+    def initialize(attributes = {})
+      @_normalized_attributes = {}
+      self.class._normalized_models.each do |model_hash|
+        @_normalized_attributes[model_hash[:class_name].underscore.to_sym] ||= {}
+        attributes.each do |key, value|
+          if key.to_s.foreign_key == model_hash[:foreign_key]
+            @_normalized_attributes[model_hash[:class_name].underscore.to_sym][key] = attributes.delete(key)
+          end
+        end
+      end
+      super
+      @_normalized_attributes.each do |klass, attribs|
+        self.send("__#{klass.to_s}=", klass.to_s.camelize.constantize.new(attribs))
+      end
+    end
+
+    def handle_normalized_objects
+      self.transaction do
+        @_normalized_attributes.each do |klass, attribs|
+          existing_obj = klass.to_s.camelize.constantize.where( attribs ).first
+          if existing_obj
+            self.send("__#{klass.to_s}=", existing_obj)
+          end
+        end
+      end
+    end
+  end
+
+  module NormalizedClassMethods
+    def disallow_create
+      errors.add :base, "Creation of #{self.class} not allowed!"
+      false
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, NormalizeIt

data/normalize_it.gemspec

@@ -0,0 +1,68 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{normalize_it}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dave Havlicek"]
+  s.date = %q{2011-08-22}
+  s.description = %q{Seamlessly deal with database tables with normalized info. Auto-generation of relationships
+                       and delegators.}
+  s.email = %q{xens@comcast.net}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "init.rb",
+    "lib/normalize_it.rb",
+    "normalize_it.gemspec",
+    "spec/normalize_it_spec.rb",
+    "spec/schema.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/snex/normalize_it}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.0}
+  s.summary = %q{normalize_it makes it easy to seamlessly manage database tables that have been normalized.}
+  s.test_files = [
+    "spec/normalize_it_spec.rb",
+    "spec/schema.rb",
+    "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/spec/normalize_it_spec.rb

@@ -0,0 +1,94 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "NormalizeIt" do
+  describe "classes" do
+    it 'should hook in to AR:Base' do
+      ActiveRecord::Base.should respond_to :has_normalized
+      ActiveRecord::Base.should respond_to :normalizes
+    end
+
+    it "should error if a static lookup class is defined without specifying which field is being normalized" do
+      expect { class NewField < ActiveRecord::Base
+                 normalizes :customers, :allow_inserts => false
+               end
+             }.should raise_error NormalizeIt::NormalizeItException
+    end
+  end
+
+  describe "instances" do
+    it "should not allow creating a new customer_status" do
+      customer_status = CustomerStatus.new(:customer_status => 'old')
+      customer_status.save
+      customer_status.errors.should == {:base=>["Creation of CustomerStatus not allowed!"]}
+      expect { customer_status.save! }.should raise_error ActiveRecord::RecordNotSaved
+    end
+
+    it "should create a new customer by passing in normalized values through attributes" do
+      customer = Customer.new(:name => 'Dave Havlicek', :email_address => 'xens@comcast.net', :customer_status => 'new')
+      customer.save
+      Customer.should have(1).records
+      customer.email_address.should == 'xens@comcast.net'
+      customer.customer_status.should == 'new'
+    end
+
+    it "should create a new customer by calling new and then assigning attributes" do
+      customer = Customer.new(:name => 'Dave Havlicek')
+      customer.email_address = 'xens@comcast.net'
+      customer.customer_status = 'new'
+      customer.save
+      Customer.should have(1).records
+      customer.email_address.should == 'xens@comcast.net'
+      customer.customer_status.should == 'new'
+    end
+
+    it "should use already-existing objects for attributes" do
+      email_address = EmailAddress.create(:email_address => 'xens@comcast.net')
+      customer_status = CustomerStatus.find_by_customer_status 'new'
+      customer = Customer.new(:name => 'Dave Havlicek', :email_address => 'xens@comcast.net', :customer_status => 'new')
+      customer.save
+      Customer.should have(1).records
+      customer.email_address_id.should == email_address.id
+      customer.customer_status_id.should == customer_status.id
+    end
+
+    it "should not fail if normalized objects are created before the original object is saved" do
+      customer = Customer.new(:name => 'Dave Havlicek', :email_address => 'xens@comcast.net', :customer_status => 'new')
+      email_address = EmailAddress.create(:email_address => 'xens@comcast.net')
+      customer_status = CustomerStatus.find_by_customer_status 'new'
+      customer.save
+      Customer.should have(1).records
+      customer.email_address_id.should == email_address.id
+      customer.customer_status_id.should == customer_status.id
+    end
+
+    it "should be able to use a rails-like finder to find objects by normalized attributes" do
+      customer = Customer.new(:name => 'Dave Havlicek', :email_address => 'xens@comcast.net', :customer_status => 'new')
+      customer.save
+      customers = Customer.find_all_by_email_address 'xens@comcast.net'
+      customers.size.should == 1
+      customers.first.should == customer
+    end
+
+    it "should be able to combine rails-like finders" do
+      pending "it would be nice to have this feature someday" do
+        customer = Customer.new(:name => 'Dave Havlicek', :email_address => 'xens@comcast.net', :customer_status => 'new')
+        customer.save
+        customer_1 = Customer.find_by_email_address_and_customer_status_and_name 'xens@comcast.net', 'new', 'Dave Havlicek'
+        customer_1.should == customer
+      end
+    end
+
+    it "should not break original rails finders" do
+      customer = Customer.new(:name => 'Dave Havlicek', :email_address => 'xens@comcast.net', :customer_status => 'new')
+      customer.save
+      customer_1 = Customer.find_by_name 'Dave Havlicek'
+      customer_1.should == customer
+    end
+
+    it "should allow referencing static lookup models with [] notation" do
+      customer_status = CustomerStatus.find_by_customer_status 'new'
+      CustomerStatus[:new].should == customer_status
+      CustomerStatus['new'].should == customer_status
+    end
+  end
+end

data/spec/schema.rb

@@ -0,0 +1,15 @@
+ActiveRecord::Schema.define(:version => 0) do
+  create_table :customer_statuses, :force => true do |t|
+    t.string :customer_status
+  end
+
+  create_table :email_addresses, :force => true do |t|
+    t.string :email_address
+  end
+
+  create_table :customers, :force => true do |t|
+    t.string  :name
+    t.integer :customer_status_id
+    t.integer :email_address_id
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,41 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'rubygems'
+require 'active_record'
+require 'rspec/rails/extensions'
+require 'rspec/rails/matchers'
+require 'rspec/rails/adapters'
+require 'rspec/rails/fixture_support'
+require 'normalize_it'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.use_transactional_examples = true  
+end
+
+ActiveRecord::Base.configurations={'test' => {:adapter => "sqlite3", :database => ":memory:"} }
+ActiveRecord::Base.establish_connection('test')
+load(File.dirname(__FILE__) + "/schema.rb")
+
+class CustomerStatus < ActiveRecord::Base
+  normalizes :customers, :with_field => :customer_status
+  validates :customer_status, :presence => true
+  validates_uniqueness_of :customer_status
+end
+
+class EmailAddress < ActiveRecord::Base
+  normalizes :customers, :allow_inserts => true
+  validates :email_address, :presence => true
+  validates_uniqueness_of :email_address
+end
+
+class Customer < ActiveRecord::Base
+  has_normalized :customer_status
+  has_normalized :email_address, :allow_inserts => true
+end
+
+ActiveRecord::Base.connection.execute("INSERT INTO customer_statuses (customer_status) VALUES ('new')")

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification 
+name: normalize_it
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Dave Havlicek
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-22 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+description: |-
+  Seamlessly deal with database tables with normalized info. Auto-generation of relationships
+                         and delegators.
+email: xens@comcast.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- init.rb
+- lib/normalize_it.rb
+- normalize_it.gemspec
+- spec/normalize_it_spec.rb
+- spec/schema.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/snex/normalize_it
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -807153901
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.0
+signing_key: 
+specification_version: 3
+summary: normalize_it makes it easy to seamlessly manage database tables that have been normalized.
+test_files: 
+- spec/normalize_it_spec.rb
+- spec/schema.rb
+- spec/spec_helper.rb