lazing 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ .idea
@@ -0,0 +1,21 @@
1
+ The MIT License
2
+
3
+ Copyright (c) 2010 Greg Spurrier
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
@@ -0,0 +1,63 @@
1
+ # Lazing
2
+ Lazing provides lazy equivalents for many of the methods in Ruby's standard
3
+ `Enumerable` module. The lazy variants all end in 'ing', hence the name.
4
+
5
+ For example:
6
+
7
+ >> (1..20).selecting {|x| raise 'boom' if x == 6; x.odd?}.first(3)
8
+ => [1, 3, 5]
9
+
10
+ Compare the above with the behavior of the non-lazy standard version:
11
+
12
+ >> (1..20).select {|x| raise 'boom' if x == 6; x.odd?}.first(3)
13
+ RuntimeError: boom
14
+ from (irb):4:in `block in irb_binding'
15
+ from (irb):4:in `each'
16
+ from (irb):4:in `select'
17
+ from (irb):4
18
+ from irb:17:in `<main>'
19
+
20
+ ## Lazy Methods
21
+ Lazing defines the following lazy filter methods:
22
+
23
+ * `finding_all`
24
+ * `rejecting`
25
+ * `selecting`
26
+
27
+ Lazing defines the following lazy transformation methods:
28
+
29
+ * `collecting`
30
+ * `mapping`
31
+
32
+ ## Supported Rubies
33
+ Lazing requires Ruby 1.9. It has been tested with Ruby 1.9.2-p0.
34
+
35
+ ## Installation
36
+ Lazing is distributed as a gem. To install, use the command:
37
+
38
+ gem install lazing
39
+
40
+ ## Obtaining the Latest Version
41
+ Lazing is hosted on github at
42
+ [http://github.com/gregspurrier/lazing](http://github.com/gregspurrier/lazing).
43
+
44
+ A local clone of the repository can be obtained via:
45
+
46
+ git clone git://github.com/gregspurrier/lazing.git
47
+
48
+ ## Related work
49
+ After implementing [`select_first`](http://blog.rujubu.com/articles/selecting-only-what-you-need)
50
+ for a project I was working on, I searched for lazy enumeration support in Ruby.
51
+ I came across this [blog post](http://www.michaelharrison.ws/weblog/?p=163) and
52
+ it became the inspiration for Lazing.
53
+
54
+ I later discovered that my implementation of `selecting` is almost identical
55
+ to the `infinite_select` example given in Programming Ruby: The Pragmatic
56
+ Programmers' Guide by Dave Thomas.
57
+
58
+ ## License
59
+ Lazing is Copyright (c) 2010 by Greg Spurrier and released under the terms of
60
+ the MIT License. Please see LICENSE.txt for details.
61
+
62
+
63
+
@@ -0,0 +1,16 @@
1
+ require 'rubygems'
2
+
3
+ begin
4
+ require 'jeweler'
5
+ Jeweler::Tasks.new do |gemspec|
6
+ gemspec.name = "lazing"
7
+ gemspec.summary = "Making Enumerable a little lazy"
8
+ gemspec.description = "Lazy equivalents for many of the methods in Enumerable"
9
+ gemspec.email = "greg@rujubu.com"
10
+ gemspec.homepage = "http://github.com/gregspurrier/lazing"
11
+ gemspec.author = "Greg Spurrier"
12
+ end
13
+ Jeweler::GemcutterTasks.new
14
+ rescue LoadError
15
+ puts "Jeweler not available. Install it with: gem install jeweler"
16
+ end
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 0.1.0
@@ -0,0 +1,54 @@
1
+ # Generated by jeweler
2
+ # DO NOT EDIT THIS FILE DIRECTLY
3
+ # Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
4
+ # -*- encoding: utf-8 -*-
5
+
6
+ Gem::Specification.new do |s|
7
+ s.name = %q{lazing}
8
+ s.version = "0.1.0"
9
+
10
+ s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
+ s.authors = ["Greg Spurrier"]
12
+ s.date = %q{2010-10-22}
13
+ s.description = %q{Lazy equivalents for many of the methods in Enumerable}
14
+ s.email = %q{greg@rujubu.com}
15
+ s.extra_rdoc_files = [
16
+ "LICENSE.txt",
17
+ "README.md"
18
+ ]
19
+ s.files = [
20
+ ".gitignore",
21
+ "LICENSE.txt",
22
+ "README.md",
23
+ "Rakefile",
24
+ "VERSION",
25
+ "lazing.gemspec",
26
+ "lib/lazing.rb",
27
+ "lib/lazing/filters.rb",
28
+ "lib/lazing/transformers.rb",
29
+ "spec/lazing/filters_spec.rb",
30
+ "spec/lazing/transformers_spec.rb",
31
+ "spec/spec_helper.rb"
32
+ ]
33
+ s.homepage = %q{http://github.com/gregspurrier/lazing}
34
+ s.rdoc_options = ["--charset=UTF-8"]
35
+ s.require_paths = ["lib"]
36
+ s.rubygems_version = %q{1.3.7}
37
+ s.summary = %q{Making Enumerable a little lazy}
38
+ s.test_files = [
39
+ "spec/lazing/filters_spec.rb",
40
+ "spec/lazing/transformers_spec.rb",
41
+ "spec/spec_helper.rb"
42
+ ]
43
+
44
+ if s.respond_to? :specification_version then
45
+ current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
46
+ s.specification_version = 3
47
+
48
+ if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
49
+ else
50
+ end
51
+ else
52
+ end
53
+ end
54
+
@@ -0,0 +1,2 @@
1
+ require File.expand_path('../lazing/filters', __FILE__)
2
+ require File.expand_path('../lazing/transformers', __FILE__)
@@ -0,0 +1,31 @@
1
+ module Enumerable
2
+ # Lazy version of Enumerable#reject.
3
+ #
4
+ # Returns a lazy collection containing all elements of the collection
5
+ # for which the provided block returns false.
6
+ def rejecting(&blk)
7
+ Enumerator.new do |yielder|
8
+ each do |item|
9
+ yielder.yield item unless blk.call(item)
10
+ end
11
+ end
12
+ end
13
+
14
+ # Lazy version of Enumerable#select
15
+ #
16
+ # Returns a lazy collection containing all elements of the collection
17
+ # for which the provided block returns true.
18
+ def selecting(&blk)
19
+ Enumerator.new do |yielder|
20
+ each do |item|
21
+ yielder.yield item if blk.call(item)
22
+ end
23
+ end
24
+ end
25
+
26
+ # Lazy version of Enumerable#find_all
27
+ #
28
+ # Returns a lazy collection containing all elements of the collection
29
+ # for which the provided block returns true.
30
+ alias finding_all selecting
31
+ end
@@ -0,0 +1,19 @@
1
+ module Enumerable
2
+ # Lazy version of Enumerable#map
3
+ #
4
+ # Returns the lazy collection formed by applying the given block to each
5
+ # member of the collection.
6
+ def mapping(&blk)
7
+ Enumerator.new do |yielder|
8
+ each do |item|
9
+ yielder.yield blk.call(item)
10
+ end
11
+ end
12
+ end
13
+
14
+ # Lazy version of Enumerable#collect
15
+ #
16
+ # Returns the lazy collection formed by applying the given block to each
17
+ # member of the collection.
18
+ alias collecting mapping
19
+ end
@@ -0,0 +1,37 @@
1
+ require File.expand_path('../../spec_helper', __FILE__)
2
+
3
+ describe Enumerable, '#finding_all' do
4
+ it 'returns a lazy collection matching the results of Enumerable#find_all' do
5
+ range = (1..20)
6
+ range.finding_all {|x| x.odd?}.to_a.should == range.find_all {|x| x.odd?}
7
+ end
8
+
9
+ it 'processes items on demand' do
10
+ (1..20).finding_all {|x| raise 'boom' if x == 6; x.odd?}.first(3).
11
+ should == [1,3,5]
12
+ end
13
+ end
14
+
15
+ describe Enumerable, '#rejecting' do
16
+ it 'returns a lazy collection matching the results of Enumerable#reject' do
17
+ range = (1..20)
18
+ range.rejecting {|x| x.odd?}.to_a.should == range.reject {|x| x.odd?}
19
+ end
20
+
21
+ it 'processes items on demand' do
22
+ (1..20).rejecting {|x| raise 'boom' if x == 6; x.even?}.first(3).
23
+ should == [1,3,5]
24
+ end
25
+ end
26
+
27
+ describe Enumerable, '#selecting' do
28
+ it 'returns a lazy collection matching the results of Enumerable#select' do
29
+ range = (1..20)
30
+ range.selecting {|x| x.odd?}.to_a.should == range.select {|x| x.odd?}
31
+ end
32
+
33
+ it 'processes items on demand' do
34
+ (1..20).selecting {|x| raise 'boom' if x == 6; x.odd?}.first(3).
35
+ should == [1,3,5]
36
+ end
37
+ end
@@ -0,0 +1,25 @@
1
+ require File.expand_path('../../spec_helper', __FILE__)
2
+
3
+ describe Enumerable, '#collecting' do
4
+ it 'returns a lazy collection matching the results of Enumerable#collect' do
5
+ range = (1..20)
6
+ range.collecting {|x| x * x}.to_a.should == range.collect {|x| x * x}
7
+ end
8
+
9
+ it 'processes items on demand' do
10
+ (1..20).collecting {|x| raise 'boom' if x == 4; x * x}.first(3).
11
+ should == [1,4,9]
12
+ end
13
+ end
14
+
15
+ describe Enumerable, '#mapping' do
16
+ it 'returns a lazy collection matching the results of Enumerable#map' do
17
+ range = (1..20)
18
+ range.mapping {|x| x * x}.to_a.should == range.map {|x| x * x}
19
+ end
20
+
21
+ it 'processes items on demand' do
22
+ (1..20).mapping {|x| raise 'boom' if x == 4; x * x}.first(3).
23
+ should == [1,4,9]
24
+ end
25
+ end
@@ -0,0 +1 @@
1
+ require File.expand_path('../../lib/lazing', __FILE__)
metadata ADDED
@@ -0,0 +1,78 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: lazing
3
+ version: !ruby/object:Gem::Version
4
+ prerelease: false
5
+ segments:
6
+ - 0
7
+ - 1
8
+ - 0
9
+ version: 0.1.0
10
+ platform: ruby
11
+ authors:
12
+ - Greg Spurrier
13
+ autorequire:
14
+ bindir: bin
15
+ cert_chain: []
16
+
17
+ date: 2010-10-22 00:00:00 -07:00
18
+ default_executable:
19
+ dependencies: []
20
+
21
+ description: Lazy equivalents for many of the methods in Enumerable
22
+ email: greg@rujubu.com
23
+ executables: []
24
+
25
+ extensions: []
26
+
27
+ extra_rdoc_files:
28
+ - LICENSE.txt
29
+ - README.md
30
+ files:
31
+ - .gitignore
32
+ - LICENSE.txt
33
+ - README.md
34
+ - Rakefile
35
+ - VERSION
36
+ - lazing.gemspec
37
+ - lib/lazing.rb
38
+ - lib/lazing/filters.rb
39
+ - lib/lazing/transformers.rb
40
+ - spec/lazing/filters_spec.rb
41
+ - spec/lazing/transformers_spec.rb
42
+ - spec/spec_helper.rb
43
+ has_rdoc: true
44
+ homepage: http://github.com/gregspurrier/lazing
45
+ licenses: []
46
+
47
+ post_install_message:
48
+ rdoc_options:
49
+ - --charset=UTF-8
50
+ require_paths:
51
+ - lib
52
+ required_ruby_version: !ruby/object:Gem::Requirement
53
+ none: false
54
+ requirements:
55
+ - - ">="
56
+ - !ruby/object:Gem::Version
57
+ segments:
58
+ - 0
59
+ version: "0"
60
+ required_rubygems_version: !ruby/object:Gem::Requirement
61
+ none: false
62
+ requirements:
63
+ - - ">="
64
+ - !ruby/object:Gem::Version
65
+ segments:
66
+ - 0
67
+ version: "0"
68
+ requirements: []
69
+
70
+ rubyforge_project:
71
+ rubygems_version: 1.3.7
72
+ signing_key:
73
+ specification_version: 3
74
+ summary: Making Enumerable a little lazy
75
+ test_files:
76
+ - spec/lazing/filters_spec.rb
77
+ - spec/lazing/transformers_spec.rb
78
+ - spec/spec_helper.rb