find_and_map 0.0.1 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ec8bda77640bab8d4459ced41874cd2f3ab65cf3
+  data.tar.gz: 2006dfe86966a77770c4c481705d80cb116bd830
+SHA512:
+  metadata.gz: 2ef7aaec1f5c473a9f50008b7c7dbc8f1151dad0eaf22171116a9a36266340fdfca8fcb4051dc72312fc71d671621044d0a41075bcfdf559497130b07231f159
+  data.tar.gz: 7ffb9f11e3aa8c99b338f2f65dd357ec86d130f7cca348b37dd65eddde118afd11ac3f075fa75cd153c1ac2f4f88836edf834a9e00f1d860058fe269a94d5b6d

data/.ruby-gemset

@@ -0,0 +1 @@
+find_and_map

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p247

data/Gemfile

@@ -1,3 +1,3 @@
-source :rubygems
+source 'https://rubygems.org'
 
 gemspec

data/README.markdown

@@ -1,19 +1,45 @@
 Find and Map
 ============
 
-    Anthony M. Cook (2012)
+    Anthony M. Cook (2013)
 
-I was looking for a way to simply find the first matching element in an enumerable and return a mapped result.
+Finds and retuns the value of the block.
 
-For example:
+Usage
+-----
 
-````ruby
+Put it in your Gemfile:
+
+```ruby
+gem 'find_and_map'
+```
+
+Then you can include it on your own Enumerable object:
+
+```ruby
+include FindAndMap
+```
+
+Or you can use the core extension directly the Gemfile:
+
+```ruby
+gem 'find_and_map', require: 'find_and_map/core_ext'
+```
+
+Then you can use it like this:
+
+```ruby
 {a: 1, b: 2}.find_and_map do |key, value|
   value if key == :a
 end #=> 1
-````
+```
+
+Background
+----------
+
+I was looking for a way to simply find the first matching element in an enumerable and return a mapped result.
 
-Using the same block above `find` returns `[:a, 1]` and `map` returns `[1, nil]`. But I want just the value, or even some other object based on it, but only that and nothing else.
+Using the same block above (in the Usage section) `find` returns `[:a, 1]` and `map` returns `[1, nil]`. But I want just the value, or even some other object based on it, but only that and nothing else.
 
 This method finds the first match (like `Enumerable#find`) and then return the result of the block rather than the matching element (like `Enumerable#map`).
 

data/find_and_map.gemspec

@@ -16,4 +16,10 @@ Gem::Specification.new do |gem|
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'bundler', '~> 1.3'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec', '~> 2.13'
+  gem.add_development_dependency 'pry'
+  gem.add_development_dependency 'pry-theme'
 end

data/lib/find_and_map.rb

@@ -4,7 +4,8 @@ module FindAndMap
   def find_and_map
     self.each do |*element|
       result = yield *element
-      break result if result
+      return result if result
     end
+    return nil
   end
 end

data/lib/find_and_map/core_ext.rb

@@ -0,0 +1,8 @@
+require_relative '../find_and_map'
+
+module Enumerable
+  def find_and_map &block
+    self.extend FindAndMap
+    find_and_map &block
+  end
+end

data/lib/find_and_map/version.rb

@@ -1,3 +1,3 @@
 module FindAndMap
-  VERSION = "0.0.1"
+  VERSION = "1.0.0"
 end

data/spec/core_ext.rb

@@ -0,0 +1,8 @@
+require 'rspec'
+require_relative '../lib/find_and_map/core_ext'
+
+describe "Core Extension" do
+  it 'is automatically included on Enumerable objects' do
+    Hash.instance_methods.should include(:find_and_map)
+  end
+end

data/spec/core_ext_spec.rb

@@ -0,0 +1,15 @@
+require 'rspec'
+
+describe "Core Extension" do
+  before :all do
+    require_relative '../lib/find_and_map/core_ext'
+  end
+
+  after :all do
+    Enumerable.send :remove_method, :find_and_map
+  end
+
+  it 'is automatically included on Enumerable objects' do
+    Hash.instance_methods.should include(:find_and_map)
+  end
+end

data/spec/find_and_map_spec.rb

@@ -1,17 +1,24 @@
 require 'rspec'
-require 'pry'
 require_relative '../lib/find_and_map'
 
 describe FindAndMap do
-  specify { subject.should be_a(Module)}
+  let(:data) { [1, 2, 3] }
+  let(:collection) { data.extend subject; data }
+  it { should be_a(Module) }
 
   it 'finds the first item that returns non-nil and returns the result' do
-    a = [1,2,3]
-    a.extend FindAndMap
-    a.find_and_map do |element|
+    collection.find_and_map do |element|
       if element == 2 then
         'hi!'
       end
     end.should == 'hi!'
   end
+
+  it 'returns nil if nothing found' do
+    collection.find_and_map do |element|
+      if element == 500 then
+        'BOGUS'
+      end
+    end.should == nil
+  end
 end

metadata

@@ -1,16 +1,85 @@
 --- !ruby/object:Gem::Specification
 name: find_and_map
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 1.0.0
 platform: ruby
 authors:
 - Anthony Cook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-27 00:00:00.000000000 Z
-dependencies: []
+date: 2013-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: pry-theme
+  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: Finds the first element for which the block returns non-falsy and returns
   the value.
 email:
@@ -21,38 +90,43 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - .rspec
+- .ruby-gemset
+- .ruby-version
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.markdown
 - Rakefile
 - find_and_map.gemspec
 - lib/find_and_map.rb
+- lib/find_and_map/core_ext.rb
 - lib/find_and_map/version.rb
+- spec/core_ext.rb
+- spec/core_ext_spec.rb
 - spec/find_and_map_spec.rb
 homepage: http://github.com/acook/find_and_map
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.6
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Hybrid of find and map!
 test_files:
+- spec/core_ext.rb
+- spec/core_ext_spec.rb
 - spec/find_and_map_spec.rb