not_my_job 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.rvmrc
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+group :development, :test do
+  gem 'rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,18 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.2)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rspec

data/README.md

@@ -0,0 +1,93 @@
+#Not My Job
+
+Also known as EmpleadoPublico ;) provides a delegate class method to easily expose contained object's methods as your own.
+
+## Installation
+
+Add this line to your application's Gemfile:
+```
+gem 'not_my_job'
+```
+And then execute:
+```
+$ bundle install
+```
+Or install it yourself as:
+```
+$ gem install not_my_job
+```
+
+## Usage
+```
+  delegate(*methods, to: target [, with_prefix: true|false ]) { block } → obj
+```
+In order to access the delegate object's methods, NotMyJob creates instance methods for each one specified method.
+
+If the delegate object is nil, there are several options: If no block is provided, it will raise an NoMethodError exception; if the optional code block is specified, then that will be run and its result returned.
+
+## Examples
+
+Simple delegation:
+```ruby
+class Cuisine
+  attr_accessor :name, :chef
+  
+  def initialize(name, chef)
+    @name = name
+    @chef = chef
+  end
+end
+
+class Restaurant
+  extend NotMyJob
+  
+  delegate :name, to: :cuisine
+  delegate :chef, to: :cuisine, with_prefix: false
+  
+  def initialize(cuisine)
+    @cuisine = cuisine
+  end
+end
+
+cuisine    = Cuisine.new("Italian", "Mario") 
+restaurant = Restauran.new(cuisine)
+
+restaurant.cuisine_name #=> "Italian"
+restaurant.chef         #=> "Mario"
+```
+
+Multiple methods delegation:
+```ruby
+class Restaurant
+  extend NotMyJob
+  delegate :name, :chef to: :cuisine
+end
+
+restaurant.cuisine_name #=> "Italian"
+restaurant.cuisine_chef #=> "Mario"
+```
+
+ActiveRecord Associations:
+```ruby
+class Restaurant < ActiveRecord::Base
+  extend NotMyJob
+  
+  belongs_to :place
+  delegate :name, to: :place
+end
+restaurant.place_name #=> "Argentina"
+```
+
+If the delegate object is nil and a block is provided:
+```ruby
+class Restaurant
+  extend NotMyJob
+  
+  delegate :name, to: :category do
+    logger.debug "Category is nil"
+    send_notification_email
+    "No category has been assigned to this restaurant"
+  end
+end
+restaurant.category_name #=> "No category has been assigned to this restaurant"
+```

data/lib/not_my_job.rb

@@ -0,0 +1,28 @@
+module NotMyJob
+
+  def delegate(*methods, options, &block)
+    unless options.is_a? Hash
+      raise ArgumentError, "At least one method and the :to option are required."
+    end
+
+    to = options.fetch(:to) do
+      raise ArgumentError, "The :to option is required."
+    end
+
+    with_prefix = options.fetch(:with_prefix, true)
+    method_prefix = with_prefix ? "#{to}_" : ""
+
+    methods.each do |method|
+      method_name = "#{method_prefix}#{method}"
+
+      define_method method_name do
+        begin
+          object = instance_variable_get("@#{to}") || self.send(to)
+          object.public_send method
+        rescue NoMethodError
+          block_given? ? yield : raise
+        end
+      end
+    end
+  end
+end

data/not_my_job.gemspec

@@ -0,0 +1,15 @@
+#encoding: utf-8
+
+Gem::Specification.new do |gem|
+  gem.name        = "not_my_job"
+  gem.version     = "0.0.1"
+  gem.summary     = "Provides a delegate class method to easily expose contained object's methods as your own."
+  gem.description = "Provides a delegate class method to easily expose contained object's methods as your own. If an optional code block is specified, then that will be run and its result returned when the delegate object is nil."
+  gem.author      = "Alfredo Ramírez"
+  gem.email       = "alfredormz@gmail.com"
+  gem.homepage    = 'http://github.com/alfredormz/not_my_job'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.add_development_dependency "rspec"
+end

data/spec/not_my_job_spec.rb

@@ -0,0 +1,90 @@
+require 'spec_helper'
+require 'ostruct'
+
+describe Module do
+
+  class Place
+    attr_accessor :name, :latitude, :longitude
+    def initialize(name, latitude=nil, longitude=nil)
+      @name      = name
+      @latitude  = latitude
+      @longitude = longitude
+    end
+  end
+
+  class Restaurant
+    extend NotMyJob
+
+    attr_accessor :place
+    def initialize(place=nil)
+      @place = place || Place.new("Argentina", -34, -58)
+    end
+
+    def category
+      OpenStruct.new(name: "Italian")
+    end
+  end
+
+  context "Simple delegation" do
+    let(:restaurant) do
+      class Restaurant
+        delegate :name, to: :place
+        delegate :latitude, to: :place, with_prefix: false
+        delegate :name, to: :category
+      end
+
+      Restaurant.new
+    end
+
+    it {expect(restaurant.respond_to? :place_name).to be_true }
+    it {expect(restaurant.respond_to? :latitude).to be_true }
+    it {expect(restaurant.respond_to? :category_name).to be_true }
+
+    it {expect(restaurant.place_name).to eq "Argentina"}
+    it {expect(restaurant.latitude).to eq(-34)}
+    it {expect(restaurant.category_name).to eq "Italian" }
+  end
+
+  context "Delegate multiple methods" do
+    let(:restaurant) do
+      class Restaurant
+        delegate :name, :latitude, :longitude, to: :place
+      end
+
+      Restaurant.new
+    end
+
+    it {expect(restaurant.respond_to? :place_name).to be_true }
+    it {expect(restaurant.respond_to? :place_latitude).to be_true }
+    it {expect(restaurant.respond_to? :place_longitude).to be_true }
+
+    it {expect(restaurant.place_name).to eq "Argentina"}
+    it {expect(restaurant.place_latitude).to eq(-34)}
+    it {expect(restaurant.place_longitude).to eq(-58)}
+  end
+
+  context "The delegate object is nil" do
+    let(:restaurant) do
+      class Restaurant
+        delegate :name, to: :some_object
+      end
+
+      Restaurant.new
+    end
+    it {expect{restaurant.some_object_name}.to raise_error(NoMethodError)}
+  end
+
+  context "The delegate object is nil but a block is provided" do
+    let(:restaurant) do
+      class Restaurant
+        delegate :name, to: :some_object do
+          "No data found"
+        end
+      end
+
+      Restaurant.new
+    end
+    it {expect(restaurant.some_object_name).to eq "No data found"}
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require './lib/not_my_job'

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: not_my_job
+version: !ruby/object:Gem::Version
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors:
+- Alfredo Ramírez
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  type: :development
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: rspec
+description: Provides a delegate class method to easily expose contained object's
+  methods as your own. If an optional code block is specified, then that will be run
+  and its result returned when the delegate object is nil.
+email: alfredormz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- lib/not_my_job.rb
+- not_my_job.gemspec
+- spec/not_my_job_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/alfredormz/not_my_job
+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.24
+signing_key: 
+specification_version: 3
+summary: Provides a delegate class method to easily expose contained object's methods
+  as your own.
+test_files:
+- spec/not_my_job_spec.rb
+- spec/spec_helper.rb