normalize 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.lock
+*.gem

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format s

data/.rvmrc

@@ -0,0 +1,3 @@
+rvm 1.9.3
+rvm_gemset_create_on_use_flag=1
+rvm gemset use normalize

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+
+gemspec
+
+gem 'rspec'
+gem 'sqlite3'

data/README.md

@@ -0,0 +1,47 @@
+# Normalize
+
+Normalize your attributes with ease.
+
+## Install
+
+Add normalize to your `Gemfile` like this:
+
+    gem 'normalize'
+
+## Usage
+
+Create a directory `app/normalizers` in your Rails project. This directory will
+contain your normalizers. A normalizer is a class that responds to `call` with
+the value that has to be normalized and returns the normalized value.
+
+Example URL normalizer:
+
+    class UrlNormalizer
+      def self.call(input)
+        url = input.dup
+        url.prepend('http://') unless url =~ %r{^[a-zA-Z]+://}
+        
+        begin
+          uri = URI.parse(url)
+          uri.scheme = uri.scheme.downcase
+          uri.host   = uri.host.downcase
+        rescue
+          return input
+        end
+        
+        uri.to_s
+      end
+    end
+
+Now in your ActiveRecord model, simply use the `normalize` method to normalize
+input:
+
+    class Website < ActiveRecord::Base
+      normalize :url, with: UrlNormalizer
+    end
+
+## License
+
+Copyright 2011 Tom-Eric Gerritsen.
+You may use this work without restrictions, as long as this notice is included.
+The work is provided "as is" without warranty of any kind, neither express nor implied.

data/lib/normalize.rb

@@ -0,0 +1,39 @@
+require 'active_support/concern'
+
+module Normalize
+  extend ActiveSupport::Concern
+  
+  def normalize_value(value, normalizer)
+    normalizer.call(value)
+  end
+  
+  module ClassMethods
+    def normalize(attribute, options)
+      normalizer = extract_normalizer(options)
+      
+      class_eval do
+        if method_defined? "#{attribute}="
+          define_method "#{attribute}_with_normalizer=" do |value|
+            send("#{attribute}_without_normalizer=", normalize_value(value, normalizer))
+          end
+          alias_method_chain "#{attribute}=", :normalizer
+        else
+          define_method "#{attribute}=" do |value|
+            super(normalize_value(value, normalizer))
+          end
+        end
+      end
+    end
+    
+    def extract_normalizer(options_or_normalizer)
+      if options_or_normalizer.respond_to?(:[])
+        options_or_normalizer[:with]
+      else
+        options_or_normalizer
+      end
+    end
+  end
+end
+
+require 'active_record'
+ActiveRecord::Base.send(:include, Normalize)

data/normalize.gemspec

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+Gem::Specification.new do |s|
+  s.name           = 'normalize'
+  s.version        = '0.0.1'
+  s.platform       = Gem::Platform::RUBY
+  s.authors        = ['Tom-Eric Gerritsen']
+  s.email          = 'ik@tom-eric.info'
+  s.homepage       = 'https://github.com/tomeric/normalize'
+  s.summary        = 'The attribute normalizer.'
+  s.description    = 'The attribute normalizer.'
+  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']
+  s.add_dependency 'activerecord', '~> 3.0'
+end

data/spec/lib/normalize_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe Normalize do
+  it 'is included in ActiveRecord::Base' do
+    ActiveRecord::Base.should include(Normalize)
+  end
+  
+  describe 'instance methods' do
+    class NormalizedObject
+      include Normalize
+    end
+    
+    let(:normalizer) { NormalizedObject.new }
+    
+    describe '#normalize_value' do
+      it 'normalizes the given value with the given normalizer' do
+        normalizer.normalize_value("string", -> input { input.upcase }).should == "STRING"
+      end
+    end
+  end
+  
+  context 'ActiveRecord Model' do
+    class Book < ActiveRecord::Base
+      normalize :title,  TitleNormalizer
+      normalize :author, with: AuthorNormalizer
+      normalize :isbn,   with: -> isbn { isbn.gsub(/[^0-9]/, '') }
+    end
+    
+    let(:object) { Book.new }
+    
+    it 'normalizes values with a normalizer class' do
+      object.title = 'A Bugs Life'
+      object.title.should == 'A BUGS LIFE'
+    end
+
+    it 'normalizes values with a normalizer class specified with an options hash' do
+      object.author = 'jack jones'
+      object.author.should == 'Jack Jones'
+    end
+
+    it 'normalizes values with a lambda specified with an options hash' do
+      object.isbn = '123-456-7890'
+      object.isbn.should == '1234567890'
+    end
+  end
+  
+  context 'Ruby Object' do
+    class Magazine
+      include Normalize
+      
+      attr_accessor :title
+      normalize :title, TitleNormalizer
+    end
+    
+    let(:object) { Magazine.new }
+    
+    it 'normalizes values with a normalizer class' do
+      object.title = 'A Bugs Life'
+      object.title.should == 'A BUGS LIFE'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'normalize'
+
+ActiveRecord::Base.silence do
+  ActiveRecord::Migration.verbose = false
+  ActiveRecord::Base.configurations = { 'test' => { adapter: 'sqlite3', database: ':memory:' } }
+  ActiveRecord::Base.establish_connection :test
+  
+  ActiveRecord::Schema.define version: 0 do
+    create_table 'books', force: true do |t|
+      t.string :title
+      t.string :author
+      t.string :isbn
+    end
+  end
+end
+
+class TitleNormalizer
+  def self.call(title)
+    title.upcase
+  end
+end
+
+class AuthorNormalizer
+  def self.call(author)
+    author.split(' ').map do |name|
+      name[0] = name[0].upcase
+      name
+    end.join(' ')
+  end
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: normalize
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tom-Eric Gerritsen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: &70140813674080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70140813674080
+description: The attribute normalizer.
+email: ik@tom-eric.info
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- README.md
+- lib/normalize.rb
+- normalize.gemspec
+- spec/lib/normalize_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/tomeric/normalize
+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.8.10
+signing_key: 
+specification_version: 3
+summary: The attribute normalizer.
+test_files:
+- spec/lib/normalize_spec.rb
+- spec/spec_helper.rb