uber 0.0.12 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: de21d3a8920ff5ceefd1ad8bf258cad849fe98fe
-  data.tar.gz: ffa76af2fd9c3b8934fe8fe45ad42dfd905b7e5c
+  metadata.gz: 9ba4151c41861ad82f7e78103bd2c45b6cb0fc6e
+  data.tar.gz: ef674c49120eb7f86930e11ab8a12ac5bb3192e1
 SHA512:
-  metadata.gz: ca76c101f1ab19441184b5635629c83aadd23ae7e75f9cf8e1f9b3aa9e6df58dcc961a80bf91f59ec12e44bb8c9384d2f583571133c7689eb44ace172ea0d86b
-  data.tar.gz: 885a59c6f4f4ef7e686dbf6730c59e0ef85e4c01850cde97d45f3cd1f81fdebcb530d1df0e5877ed09e26ac17d5f70780009ba05672dab39c6d1541a2bedc6f0
+  metadata.gz: 78ff679013edac4b297e88352768e69d0daa56fc02d8491bd3fc6fb463c7336f3f8ef95fc9c667ba1c8a22af1f2b8c4b8b55821e4306d2558b858550eca89058
+  data.tar.gz: 2a3c2906155aa3c85ada42ba320040a19ad7165be9b695ad98e672c200a8e82b13b30fb4d3a8f91f4fef3ffd0817c0057c847ed5336b5324040411489f41eda9

data/CHANGES.md

@@ -1,3 +1,7 @@
+# 0.0.13
+
+* Add proc syntax for builders. This allows using `return` in the block. Thanks to @dutow for implementing this.
+
 # 0.0.12
 
 * Make it run with Ruby 2.2.

data/README.md

@@ -197,6 +197,10 @@ Note how `#title` calls the original title and then downcases the string.
 When included, `Builder` allows to add builder instructions on the class level. These can then be evaluated when instantiating
 the class to conditionally build (sub-)classes based on the incoming parameters.
 
+Builders can be defined in two different ways.
+
+## Block Syntax
+
 ```ruby
 class Listener
   include Uber::Builder
@@ -228,6 +232,21 @@ Listener.build({}) #=> Listener
 Listener.build({current_user: @current_user}) #=> SignedIn
 ```
 
+## Proc Syntax
+
+Setting up builders using the proc syntax allows to call `return` in the block. This is our preferred way to define builders.
+
+```ruby
+build ->(params) do
+  return SignedIn if params[:current_user]
+  return Admin    if params[:admin]
+  Default
+end
+```
+
+This makes the block extremely readable.
+
+
 Note that builders are _not_ inherited to subclasses. This allows instantiating subclasses directly without running builders.
 
 This pattern is used in [Cells](https://github.com/apotonick/cells), [Trailblazer](https://github.com/apotonick/trailblazer) and soon Reform and Representable/Roar, too.

data/lib/uber/builder.rb

@@ -79,8 +79,8 @@ module Uber
       #   end
       #
       # In your view #cell will instantiate the right cell for you now.
-      def builds(&block)
-        builders << block
+      def builds(proc=nil, &block)
+        builders << (proc.kind_of?(Proc) ? proc : block)
       end
 
       def class_builder

data/lib/uber/uber_version.rb

@@ -1,3 +1,3 @@
 module Uber
-  VERSION = "0.0.12"
+  VERSION = "0.0.13"
 end

data/test/builder_test.rb

@@ -56,4 +56,20 @@ class BuilderTest < MiniTest::Spec
   it { Play.build({}).must_be_instance_of Play }
   it { Play.build({evergreen: true}).must_be_instance_of Play }
   it { Play.build({hit: true}).must_be_instance_of Play }
+
+  # test return from builds
+  class Boomerang
+    include Uber::Builder
+
+    builds ->(options) do
+      return Song if options[:hit]
+    end
+
+    def self.build(options)
+      class_builder.call(options).new
+    end
+  end
+
+  it { Boomerang.build({}).must_be_instance_of Boomerang }
+  it { Boomerang.build({hit: true}).must_be_instance_of Song }
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: uber
 version: !ruby/object:Gem::Version
-  version: 0.0.12
+  version: 0.0.13
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-25 00:00:00.000000000 Z
+date: 2015-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake