extended_attributes 1.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+.redcar
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,4 @@
+source :rubygems
+gem 'activerecord', '3.1.0'
+gem 'mysql2'
+gem 'rspec', '~> 2.6.0'

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+== extended_attributes
+
+Copyright (c) 2011 Chirantan Rajhans.
+
+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.md

@@ -0,0 +1,90 @@
+# Extended Attributes
+_Add custom behavior to your model attributes in ActiveRecord_
+
+How often do you have to have an instance method implemented in a model but only to work with just 1 attribute?
+
+```ruby 
+class User < ActiveRecord::Base
+
+  def first_name
+    name.split(' ').first
+  end
+  
+end 
+```
+
+But attributes are also objects at the end of the day right? Should the first_name method belong to the attribute name? With this gem you can extend your attribute by mixing modules with them or having attribute specific methods defined on them. Just like our relationship objects.
+
+In your Gemfile
+
+```ruby 
+gem 'extended_attributes'
+```
+
+
+```bash 
+$ bundle install
+```
+
+and now you can do:
+
+```ruby 
+class User < ActiveRecord::Base
+
+  extend_attribute :name do
+  
+    def first
+      split(' ').first
+    end
+  
+    def last
+      split(' ').last
+    end
+  
+  end
+  
+end 
+```
+
+And you will be able to do:
+
+```ruby 
+user = User.find(:first) 
+user.name # John Anderson 
+user.name.first # John 
+user.name.last # Anderson
+```
+
+Additionally, you can also have modules exteded on the attributes
+
+```ruby 
+module NameMethods
+
+  def first
+    split(' ').first
+  end
+  
+  def last
+    split(' ').last
+  end
+
+end
+
+class User < ActiveRecord::Base
+
+  extend_attribute :name, :extend => NameMethods
+  
+end
+```
+
+### Why?
+
+Extending attributes adds modularity to your design, better object orientation and makes interfaces clean.
+
+### Dealing with Fixnum
+
+[Fixnums cannot have singleton methods](www.ruby-forum.com/topic/50170). Thus, if you try to extend an attribute that is a Fixnum, the whole behavior will be `include`d on Fixnum class, which means that the same behavior will be available on all instances of Fixnum throughout your application. So be careful with them.
+
+### Note
+
+This gem was developed because I liked it and it serves my purpose. Feel free to add to it. I’ll be happy to accept pull requests.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'bundler'
+Bundler.setup :default, :development
+
+desc 'Default: run specs'
+task :default => :spec  
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "spec/**/*_spec.rb"
+end
+
+Bundler::GemHelper.install_tasks

data/extended_attributes.gemspec

@@ -0,0 +1,20 @@
+$:.push File.dirname(__FILE__) + '/lib'
+require 'extended_attributes.rb'
+
+Gem::Specification.new do |gem|
+  gem.name = %q{extended_attributes}
+  gem.authors = ["Chirantan Rajhans"]
+  gem.date = %q{2011-10-10}
+  gem.description = %q{Extend behavior of attributes of your active record models.}
+  gem.summary = "Objectify your active record attributes."
+  gem.email = %q{chirantan.rajhans@gmail.com}
+  gem.homepage = 'http://github.com/chirantan'
+
+  gem.add_runtime_dependency 'active_record', '< 3.1.0'
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.require_paths = ['lib']
+  gem.version       = '1.0.1'
+end

data/lib/extended_attributes.rb

@@ -0,0 +1,37 @@
+require 'active_support'
+require 'active_record'
+
+module ActiveRecord
+  class Base
+    class << self
+      def extend_attribute(attr, options = {}, &block)
+        after_initialize ExtendAttribute.new(attr, options, block)
+        after_find       ExtendAttribute.new(attr, options, block)
+      end
+    end
+
+    class ExtendAttribute
+
+      def initialize(attr, options = {}, block = nil)
+        @attr = attr
+        @options = options
+        @block = block
+      end
+
+      def after_initialize(record)
+        modules = [*@options[:extend]].compact
+        modules << Module.new(&@block) if @block
+        modules.each do |mod|
+          attribute = record.send(@attr)
+          unless attribute.is_a? Fixnum
+            attribute.extend mod
+          else
+            Fixnum.send(:include, mod)
+          end
+        end
+      end
+      alias :after_find :after_initialize
+
+    end
+  end
+end

data/spec/date_methods.rb

@@ -0,0 +1,8 @@
+module DateMethods
+  
+  def age
+    now = Time.now.utc.to_date
+    now.year - self.year - ((now.month > self.month || (now.month == self.month && now.day >= self.day)) ? 0 : 1)
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+require 'rubygems'
+require 'active_record'
+require File.expand_path(File.dirname(__FILE__) + '/user.rb')
+
+ActiveRecord::Base.establish_connection(
+  :adapter  => 'mysql2',
+  :host     => 'localhost',
+  :username => 'root',
+  :password => 'admin',
+  :database => 'extend_attributes_test',
+  :socket   => '/var/run/mysqld/mysqld.sock'
+)
+
+ActiveRecord::Schema.define do
+  drop_table :users rescue nil
+  create_table :users do |t|
+    t.string  :name
+    t.integer :work_experience
+    t.date    :dob
+  end
+end
+

data/spec/user.rb

@@ -0,0 +1,28 @@
+
+require File.expand_path(File.dirname(__FILE__) + '/date_methods.rb')
+require File.expand_path(File.dirname(__FILE__) + '/../lib/extended_attributes.rb')
+
+class User < ActiveRecord::Base
+  
+  extend_attribute :name do
+    def first
+      self.split(' ').first
+    end
+    
+    def last
+      self.split(' ').last
+    end    
+  end
+  
+  extend_attribute :work_experience do 
+    
+    def in_months
+      self * 12
+    end
+    
+  end
+  
+  extend_attribute :dob, :extend => DateMethods
+  
+  
+end

data/spec/user_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper.rb')
+
+describe User do
+  
+  before(:each) do
+    @user = User.create(
+      :name            => 'Chirantan Rajhans',
+      :work_experience => 3,
+      :dob             => Date.parse("6th February 1986")
+    ) 
+  end
+  
+  
+  it 'should extend name attribute with "first" and "last" methods' do
+    @user.name.first.should == 'Chirantan'
+    @user.name.last.should  == 'Rajhans'
+  end
+  
+  it 'should extend work_experience attribute with "in_months" method' do
+    @user.work_experience.in_months.should == 36
+  end
+  
+  it 'should extend dob attribute with DateMethods module' do
+    @user.dob.age.should == 25
+  end
+  
+end
+  

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: extended_attributes
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 1
+  version: 1.0.1
+platform: ruby
+authors: 
+- Chirantan Rajhans
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-10-10 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: active_record
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - <
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 3
+        - 1
+        - 0
+        version: 3.1.0
+  type: :runtime
+  version_requirements: *id001
+description: Extend behavior of attributes of your active record models.
+email: chirantan.rajhans@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- extended_attributes-1.0.0.gem
+- extended_attributes.gemspec
+- lib/extended_attributes.rb
+- spec/date_methods.rb
+- spec/spec_helper.rb
+- spec/user.rb
+- spec/user_spec.rb
+homepage: http://github.com/chirantan
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Objectify your active record attributes.
+test_files: []
+