lazing 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+.idea

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2010 Greg Spurrier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,63 @@
+# Lazing
+Lazing provides lazy equivalents for many of the methods in Ruby's standard
+`Enumerable` module.  The lazy variants all end in 'ing', hence the name.
+
+For example:
+
+    >> (1..20).selecting {|x| raise 'boom' if x == 6; x.odd?}.first(3)
+     => [1, 3, 5]
+
+Compare the above with the behavior of the non-lazy standard version:
+
+    >> (1..20).select {|x| raise 'boom' if x == 6; x.odd?}.first(3)
+    RuntimeError: boom
+      from (irb):4:in `block in irb_binding'
+      from (irb):4:in `each'
+      from (irb):4:in `select'
+      from (irb):4
+      from irb:17:in `<main>'
+
+## Lazy Methods
+Lazing defines the following lazy filter methods:
+
+* `finding_all`
+* `rejecting`
+* `selecting`
+
+Lazing defines the following lazy transformation methods:
+
+* `collecting`
+* `mapping`
+
+## Supported Rubies
+Lazing requires Ruby 1.9.  It has been tested with Ruby 1.9.2-p0.
+
+## Installation
+Lazing is distributed as a gem.  To install, use the command:
+
+    gem install lazing
+
+## Obtaining the Latest Version
+Lazing is hosted on github at
+[http://github.com/gregspurrier/lazing](http://github.com/gregspurrier/lazing).
+
+A local clone of the repository can be obtained via:
+
+    git clone git://github.com/gregspurrier/lazing.git
+
+## Related work
+After implementing [`select_first`](http://blog.rujubu.com/articles/selecting-only-what-you-need)
+for a project I was working on, I searched for lazy enumeration support in Ruby.
+I came across this [blog post](http://www.michaelharrison.ws/weblog/?p=163) and
+it became the inspiration for Lazing.
+
+I later discovered that my implementation of `selecting` is almost identical
+to the `infinite_select` example given in Programming Ruby: The Pragmatic
+Programmers' Guide by Dave Thomas.
+
+## License
+Lazing is Copyright (c) 2010 by Greg Spurrier and released under the terms of
+the MIT License. Please see LICENSE.txt for details.
+
+
+

data/Rakefile

@@ -0,0 +1,16 @@
+require 'rubygems'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "lazing"
+    gemspec.summary = "Making Enumerable a little lazy"
+    gemspec.description = "Lazy equivalents for many of the methods in Enumerable"
+    gemspec.email = "greg@rujubu.com"
+    gemspec.homepage = "http://github.com/gregspurrier/lazing"
+    gemspec.author = "Greg Spurrier"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lazing.gemspec

@@ -0,0 +1,54 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{lazing}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Greg Spurrier"]
+  s.date = %q{2010-10-22}
+  s.description = %q{Lazy equivalents for many of the methods in Enumerable}
+  s.email = %q{greg@rujubu.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+     "README.md"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE.txt",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "lazing.gemspec",
+     "lib/lazing.rb",
+     "lib/lazing/filters.rb",
+     "lib/lazing/transformers.rb",
+     "spec/lazing/filters_spec.rb",
+     "spec/lazing/transformers_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/gregspurrier/lazing}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Making Enumerable a little lazy}
+  s.test_files = [
+    "spec/lazing/filters_spec.rb",
+     "spec/lazing/transformers_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/lib/lazing.rb

@@ -0,0 +1,2 @@
+require File.expand_path('../lazing/filters', __FILE__)
+require File.expand_path('../lazing/transformers', __FILE__)

data/lib/lazing/filters.rb

@@ -0,0 +1,31 @@
+module Enumerable
+  # Lazy version of Enumerable#reject.
+  #
+  # Returns a lazy collection containing all elements of the collection
+  # for which the provided block returns false.
+  def rejecting(&blk)
+    Enumerator.new do |yielder|
+      each do |item|
+        yielder.yield item unless blk.call(item)
+      end
+    end
+  end
+
+  # Lazy version of Enumerable#select
+  #
+  # Returns a lazy collection containing all elements of the collection
+  # for which the provided block returns true.
+  def selecting(&blk)
+    Enumerator.new do |yielder|
+      each do |item|
+        yielder.yield item if blk.call(item)
+      end
+    end
+  end
+
+  # Lazy version of Enumerable#find_all
+  #
+  # Returns a lazy collection containing all elements of the collection
+  # for which the provided block returns true.
+  alias finding_all selecting
+end

data/lib/lazing/transformers.rb

@@ -0,0 +1,19 @@
+module Enumerable
+  # Lazy version of Enumerable#map
+  #
+  # Returns the lazy collection formed by applying the given block to each
+  # member of the collection.
+  def mapping(&blk)
+    Enumerator.new do |yielder|
+      each do |item|
+        yielder.yield blk.call(item)
+      end
+    end
+  end
+
+  # Lazy version of Enumerable#collect
+  #
+  # Returns the lazy collection formed by applying the given block to each
+  # member of the collection.
+  alias collecting mapping
+end

data/spec/lazing/filters_spec.rb

@@ -0,0 +1,37 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Enumerable, '#finding_all' do
+  it 'returns a lazy collection matching the results of Enumerable#find_all' do
+    range = (1..20)
+    range.finding_all {|x| x.odd?}.to_a.should == range.find_all {|x| x.odd?}
+  end
+
+  it 'processes items on demand' do
+    (1..20).finding_all {|x| raise 'boom' if x == 6; x.odd?}.first(3).
+        should == [1,3,5]
+  end
+end
+
+describe Enumerable, '#rejecting' do
+  it 'returns a lazy collection matching the results of Enumerable#reject' do
+    range = (1..20)
+    range.rejecting {|x| x.odd?}.to_a.should == range.reject {|x| x.odd?}
+  end
+
+  it 'processes items on demand' do
+    (1..20).rejecting {|x| raise 'boom' if x == 6; x.even?}.first(3).
+        should == [1,3,5]
+  end
+end
+
+describe Enumerable, '#selecting' do
+  it 'returns a lazy collection matching the results of Enumerable#select' do
+    range = (1..20)
+    range.selecting {|x| x.odd?}.to_a.should == range.select {|x| x.odd?}
+  end
+
+  it 'processes items on demand' do
+    (1..20).selecting {|x| raise 'boom' if x == 6; x.odd?}.first(3).
+        should == [1,3,5]
+  end
+end

data/spec/lazing/transformers_spec.rb

@@ -0,0 +1,25 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Enumerable, '#collecting' do
+  it 'returns a lazy collection matching the results of Enumerable#collect' do
+    range = (1..20)
+    range.collecting {|x| x * x}.to_a.should == range.collect {|x| x * x}
+  end
+
+  it 'processes items on demand' do
+    (1..20).collecting {|x| raise 'boom' if x == 4; x * x}.first(3).
+        should == [1,4,9]
+  end
+end
+
+describe Enumerable, '#mapping' do
+  it 'returns a lazy collection matching the results of Enumerable#map' do
+    range = (1..20)
+    range.mapping {|x| x * x}.to_a.should == range.map {|x| x * x}
+  end
+
+  it 'processes items on demand' do
+    (1..20).mapping {|x| raise 'boom' if x == 4; x * x}.first(3).
+        should == [1,4,9]
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.expand_path('../../lib/lazing', __FILE__)

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: lazing
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Greg Spurrier
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-22 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Lazy equivalents for many of the methods in Enumerable
+email: greg@rujubu.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- .gitignore
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- lazing.gemspec
+- lib/lazing.rb
+- lib/lazing/filters.rb
+- lib/lazing/transformers.rb
+- spec/lazing/filters_spec.rb
+- spec/lazing/transformers_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/gregspurrier/lazing
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Making Enumerable a little lazy
+test_files: 
+- spec/lazing/filters_spec.rb
+- spec/lazing/transformers_spec.rb
+- spec/spec_helper.rb