uber 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8b1c72fd6f3f99e2d92ee6bba306785d88b64963
-  data.tar.gz: 01443d5ec98cee53824c305ffa5203030849b33a
+  metadata.gz: 0665bfd37394ce176ce0d33f2c1d1f55f32dfa70
+  data.tar.gz: 9a7bf2915ff6dd350d8d99c92c6a4b4afb9b6510
 SHA512:
-  metadata.gz: 39ccf2b0c211ae18559d825ae4613c450e2c38b63a692d5ad86b5da51f33f32bc05100869f0ecdcadce2888d01be5af3017bee1db16bbc2eef9b31d1b455e2fa
-  data.tar.gz: 11e6460fafc4153976248595236e08bc543c11ba32252bfe0708b454c32b8ba335a01f5c7c149742869ff0c89b2bf1f313cb188746cb0d17d07056c141ddae37
+  metadata.gz: b5dc8ce07c0dc65cf1f818294f785f6c6bba0849a4ddf45152a379747ecbc3c981d895a6a6e9f0e8964eecd972234dc1838cbcb27b15f12f25bc12f44268dfbf
+  data.tar.gz: d2dec91003d742e658c4c53350430f3793d3cf2edd43f4ae7644aeb6e12e9cab68c584bbcc4c7b9352feb6e970789fc4ce1ff8699347bf20ed353d825d2c3990

data/CHANGES.md

@@ -1,3 +1,7 @@
+# 0.0.8
+
+* Add `Uber::Delegates` that provides delegation that can be overridden and called with `super`.
+
 # 0.0.7
 
 * Add `Uber::Callable` and support for it in `Options::Value`.

data/README.md

@@ -156,6 +156,40 @@ Use `Options::Value#evaluate` to handle single values.
 Evaluating an options hash can be time-consuming. When `Options` contains static elements only, it behaves *and performs* like an ordinary hash.
 
 
+# Delegates
+
+Using `::delegates` works exactly like the `Forwardable` module in Ruby, with one bonus: It creates the accessors in a module, allowing you to override and call `super` in a user module or class.
+
+```ruby
+require 'uber/delegates'
+
+class SongDecorator
+  def initialize(song)
+    @song = song
+  end
+  attr_reader :song
+
+  extend Uber::Delegates
+
+  delegates :song, :title, :id # delegate :title and :id to #song.
+
+  def title
+    super.downcase # this calls the original delegate #title.
+  end
+end
+```
+
+This creates readers `#title` and `#id` which are delegated to `#song`.
+
+```ruby
+song = SongDecorator.new(Song.create(id: 1, title: "HELLOWEEN!"))
+
+song.id #=> 1
+song.title #=> "helloween!"
+```
+
+Note how `#title` calls the original title and then downcases the string.
+
 # Version
 
 Writing gems against other gems often involves checking for versions and loading appropriate version strategies - e.g. _"is Rails >= 4.0?"_. Uber gives you `Version` for easy, semantic version deciders.

data/lib/uber/delegates.rb

@@ -0,0 +1,13 @@
+require 'forwardable'
+
+module Uber
+  module Delegates
+    def delegates(model, *names)
+      mod = Module.new do
+        extend Forwardable
+        def_delegators model, *names
+      end
+      include mod
+    end
+  end
+end

data/lib/uber/uber_version.rb

@@ -1,3 +1,3 @@
 module Uber
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

data/test/delegates_test.rb

@@ -0,0 +1,44 @@
+require 'test_helper'
+require 'uber/delegates'
+
+class DelegatesTest < MiniTest::Spec
+  class Song
+    extend Uber::Delegates
+
+    delegates :model, :title
+
+    def model
+      Struct.new(:title).new("Helloween")
+    end
+
+    def title
+      super.downcase
+    end
+  end
+
+  # allows overriding in class.
+  it { Song.new.title.must_equal "helloween" }
+
+
+  module Title
+    extend Uber::Delegates
+
+    delegates :model, :title, :id
+  end
+
+  class Album
+    include Title
+
+    def model
+      Struct.new(:title, :id).new("Helloween", 1)
+    end
+
+    def title
+      super.downcase
+    end
+  end
+
+  # allows overriding in class inherited from module.
+  it { Album.new.title.must_equal "helloween" }
+  it { Album.new.id.must_equal 1 }
+end

data/test/inheritance_test.rb

@@ -1,55 +1,52 @@
-require 'test_helper'
-require 'uber/inheritable_included'
+# require 'test_helper'
+# require 'uber/inheritable_included'
 
-module InheritIncludedTo
-  def self.call(includer, proc)
-    proc.call(includer) # das will ich eigentlich machen
+# module InheritIncludedTo
+#   def self.call(includer, proc)
+#     proc.call(includer) # das will ich eigentlich machen
 
-    includer.class_eval do
-      @block = proc
+#     includer.class_eval do
+#       @block = proc
 
-      def self.included(base) #
-        InheritIncludedTo.call(base, instance_variable_get(:@block))
-      end
-    end
-  end
-end
+#       def self.included(base) #
+#         InheritIncludedTo.call(base, instance_variable_get(:@block))
+#       end
+#     end
+#   end
+# end
 
-class InheritanceTest < MiniTest::Spec
-  module Feature
-    #extend Uber::InheritedIncluded
+# class InheritanceTest < MiniTest::Spec
+#   module Feature
+#     #extend Uber::InheritedIncluded
 
-    CODE_BLOCK = lambda { |base| base.class_eval { extend ClassMethods } } # i want that to be executed at every include
+#     CODE_BLOCK = lambda { |base| base.class_eval { extend ClassMethods } } # i want that to be executed at every include
 
-    instance_exec do
-      @block = CODE_BLOCK # this would happen in inherited_included do .. end
-    end
 
-    def self.included(includer) #
-      # CODE_BLOCK.call(base)
-      InheritIncludedTo.call(includer, CODE_BLOCK)
-    end
+#     def self.included(includer) #
+#       # CODE_BLOCK.call(base)
+#       InheritIncludedTo.call(includer, CODE_BLOCK)
+#     end
 
-    module ClassMethods
-      def feature; end
-    end
-  end
+#     module ClassMethods
+#       def feature; end
+#     end
+#   end
 
-  module Extension
-    include Feature
+#   module Extension
+#     include Feature
 
-    # TODO: test overriding ::included
-  end
+#     # TODO: test overriding ::included
+#   end
 
-  module Client
-    include Extension
-  end
+#   module Client
+#     include Extension
+#   end
 
-  module ExtendedClient
-    include Client
-  end
+#   module ExtendedClient
+#     include Client
+#   end
 
-  it { Extension.must_respond_to :feature }
-  it { Client.must_respond_to :feature }
-  it { ExtendedClient.must_respond_to :feature }
-end
+#   it { Extension.must_respond_to :feature }
+#   it { Client.must_respond_to :feature }
+#   it { ExtendedClient.must_respond_to :feature }
+# end

metadata

@@ -1,41 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: uber
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-01 00:00:00.000000000 Z
+date: 2014-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.10.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.10.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.0.0
 description: A gem-authoring framework.
@@ -45,7 +45,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - CHANGES.md
 - Gemfile
 - LICENSE
@@ -53,10 +53,12 @@ files:
 - Rakefile
 - lib/uber.rb
 - lib/uber/callable.rb
+- lib/uber/delegates.rb
 - lib/uber/inheritable_attr.rb
 - lib/uber/options.rb
 - lib/uber/uber_version.rb
 - lib/uber/version.rb
+- test/delegates_test.rb
 - test/inheritable_attr_test.rb
 - test/inheritance_test.rb
 - test/options_test.rb
@@ -74,25 +76,27 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.2.1
 signing_key: 
 specification_version: 4
 summary: Gem-authoring tools like class method inheritance in modules, dynamic options
   and more.
 test_files:
+- test/delegates_test.rb
 - test/inheritable_attr_test.rb
 - test/inheritance_test.rb
 - test/options_test.rb
 - test/test_helper.rb
 - test/version_test.rb
 - test/zeugs.rb
+has_rdoc: