enumerabler 1.0.0

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2009-11-11
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,5 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/enumerabler.rb

data/README.txt

@@ -0,0 +1,65 @@
+= enumerabler
+
+* http://github.com/mame/enumerabler/tree/master
+
+== DESCRIPTION:
+
+enumerabler enhances Enumerable with methods returning enumerator.
+
+== FEATURES/PROBLEMS:
+
+- Enumerable#grepper
+- Enumerable#finder_all (alias: all_finder, selector)
+- Enumerable#rejecter
+- Enumerable#collector (alias: mapper)
+- Enumerable#flat_mapper (alias: concat_collector)
+- Enumerable#zipper
+- Enumerable#taker
+- Enumerable#taker_while
+- Enumerable#dropper
+- Enumerable#dropper_while
+
+== SYNOPSIS:
+
+  require "enumerabler"
+
+  # `select' and `selector' have the almost same behavior.
+  ary.select   {|x| x.even? }.take(10)
+  ary.selector {|x| x.even? }.take(10)
+  # While `select' returns an array, `selector' returns an Enumerator
+  # corresponding the array.  So, the latter requires no intermediate
+  # array, which makes the latter more effective than the former.
+
+
+  # Sieve of Eratosthenes
+  def sieve(e, &blk)
+    yield n = e.first
+    sieve(e.rejecter {|x| x % n == 0 }, &blk)
+  end
+
+  sieve(2..(1.0/0.0)) {|x| p x } #=> 2, 3, 5, 7, 11, 13, 17, 19, 23, ...
+
+
+  # Fibonacci numbers
+  def fibonacci
+    Enumerator.new do |e|
+      e << 1
+      e << 1
+      fibonacci.zip(fibonacci.dropper(1)) {|x, y| e << x + y }
+    end
+  end
+
+  fibonacci.each {|x| p x } #=> 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, ...
+
+== REQUIREMENTS:
+
+None
+
+== INSTALL:
+
+* gem install enumerabler
+
+== LICENSE:
+
+Copyright:: Yusuke Endoh <mame@tsg.ne.jp>
+License:: Ruby's

data/Rakefile

@@ -0,0 +1,11 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.new('enumerabler', '1.0.0') do |p|
+  p.rubyforge_name = "enumerabler"
+  p.developer('Yusuke Endoh', 'mame@tsg.ne.jp')
+end
+
+# vim: syntax=Ruby

data/lib/enumerabler.rb

@@ -0,0 +1,112 @@
+module Enumerable
+  def grepper(pat, &blk)
+    Enumerator.new do |e|
+      each do |x|
+        e << (blk ? blk[x] : x) if pat === x
+      end
+    end
+  end
+
+  def finder_all(&blk)
+    Enumerator.new do |e|
+      each do |x|
+        e << x if blk[x]
+      end
+    end
+  end
+  alias all_finder finder_all
+  alias selector finder_all
+
+  def rejecter(&blk)
+    Enumerator.new do |e|
+      each do |x|
+        e << x unless blk[x]
+      end
+    end
+  end
+
+  def collector(&blk)
+    Enumerator.new do |e|
+      each do |x|
+        e << blk[x]
+      end
+    end
+  end
+  alias mapper collector
+
+  def flat_mapper(&blk)
+    Enumerator.new do |e|
+      each do |a|
+        blk[a].each do |x|
+          e << x
+        end
+      end
+    end
+  end
+  alias concat_collector flat_mapper
+
+  def zipper(*ary, &blk)
+    Enumerator.new do |e|
+      if ary.all? {|a| a.is_a?(Array) }
+        i = 0
+        each do |x|
+          e << [x] + ary.map {|a| a[i] }
+          i += 1
+        end
+      else
+        ary = ary.map! {|a| a.to_enum }
+        each do |x|
+          a = ary.map.with_index do |a, i|
+            next nil if a == nil
+            begin
+              a.next
+            rescue StopIteration
+              ary[i] = nil
+            end
+          end
+          e << [x] + a
+        end
+      end
+    end
+  end
+
+  def taker(n)
+    Enumerator.new do |e|
+      i = 0
+      each do |x|
+        break if i == n
+        e << x
+        i += 1
+      end
+    end
+  end
+
+  def taker_while(&blk)
+    Enumerator.new do |e|
+      each do |x|
+        break unless blk[x]
+        e << x
+      end
+    end
+  end
+
+  def dropper(n)
+    Enumerator.new do |e|
+      i = 0
+      each do |x|
+        e << x if i >= n
+        i += 1
+      end
+    end
+  end
+
+  def dropper_while(&blk)
+    Enumerator.new do |e|
+      flag = false
+      each do |x|
+        flag = true unless flag || blk[x]
+        e << x if flag
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: enumerabler
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Yusuke Endoh
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-11 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.3
+    version: 
+description: enumerabler enhances Enumerable with methods returning enumerator.
+email: 
+- mame@tsg.ne.jp
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/enumerabler.rb
+has_rdoc: true
+homepage: http://github.com/mame/enumerabler/tree/master
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: enumerabler
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: enumerabler enhances Enumerable with methods returning enumerator.
+test_files: []
+