yield_from 0.0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e1e893e0ea1fa052f6fdf76b08c85403e02f260d
+  data.tar.gz: a16be25839897476a4b027b332942994ce039bd2
+SHA512:
+  metadata.gz: e30379f79350448864118be13916a38787ae97b41f5c229412dc2b50dba96b182fe074e8d85d36cf869b20b7ced2d054cc1ebcaf10b3941d2c2ee76bb21f2883
+  data.tar.gz: fe05e132d38d7296461740f81e6bba0ee728f23809e6183fd4b2dc5be88f44495d1e6f6cfc936ff680ce3fe0828a0263eca5428a52c533ee28b6e885cfc25b04

data/LICENSE.txt

@@ -0,0 +1,22 @@
+- Copyright (C) @cielavenir
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met: 
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer. 
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/lib/yield_from.rb

@@ -0,0 +1,47 @@
+=begin
+(C) @cielavenir
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+=end
+
+def yield_from(*funcsyms)
+	funcsyms.each{|funcsym|
+		func = method(funcsym)
+		define_method(funcsym){|*args,&blk|
+			return to_enum(funcsym,*args) if !blk
+			func.(*args){|*a|a.each{|e|blk.(e)}}
+		}
+		private funcsym
+	}
+end
+
+module YieldFrom
+        VERSION = '0.0.0.1'
+	def yield_from(*funcsyms)
+		funcsyms.each{|funcsym|
+			func = instance_method(funcsym)
+			define_method(funcsym){|*args,&blk|
+				return to_enum(funcsym,*args) if !blk
+				func.bind(self).(*args){|*a|a.each{|e|blk.(e)}}
+			}
+		}
+	end
+end

data/readme.md

@@ -0,0 +1,44 @@
+## yield_from: implementing `yield from func()` functionality by modifying `yield *func()` behavior
+
+### Usage
+
+```
+require 'yield_from'
+class A
+	extend YieldFrom
+	def rec(n)
+		return to_enum(:rec,n) if !block_given?
+		return if n<0
+		yield n
+		yield *rec(n-1)
+	end
+	yield_from :rec
+end
+p A.new.rec(5).to_a # => [5, 4, 3, 2, 1, 0]
+```
+
+There are instance method version and local function version.
+
+### Motivation
+
+In the above example, similar code was running until **Ruby 2.7** .
+
+```
+class A
+	def rec(n)
+		return to_enum(:rec,n) if !block_given?
+		return if n<0
+		yield n
+		rec(n-1, &proc)
+	end
+end
+p A.new.rec(5).to_a # => [5, 4, 3, 2, 1, 0]
+```
+
+**The bare proc got forbidden in Ruby 3.0.**
+
+You can see the discussion at https://qiita.com/cielavenir/items/0cc9189f2c40d6047d8b .
+
+### Acknowledgement
+
+Learned Ruby decorator from Nakayama R et al. Automatic Translation of Decorators from Python to Ruby, The 77th National Convention of IPSJ, 2015

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'rspec'
+RSpec.configure{|config|
+	config.color=true
+}
+
+require File.expand_path(File.dirname(__FILE__)+'/../lib/yield_from')

data/spec/yield_from_spec.rb

@@ -0,0 +1,77 @@
+require File.expand_path(File.dirname(__FILE__)+'/spec_helper')
+
+def rec(n)
+	return to_enum(:rec,n) if !block_given?
+	return if n<0
+	yield n
+	yield *rec(n-1)
+end
+yield_from :rec
+
+describe 'local function' do
+	it 'yields recursively' do
+		rec(5).to_a.should eq [5,4,3,2,1,0]
+	end
+end
+
+class A
+	extend YieldFrom
+	def rec1(n)
+		return to_enum(:rec1,n) if !block_given?
+		return if n<=0
+		yield n
+		yield *rec2(n-1)
+	end
+	def rec2(n)
+		return to_enum(:rec2,n) if !block_given?
+		return if n<=0
+		yield n
+		yield *rec1(n/2)
+	end
+	yield_from :rec1, :rec2
+end
+
+describe 'instance method' do
+	it 'yields recursively' do
+		A.new.rec1(7).to_a.should eq [7,6,3,2,1]
+	end
+end
+
+H=Hash.new{|h,k|h[k]=[]}
+n=10
+root=1
+roots=[*1..n]
+2.upto(n){|i|
+	H[i/2] << i
+}
+def preorder(node)
+	return to_enum(:preorder,node) if !block_given?
+	yield node
+	H[node].each{|e|yield *preorder(e) if e!=-1}
+end
+def inorder(node)
+	return to_enum(:inorder,node) if !block_given?
+	children=H[node]
+	yield *inorder(children[0]) if children[0]&&children[0]!=-1
+	yield node
+	yield *inorder(children[1]) if children[1]&&children[1]!=-1
+end
+def postorder(node)
+	return to_enum(:postorder,node) if !block_given?
+	H[node].each{|e|yield *postorder(e) if e!=-1}
+	yield node
+end
+yield_from :preorder, :inorder, :postorder
+
+describe 'complex case' do
+	specify 'preorder' do
+		preorder(root).to_a.should eq [1, 2, 4, 8, 9, 5, 10, 3, 6, 7]
+	end
+	specify 'inorder' do
+		inorder(root).to_a.should eq [8, 4, 9, 2, 10, 5, 1, 6, 3, 7]
+	end
+	specify 'postorder' do
+		postorder(root).to_a.should eq [8, 9, 4, 10, 5, 2, 6, 7, 3, 1]
+	end
+end
+

data/yield_from.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+require './lib/yield_from'
+
+Gem::Specification.new do |spec|
+  spec.name          = "yield_from"
+  spec.version       = YieldFrom::VERSION
+  spec.authors       = ["cielavenir"]
+  spec.email         = ["cielartisan@gmail.com"]
+  spec.description   = "implementing yield from func() functionality by modifying yield *func() behavior"
+  spec.summary       = "implementing yield from func() functionality by modifying yield *func() behavior"
+  spec.homepage      = "http://github.com/cielavenir/yield_from"
+  spec.license       = "Ruby License (2-clause BSDL or Artistic)"
+
+  spec.files         = `git ls-files`.split($/) + [
+    "LICENSE.txt",
+    "readme.md",
+    #"CHANGELOG.md",
+  ]
+  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.0"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: yield_from
+version: !ruby/object:Gem::Version
+  version: 0.0.0.1
+platform: ruby
+authors:
+- cielavenir
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-06-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: implementing yield from func() functionality by modifying yield *func()
+  behavior
+email:
+- cielartisan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- lib/yield_from.rb
+- readme.md
+- spec/spec_helper.rb
+- spec/yield_from_spec.rb
+- yield_from.gemspec
+homepage: http://github.com/cielavenir/yield_from
+licenses:
+- Ruby License (2-clause BSDL or Artistic)
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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.5.2.1
+signing_key: 
+specification_version: 4
+summary: implementing yield from func() functionality by modifying yield *func() behavior
+test_files:
+- spec/spec_helper.rb
+- spec/yield_from_spec.rb