forwarder19 0.2.0rc5 → 0.2.0

data/README.md

@@ -147,28 +147,44 @@ we do not always use whitespaces, than we can leave the second paramter to be pr
 of the defined forwarder proxy.
 
 ```ruby
-   forward :add_whitespace_to_punctuation,
+   forward :add_something_to_punctuation,
            to:   :name,
            as:   :gsub!,
-           with: /[,.]\b/
+           with: /([,.])\b/
 ```
 
 We can achieve the same as above with the following invocation
 
 ```ruby
-  o = Name.new( "the,quick, fox." )
-  o.add_whitespace_to_punctuation( '\1 ' )
+   o = Name.new( "the,quick, fox." )
+   o.add_something_to_punctuation( '\1 ' )
   # name: "the, quick, fox." )
 ```
 
 but we can also add a hyphen after interpunctations with this invocation 
 
 ```ruby
-  o = Name.new( "the,quick, fox." )
-  o.add_whitespace_to_punctuation( '\1- ' )
+   o = Name.new( "the,quick, fox." )
+   o.add_something_to_punctuation( '\1- ' )
   # name: "the,- quick,- fox." )
 ```
 
+But more importantely we can forward to the partial application, thus using the 
+partial application as a mean of composition
+
+```ruby
+   forward :add_ws_to_punctuation,
+           to_object: :self,
+           as: :add_something_to_punctuation,
+           with: '\1 '
+
+   forward :add_hypen_to_punctuation,
+           to_object: self,
+           as: :add_something_to_punctuation,
+           with_block: ->(*grps){ "#{grps.first}- " }
+ 
+```
+
 ### Passing One Array
 
 If a real array shall be passed in as one parameter it can be wrapped into an array of one element,

data/lib/forwarder.rb

@@ -3,6 +3,11 @@ require 'forwarder/params'
 
 module Forwarder
   
+  # How forward works:
+  # The parameters are analyzied by the Params object by means of the `prepare_forward`
+  # method. The `prepare_forward` method makes have use of the Argument object which
+  # implements a query API for what the given arguments allow the forwarder to do.
+  # And eventually the `forward!` method realises the delegation
   def forward *args, &blk
     params = Forwarder::Params.new self
     params.prepare_forward( *args, &blk )

data/lib/forwarder/compiler.rb

@@ -1,5 +1,8 @@
 require 'forwarder/evaller'
 module Forwarder
+  # The compiler's responsability is to create a string representation of
+  # the delegation method, or to nil if no such string representation exists
+  # and delegation has to be done dynamically.
   class Compiler
     attr_reader :arguments
 
@@ -11,10 +14,8 @@ module Forwarder
       # To Hash can always compile
       return compile_to_hash if arguments.to_hash?
 
-      # Cannot compile because arguments cannot be compiled
-      @compiled_args = Evaller.serialize arguments.args
-
       # Cannot compile only because the arguments.args cannot be compiled
+      @compiled_args = Evaller.serialize arguments.args
       return unless @compiled_args
 
       # Can compile :)))

data/lib/forwarder/params.rb

@@ -1,6 +1,7 @@
 require 'forwarder/arguments'
 require 'forwarder/compiler'
 require 'forwarder/meta'
+
 module Forwarder
   class Params
     attr_reader :forwardee, :arguments

data/lib/forwarder/version.rb

@@ -1,3 +1,3 @@
 module Forwarder
-  VERSION = '0.2.0rc5'
+  VERSION = '0.2.0'
 end # module Forwarder

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: forwarder19
 version: !ruby/object:Gem::Version
-  version: 0.2.0rc5
-  prerelease: 5
+  version: 0.2.0
+  prerelease: 
 platform: ruby
 authors:
 - Robert Dober
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-28 00:00:00.000000000Z
+date: 2013-01-10 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lab419_core
-  requirement: &13783720 !ruby/object:Gem::Requirement
+  requirement: &79251030 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 0.0.3
   type: :runtime
   prerelease: false
-  version_requirements: *13783720
+  version_requirements: *79251030
 - !ruby/object:Gem::Dependency
   name: ruby-debug19
-  requirement: &13782800 !ruby/object:Gem::Requirement
+  requirement: &79250720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '0.11'
   type: :development
   prerelease: false
-  version_requirements: *13782800
+  version_requirements: *79250720
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &13781560 !ruby/object:Gem::Requirement
+  requirement: &79250430 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 0.9.2.2
   type: :development
   prerelease: false
-  version_requirements: *13781560
+  version_requirements: *79250430
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &13780620 !ruby/object:Gem::Requirement
+  requirement: &79250140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 2.9.0
   type: :development
   prerelease: false
-  version_requirements: *13780620
+  version_requirements: *79250140
 - !ruby/object:Gem::Dependency
   name: maruku
-  requirement: &13779720 !ruby/object:Gem::Requirement
+  requirement: &79249860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: 0.6.0
   type: :development
   prerelease: false
-  version_requirements: *13779720
+  version_requirements: *79249860
 - !ruby/object:Gem::Dependency
   name: wirble
-  requirement: &13778460 !ruby/object:Gem::Requirement
+  requirement: &79249630 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -76,7 +76,7 @@ dependencies:
         version: 0.1.3
   type: :development
   prerelease: false
-  version_requirements: *13778460
+  version_requirements: *79249630
 description: ! "Ruby's core Forwardable gets the job done(barely) and produces most
   unreadable code. \n\n  Forwarder19 not only is more readable, much more feature
   rich, but also slightly faster, meaning you can use it without performance penalty.\n\n
@@ -87,13 +87,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/forwarder.rb
-- lib/forwarder/evaller.rb
 - lib/forwarder/arguments.rb
-- lib/forwarder/version.rb
-- lib/forwarder/params.rb
-- lib/forwarder/meta.rb
 - lib/forwarder/compiler.rb
+- lib/forwarder/meta.rb
+- lib/forwarder/params.rb
+- lib/forwarder/evaller.rb
+- lib/forwarder/version.rb
+- lib/forwarder.rb
 - LICENSE
 - README.md
 homepage: https://github.com/RobertDober/Forwarder19
@@ -112,12 +112,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: Delegation And AOP Filters For It