object_as 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 4f3e347ce7c24a0e05b63e4511275e005f4a3bbc
-  data.tar.gz: 9636725de1751fab9b7176cdb9abde1a584d6c3f
+SHA256:
+  metadata.gz: 1a90b9c1b854890e572b1854d62334e90a8953d57756dbd3e85e18ee7b1b84d7
+  data.tar.gz: af7f44963c8d993301b4e0a30faa5f4519baf935d6654dca483d86a09b644086
 SHA512:
-  metadata.gz: a0c37f75b48450ae6ca8d15a2fbe97530840f9779dda9946c6b9e69a59f847b79da7ad38873172e3ca2aa3f7c5f9e83be1414d98c1d7b51caf59d25c2af5cc5b
-  data.tar.gz: ee78c6a3280f37c8dccb3d420ae30b656e21aac7a45bca8f21aaef5f72c3d3db58203df0af3acaca55faf59bf9367939ffa902c70b123765830ca25f3d3112c2
+  metadata.gz: 0c77e64d59defbdaa95808be14b1f4bbba6e45ca6733b7f269e694986fd41054e7dd85fc2d0ec59025ff95a11fc94568739bc2182b19f558872aca94c6b0f1bf
+  data.tar.gz: d2cd554a7b08d68e2423879ec93fd3a333703f0105fde311a674fb4948deb8800c4c72699f98f6bd3b9c3b9a2a49c2aab46ede52041e3492748ad480c4695b01

data/README.md

@@ -2,6 +2,9 @@
 
 A simple refinement to get Object#as
 
+## Deprecation warning
+
+As of Ruby version 2.5, the method `Object::yield_self` is included in the standard Ruby library and should be preferred to `Object::as`.
 
 ## Installation
 
@@ -24,23 +27,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.1.0"
 end

metadata

@@ -1,43 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: object_as
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Tallak Tveide
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-05-20 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.7'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '10.0'
+date: 2026-10-20 00:00:00.000000000 Z
+dependencies: []
 description: Object#as is useful for method chaining
 email:
 - tallak@tveide.net
@@ -45,41 +17,33 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- Gemfile
 - LICENSE.txt
 - README.md
-- Rakefile
 - lib/object_as.rb
 - lib/object_as/version.rb
 - lib/object_as_no_refinements.rb
-- 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: {}
-post_install_message: 
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.1
-signing_key: 
+rubygems_version: 3.4.20
+signing_key:
 specification_version: 4
 summary: Implementation of the Object#as method
-test_files:
-- test/test_object_as.rb
-- test/test_object_as_no_refinement.rb
+test_files: []

data/.gitignore

@@ -1,15 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
-*.gem

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in object_as.gemspec
-gemspec

data/Rakefile

@@ -1,11 +0,0 @@
-require "bundler/gem_tasks"
-require 'rake'
-require 'rake/testtask'
- 
-Rake::TestTask.new do |t|
-    t.test_files = FileList['test/test*.rb']
-end
- 
-task(default: :test)
-
-

data/object_as.gemspec

@@ -1,23 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'object_as/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "object_as"
-  spec.version       = ObjectAs::VERSION
-  spec.authors       = ["Tallak Tveide"]
-  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.license       = "MIT"
-
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler", "~> 1.7"
-  spec.add_development_dependency "rake", "~> 10.0"
-end

data/test/test_object_as.rb

@@ -1,10 +0,0 @@
-require 'minitest/autorun'
-require_relative '../lib/object_as'
-
-using ObjectAs
-
-class TestObjectAs < MiniTest::Test
-  def test_that_kitty_can_eat
-    assert_equal 1.as {|n| n + n }, 2
-  end
-end

data/test/test_object_as_no_refinement.rb

@@ -1,8 +0,0 @@
-require 'minitest/autorun'
-require_relative '../lib/object_as_no_refinements'
-
-class TestObjectAs < MiniTest::Test
-  def test_that_kitty_can_eat
-    assert_equal 1.as {|n| n + n }, 2
-  end
-end