enumerable_lz

'enumerable_lz' provides filter and transformation methods in Enumerable module. Also it provides lazy equivalents of some methods in Enumerable.

Fundamental Usage

When require 'enumerable_lz', these lazy methods are provided:

Enumerable#filter
Enumerable#transform

And some method-chains are provided:

Enumerable#filter.with_index
Enumerable#filter.with_initializer
Enumerable#transform.with_index

For example (in Ruby 1.9.x or greater):

require 'enumerable_lz'
require 'prime'

(1..Float::INFINITY).transform{|n|n**2+1}.filter{|m|m.prime?}.take(100)
# => [2, 5, ... , 682277, 739601] for a few msec.

Prime.filter.with_index{|q,i|i.odd?}.take(10)
# => [3, 7, 13, 19, 29, 37, 43, 53, 61, 71]

Prime.transform.with_index{|q,i|[q,i]}.take(10)
# => [[2, 0], [3, 1], [5, 2], [7, 3], [11, 4], [13, 5], [17, 6], [19, 7], [23, 8], [29, 9]]

# especially, when calling transform.with_index without a block
Prime.transform.with_index.take(10)
# => [[2, 0], [3, 1], [5, 2], [7, 3], [11, 4], [13, 5], [17, 6], [19, 7], [23, 8], [29, 9]]

Expanded Usage

When require 'enumerable_lz/enumerable_ex', some lazy methods equivalents to original Enumerable method with suffix '_lz' are provided:

Enumerable#select_lz
Enumerable#find_all_lz
Enumerable#reject_lz
Enumerable#grep_lz
Enumerable#map_lz
Enumerable#collect_lz
Enumerable#drop_lz
Enumerable#drop_while_lz
Enumerable#take_lz
Enumerable#take_while_lz

For example (in Ruby 1.9.x or greater):

require 'enumerable_lz'
require 'enumerable_lz/enumerable_ex'
require 'prime'

(1..Float::INFINITY).map_lz{|n|n**2+1}.select_lz{|m|m.prime?}.take_lz(100).to_a
# => [2, 5, ... , 682277, 739601] for a few msec.

These expanded methods are inplemented with fundamental filter and transformation methods.

Supported Rubies

Ruby 2.1.0 (testing 2.1.0-p0)
Ruby 2.0.0 (testing 2.0.0-p247)
Ruby 1.9.x (testing 1.9.3-p448)
Ruby 1.8.7 (testing 1.8.7-p358)
JRuby (testing 1.7.2)
MacRuby (testing 0.12)

Installation

gem install enumerable_lz

License

Please see LICENSE.txt for details.