object_as 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4f3e347ce7c24a0e05b63e4511275e005f4a3bbc
-  data.tar.gz: 9636725de1751fab9b7176cdb9abde1a584d6c3f
+  metadata.gz: 6fdc23d5eb1fc0c97181778cdc9a829e0f06f5f9
+  data.tar.gz: fc696bc977cf6747851af7101ecc18c7e7a33ccc
 SHA512:
-  metadata.gz: a0c37f75b48450ae6ca8d15a2fbe97530840f9779dda9946c6b9e69a59f847b79da7ad38873172e3ca2aa3f7c5f9e83be1414d98c1d7b51caf59d25c2af5cc5b
-  data.tar.gz: ee78c6a3280f37c8dccb3d420ae30b656e21aac7a45bca8f21aaef5f72c3d3db58203df0af3acaca55faf59bf9367939ffa902c70b123765830ca25f3d3112c2
+  metadata.gz: 172e51388a1c0379d2a1d472d2159e1e86b4aa699e13edf403aa16476f6e1e0caa5f391e4ceaa15154b099ea7af7efaa9373611514f21ccbf8a1add72a11803d
+  data.tar.gz: 91b0eabfd462cb3403d695460e574f17170ba950bfe0c09d19838b9f48473794edb024d467b6f8926ce4a4eb1866a6735fa3a894c9a8e62a0543aa219d7c8d8c

data/README.md

@@ -24,23 +24,64 @@ Or install it yourself as:
 Object#as it much like Object#tap except that it returns the value of the block
 instead of the value being tapped.
 
-    > "Ruby".as {|n| n.reverse }
-    => "ybuR"
+    > keys = [1, 2, 3]
+    > values = %w(a b c)
+    > keys.zip(values).as {|kv| Hash[kv] }
+    => {1=>"a", 2=>"b", 3=>"c"}
 
 Object#as is useful when chaining methods. This is a complete Ruby source file:
  
     require 'object_as'
     using ObjectAs
-    [1, 2, 3].map {|x| x * x }.as {|array| array.reverse }.each {|x| puts x }
-    # prints 9, 4 and 1
+
+    def square(array)
+      array.map {|x| x * x }
+    end
+
+    [1, 2, 3].as {|array| square array }.each {|x| puts x }
+    # prints 1, 4, 9
 
 For Ruby versions older than 2.1, there is a way to use Object#as without 
 refinements. This method uses monkeypatching.
 
     require 'object_as_no_refinements'
-    [1, 2, 3].map {|x| x * x }.as {|array| array.reverse }.each {|x| puts x }
-    # prints 9, 4 and 1
 
+    def square(array)
+      array.map {|x| x * x }
+    end
+
+    [1, 2, 3].as {|array| square array }.each {|x| puts x }
+    # prints 1, 4, 9
+
+## Example
+
+In this example I am using OpenCv to process an image in a method chain, but at 
+one point I want to subtract the average value of the image from itself.
+
+
+    require 'object_as'
+    require 'opencv'
+
+    using ObjectAs
+
+    region_of_interest = 
+      CvMat.load("image.png")
+      sub_rect(x, y, 20, 20).
+      normalize(0.0, 1.0, CV_NORM_MINMAX, CV_32F).
+      as {|i| i.sub(i.avg) }
+
+The alternative, without Object#as would look something like this:
+
+Require 'opencv'
+
+tmp = 
+  CvMat.load(filename)
+  sub_rect(x, y, 20, 20).
+  normalize(0.0, 1.0, CV_NORM_MINMAX, CV_32F)
+
+region_of_interest = tmp.sub(tmp.avg)
+
+The method chain is broken, and we have to introduce a temporary variable.
 
 ## Contributing
 

data/lib/object_as/version.rb

@@ -1,3 +1,3 @@
 module ObjectAs
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/object_as.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["tallak@tveide.net"]
   spec.summary       = %q{Implementation of the Object#as method}
   spec.description   = %q{Object#as is useful for method chaining}
-  spec.homepage      = ""
+  spec.homepage      = "https://github.com/tallakt/object_as"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: object_as
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Tallak Tveide
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-20 00:00:00.000000000 Z
+date: 2015-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -56,7 +56,7 @@ files:
 - object_as.gemspec
 - test/test_object_as.rb
 - test/test_object_as_no_refinement.rb
-homepage: ''
+homepage: https://github.com/tallakt/object_as
 licenses:
 - MIT
 metadata: {}