named_parameter 0.0.4 → 0.0.5

data/README.md

@@ -1,4 +1,4 @@
-# Named Parameter `v0.0.3`
+# Named Parameter `v0.0.4`
 
 ## Description
 That you ever dream with named parameter in Ruby? Well, you doesn't have to pray to
@@ -69,6 +69,24 @@ If you like sigleton classes you will love that:
     Point.move_to(y: 30,x: 50)
 
 
+And that feature too:
+
+    require 'rubygems'
+    require 'named_parameter'
+     
+    class Point
+      extend NamedParameter
+      
+		  class << self
+		    named def move_to(x,y,z=0)
+		      puts "Moving to [#{x},#{y},#{z}]"
+		    end
+		  end
+    end
+    
+    Point.move_to(y: 30,x: 50)
+
+
 ## Use in production?
 **You (maybe)**:"Oh! Magic! I'll use in my production projects!"
 **Me**: Wait! Before use this in production, you have to know that gem

data/Rakefile

@@ -14,7 +14,7 @@ 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.version = "0.0.2"
+  gem.version = "0.0.5"
   gem.name = "named_parameter"
   gem.homepage = "http://github.com/hugolnx/named_parameter"
   gem.license = "MIT"

data/lib/named_parameter.rb

@@ -2,4 +2,6 @@ require 'named_parameter/named_method'
 require 'named_parameter/named_method_transmuter'
 require 'named_parameter/errors'
 require 'named_parameter/error'
+require 'named_parameter/named_above'
+require 'named_parameter/named_inline'
 require 'named_parameter/named_parameter'

data/lib/named_parameter/named_above.rb

@@ -0,0 +1,28 @@
+module NamedParameter
+  module NamedAbove
+  private
+    def above_named
+      @named_above = true
+    end
+
+    def self.above_singleton_named(klass)
+      klass.instance_variable_set(:@named_above, true)
+    end
+
+    def above_method_added(name)
+      if @named_above
+        @named_above = false
+        method = self.instance_method name
+        NamedMethodTransmuter.transmute method
+      end
+    end
+
+    def above_singleton_method_added(name)
+      if @named_above
+        @named_above = false
+        method = self.method name
+        NamedMethodTransmuter.transmute method
+      end
+    end
+  end
+end

data/lib/named_parameter/named_inline.rb

@@ -0,0 +1,21 @@
+module NamedParameter
+  module NamedInline
+  private
+    def inline_named
+      NamedMethodTransmuter.transmute @last_method_added
+    end
+
+    def self.inline_singleton_named(klass)
+      method = klass.instance_variable_get(:@last_method_added)
+      NamedMethodTransmuter.transmute method
+    end
+
+    def inline_method_added(name)
+      @last_method_added = self.instance_method name
+    end
+
+    def inline_singleton_method_added(name)
+      @last_method_added = self.method name
+    end
+  end
+end

data/lib/named_parameter/named_parameter.rb

@@ -1,24 +1,42 @@
 module NamedParameter
-  def named(def_return)
-    method = @last_method_added
-    NamedParameter::NamedMethodTransmuter.transmute method
+  include NamedAbove
+  include NamedInline
+
+  def named(above=true)
+    if above
+      above_named
+    else
+      inline_named
+    end
   end
 
   def self.extended(klass)
-    klass.singleton_class.instance_eval do
-      define_singleton_method :named do |def_return|
-        method = klass.instance_variable_get(:@last_method_added)
-        NamedParameter::NamedMethodTransmuter.transmute method
+    def_singleton_named(klass) do |above|
+      if above
+        NamedAbove.above_singleton_named(klass)
+      else
+        NamedInline.inline_singleton_named(klass)
       end
     end
   end
 
-  def method_added(method_name)
-    @last_method_added = self.instance_method(method_name)
+  def method_added(name)
+    inline_method_added name
+    above_method_added name
   end
 
 
-  def singleton_method_added(method_name)
-    @last_method_added = self.method(method_name)
+  def singleton_method_added(name)
+    inline_singleton_method_added name
+    above_singleton_method_added name
+  end
+
+private
+  def self.def_singleton_named(klass, &block)
+    klass.singleton_class.instance_eval do
+      define_singleton_method :named do |above=true|
+        block.call(above)
+      end
+    end
   end
 end

data/named_parameter.gemspec

@@ -4,14 +4,14 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
-  s.name = %q{named_parameter}
-  s.version = "0.0.4"
+  s.name = "named_parameter"
+  s.version = "0.0.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Hugo Roque (a.k.a HugoLnx)"]
-  s.date = %q{2012-08-07}
-  s.description = %q{Allows named parameter in ruby}
-  s.email = %q{hugolnx@gmail.com}
+  s.date = "2012-08-08"
+  s.description = "Allows named parameter in ruby"
+  s.email = "hugolnx@gmail.com"
   s.extra_rdoc_files = [
     "README.md"
   ]
@@ -19,20 +19,26 @@ Gem::Specification.new do |s|
     "Gemfile",
     "README.md",
     "Rakefile",
+    "lib/.named_parameter.rb.swo",
     "lib/named_parameter.rb",
     "lib/named_parameter/error.rb",
     "lib/named_parameter/errors.rb",
     "lib/named_parameter/errors/not_hash.rb",
     "lib/named_parameter/errors/required_parameters.rb",
     "lib/named_parameter/errors/undefined_parameters.rb",
+    "lib/named_parameter/named_above.rb",
+    "lib/named_parameter/named_inline.rb",
     "lib/named_parameter/named_method.rb",
     "lib/named_parameter/named_method_transmuter.rb",
     "lib/named_parameter/named_parameter.rb",
     "lib/named_parameter/parameters.rb",
     "named_parameter.gemspec",
-    "spec/features/individual_named_method_feature_spec.rb",
-    "spec/features/singleton_named_method_feature_spec.rb",
-    "spec/features/class_self_named_method_feature_spec.rb",
+    "spec/features/named_above/class_self_named_method_feature_spec.rb",
+    "spec/features/named_above/individual_named_method_feature_spec.rb",
+    "spec/features/named_above/singleton_named_method_feature_spec.rb",
+    "spec/features/named_inline/class_self_named_method_feature_spec.rb",
+    "spec/features/named_inline/individual_named_method_feature_spec.rb",
+    "spec/features/named_inline/singleton_named_method_feature_spec.rb",
     "spec/spec_helper.rb",
     "spec/unit/error_spec.rb",
     "spec/unit/errors/not_hash_spec.rb",
@@ -41,11 +47,11 @@ Gem::Specification.new do |s|
     "spec/unit/named_method_spec.rb",
     "spec/unit/named_method_transmuter_spec.rb"
   ]
-  s.homepage = %q{http://github.com/hugolnx/named_parameter}
+  s.homepage = "http://github.com/hugolnx/named_parameter"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.6.2}
-  s.summary = %q{Allows named parameter in ruby}
+  s.rubygems_version = "1.8.15"
+  s.summary = "Allows named parameter in ruby"
 
   if s.respond_to? :specification_version then
     s.specification_version = 3

data/spec/features/named_above/class_self_named_method_feature_spec.rb

@@ -0,0 +1,211 @@
+require 'spec_helper'
+
+describe "above named" do
+  describe "class << self named method feature" do
+    describe "becomes possible:" do
+      describe 'Named Parameter' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+                phrase
+              end
+            end
+          end
+
+          People.say phrase: "Hi!"
+            # => "Hi!"
+        } do
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+                phrase
+              end
+            end
+          end
+
+          phrase = People.say phrase: "Hi!"
+          phrase.should be == "Hi!"
+        end
+      end
+
+      describe 'Optional Named Parameter' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase="I'm mute")
+                phrase
+              end
+            end
+          end
+
+          People.say
+            # => "I'm mute"
+        } do
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase="I'm mute")
+                phrase
+              end
+            end
+          end
+
+          phrase = People.say
+          phrase.should be == "I'm mute"
+        end
+      end
+
+      describe 'Multiple Named Parameter (in any order)' do
+        specify %q{
+          class Point
+            extend NamedParameter
+
+            class << self
+              named
+              def move_to(x,y)
+                [x,y]
+              end
+            end
+          end
+
+          Point.move_to x: 1,y: 2
+            # => [1,2]
+
+          Point.move_to y: 2, x: 1
+            # => [1,2]
+        } do
+          class Point
+            extend NamedParameter
+
+            class << self
+              named
+              def move_to(x,y)
+                [x,y]
+              end
+            end
+          end
+
+          position = Point.move_to x: 1,y: 2
+          position.should be == [1,2]
+
+          position = Point.move_to y: 2, x: 1
+          position.should be == [1,2]
+        end
+      end
+
+      describe 'ArgumentError when given undefined args' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+              end
+            end
+          end
+
+          People.say phrase: "hi!",undefined: "test"
+            #=> ArgumentError
+        } do
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+              end
+            end
+          end
+
+          lambda{People.say(phrase: "hi!",undefined: "hugo")}.should raise_error ArgumentError, /'undefined'[\w\s]*'say'/
+        end
+      end
+
+      describe 'ArgumentError when not given required args' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+              end
+            end
+          end
+
+          People.say
+            #=> ArgumentError
+        } do
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+              end
+            end
+          end
+
+          lambda {People.say}.should raise_error ArgumentError, /'phrase'[\w\s]*'say'/
+        end
+      end
+
+      describe 'ArgumentError when given a non Hash argument' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+              end
+            end
+          end
+
+          People.say
+            #=> ArgumentError
+        } do
+          class People
+            extend NamedParameter
+
+            class << self
+              named
+              def say(phrase)
+              end
+            end
+          end
+
+          lambda {People.say("non Hash argument")}.should raise_error ArgumentError, /"non Hash argument"[\w\s]*'say'/
+        end
+      end
+    end
+
+    describe "no named method" do
+      it "can be called with normal parameters" do
+        class People
+          class << self
+            def no_named_say(phrase)
+              phrase
+            end
+          end
+        end
+
+        phrase = People.no_named_say "Hi!"
+        phrase.should be == "Hi!"
+      end
+    end
+  end
+end

data/spec/features/named_above/individual_named_method_feature_spec.rb

@@ -0,0 +1,185 @@
+require 'spec_helper'
+
+describe "above named" do
+  describe "individual named method feature" do
+    describe "becomes possible:" do
+      describe 'Named Parameter' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+              phrase
+            end
+          end
+
+          People.new.say phrase: "Hi!"
+            # => "Hi!"
+        } do
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+              phrase
+            end
+          end
+
+          phrase = People.new.say phrase: "Hi!"
+          phrase.should be == "Hi!"
+        end
+      end
+
+      describe 'Optional Named Parameter' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase="I'm mute")
+              phrase
+            end
+          end
+
+          People.new.say
+            # => "I'm mute"
+        } do
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase="I'm mute")
+              phrase
+            end
+          end
+
+          phrase = People.new.say
+          phrase.should be == "I'm mute"
+        end
+      end
+
+      describe 'Multiple Named Parameter (in any order)' do
+        specify %q{
+          class Point
+            extend NamedParameter
+
+            named
+            def move_to(x,y)
+              [x,y]
+            end
+          end
+
+          Point.new.move_to x: 1,y: 2
+            # => [1,2]
+
+          Point.new.move_to y: 2, x: 1
+            # => [1,2]
+        } do
+          class Point
+            extend NamedParameter
+
+            named
+            def move_to(x,y)
+              [x,y]
+            end
+          end
+
+          position = Point.new.move_to x: 1,y: 2
+          position.should be == [1,2]
+
+          position = Point.new.move_to y: 2, x: 1
+          position.should be == [1,2]
+        end
+      end
+
+      describe 'ArgumentError when given undefined args' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+            end
+          end
+
+          People.new.say phrase: "hi!",undefined: "test"
+            #=> ArgumentError
+        } do
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+            end
+          end
+
+          lambda{People.new.say(phrase: "hi!",undefined: "hugo")}.should raise_error ArgumentError, /'undefined'[\w\s]*'say'/
+        end
+      end
+
+      describe 'ArgumentError when not given required args' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+            end
+          end
+
+          People.new.say
+            #=> ArgumentError
+        } do
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+            end
+          end
+
+          lambda {People.new.say}.should raise_error ArgumentError, /'phrase'[\w\s]*'say'/
+        end
+      end
+
+      describe 'ArgumentError when given a non Hash argument' do
+        specify %q{
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+            end
+          end
+
+          People.new.say
+            #=> ArgumentError
+        } do
+          class People
+            extend NamedParameter
+
+            named
+            def say(phrase)
+            end
+          end
+
+          lambda {People.new.say("non Hash argument")}.should raise_error ArgumentError, /"non Hash argument"[\w\s]*'say'/
+        end
+      end
+    end
+
+    describe "no named method" do
+      it "can be called with normal parameters" do
+        class People
+          def no_named_say(phrase)
+            phrase
+          end
+        end
+
+        phrase = People.new.no_named_say "Hi!"
+        phrase.should be == "Hi!"
+      end
+    end
+  end
+end