enumerator_generate 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9570b3287b1910c7a5fa6fddae5f3706d40ee745885b226da236a5e65223c70a
+  data.tar.gz: c99e8abce49b85df5f03007c033cfc90a429fa3a61ce88edafebd8112e53f9cc
+SHA512:
+  metadata.gz: cdc400176f0915f01022f093660442a7248d61c7e4882a0b692db5215d9aca5013651d6b66ff7c5a67b110332c0bbd568154ed507a6ca5c4a7cbf08b03d28d24
+  data.tar.gz: d573ce12a0bb2ce869052759de7202abc98299035c695a7cda942aa8ce19d31732c30b665babdf0b43f10f0a47d426d0785bdf634fd66193791cf0f9da934027

data/README.md

@@ -0,0 +1,48 @@
+# `Enumerator#generate`
+
+This is an alternative to [`Object#enumerate`](https://github.com/zverok/object_enumerate) Ruby language core proposal. Goal is the same: generating enumerators which can idiomatically replace (most of) `while` and `loop` cycles.
+
+After some experiments, it turns out that "start from initial value, and continue with this block" (like `Object#enumerate` does) is not the only important use case. "Just enumerate with this block" is equally important, and `Enumerator#generate` supports this case finely. Also, the call sequence seems to be less confusing, it is pretty straight: `Enumerator#generate` generates an enumerator from block and optional initial value.
+
+## Synopsys
+
+`Enumerator#generate` takes a block and optional initial value, and generates (infinite) enumerator by applying the block to result of previous iteration. If initial value is not passed, first block receives no arguments.
+
+## Examples of usage
+
+### With initial value
+
+```ruby
+# Infinite sequence
+p Enumerator.generate(1, &:succ).take(5)
+# => [1, 2, 3, 4, 5]
+
+# Easy Fibonacci
+p Enumerator.generate([0, 1]) { |f0, f1| [f1, f0 + f1] }.take(10).map(&:first)
+#=> [0, 1, 1, 2, 3, 5, 8, 13, 21, 34]
+
+require 'date'
+
+# Find next Tuesday
+p Enumerator.generate(Date.today, &:succ).detect { |d| d.wday == 2 }
+# => #<Date: 2018-05-22 ((2458261j,0s,0n),+0s,2299161j)>
+```
+(Other examples from [`Object#enumerate`](https://github.com/zverok/object_enumerate) are easily translated, too.)
+
+### Without initial value
+
+```ruby
+# Random search
+target = 7
+p Enumerator.generate { rand(10) }.take_while { |i| i != target }.to_a
+# => [0, 6, 3, 5,....]
+
+# External while condition
+require 'strscan'
+scanner = StringScanner.new('7+38/6')
+p Enumerator.generate { scanner.scan(%r{\d+|[-+*/]}) }.take_while { !scanner.eos? }.to_a
+# => ["7", "+", "38", "/"]
+
+# Potential message loop system:
+Enumerator.generate { Message.receive }.take_while { |msg| msg != :exit }
+```

data/examples.rb

@@ -0,0 +1,46 @@
+require_relative 'lib/enumerator_generate'
+require 'pp'
+
+# Infinite sequence
+p Enumerator.generate(1, &:succ).take(5)
+
+# Easy Fibonacci
+p Enumerator.generate([0, 1]) { |f0, f1| [f1, f0 + f1] }.take(10).map(&:first)
+
+require 'date'
+
+# Find next Tuesday
+p Enumerator.generate(Date.today, &:succ).detect { |d| d.wday == 2 }
+
+require 'nokogiri'
+require 'open-uri'
+
+# Find some element on page, then make list of all parents
+p Nokogiri::HTML(open('https://www.ruby-lang.org/en/'))
+  .at('a:contains("Ruby 2.2.10 Released")')
+  .yield_self { |node| Enumerator.generate(node, &:parent) } # Enumerator#generate is a bit wordy in chains
+  .take_while { |node| node.respond_to?(:parent)  }
+  .map(&:name)
+
+require 'octokit'
+
+Octokit.stargazers('rails/rails')
+# ^ this method returned just an array, but have set `.last_response` to full response, with data
+# and pagination. So now we can do this:
+p Enumerator.generate(Octokit.last_response) { |response| response.rels[:next].get } # pagination: `get` fetches next Response
+  .first(3) # take just 3 pages of stargazers
+  .flat_map(&:data) # data is parsed response content (stargazers themselves)
+  .map { |h| h[:login] }
+
+# No initial value: random search
+target = 7
+p Enumerator.generate { rand(10) }.take_while { |i| i != target }.to_a
+
+# No initial value: external while condition
+require 'strscan'
+scanner = StringScanner.new('7+38/6')
+p Enumerator.generate { scanner.scan(%r{\d+|[-+*/]}) }.take_while { !scanner.eos? }.to_a
+
+
+# Potential message loop system:
+# Enumerator.generate { Message.receive }.take_while { |msg| msg != :exit }

data/lib/enumerator_generate.rb

@@ -0,0 +1,16 @@
+class Enumerator
+  NOVALUE = Object.new.freeze
+
+  def self.generate(initial = NOVALUE)
+    raise ArgumentError, "No block given" unless block_given?
+    Enumerator.new do |y|
+      val = initial == NOVALUE ? yield() : initial
+      y << val
+
+      loop do
+        val = yield(val)
+        y << val
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: enumerator_generate
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Victor Shepelev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-05-21 00:00:00.000000000 Z
+dependencies:
+- !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: rubygems-tasks
+  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: "    This is just a showcase gem to support language core proposal.\n"
+email: zverok.offline@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- examples.rb
+- lib/enumerator_generate.rb
+homepage: https://github.com/zverok/enumerator_generate
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.4
+signing_key: 
+specification_version: 4
+summary: 'Enumerator#generate: Simple infinite enumerators'
+test_files: []