enumeradical 0.9.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+-I lib/enumeradical

data/.rvmrc

@@ -0,0 +1 @@
+rvm use  1.9.3@enumeradical

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+
+script: bundle exec rspec spec

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in enumeradical.gemspec
+gemspec

data/README.markdown

@@ -0,0 +1,78 @@
+[![Build Status](https://secure.travis-ci.org/coreyhaines/enumeradical.png)](http://travis-ci.org/coreyhaines/enumeradical)
+
+# Enumeradical
+## A most amazing collection of useful functions filling common tasks when iterating over collections
+
+## What is this?
+I love enumerable. I really do. I use the functions it provides with the utmost alacrity. Nothing makes me sadder than seeing a #each used to populate an array. Once you start using them a lot in production systems, you notice a bunch of common patterns.
+
+## How do I use it?
+Install it, then
+    require 'enumeradical'
+
+###I have an array of objects, and I need to convert them to another type.
+
+    class MyNumberPresenter
+      def initialize(number)
+        @number = number
+      end
+    end
+
+    [1,2,3].map { |number| MyNumberPresenter.new(number) }
+    # => [#<MyNumberPresenter:0x0000010086b9c8 @number=1>, #<MyNumberPresenter:0x0000010086b630 @number=2>,
+          #<MyNumberPresenter:0x0000010086b540 @number=3>]
+
+NO MORE! Use Enumerable#map_to(type)
+
+    class MyNumberPresenter
+      def initialize(number)
+        @number = number
+      end
+    end
+
+    [1,2,3].map_to MyNumberPresenter
+    # => [#<MyNumberPresenter:0x0000010086b9c8 @number=1>, #<MyNumberPresenter:0x0000010086b630 @number=2>,
+          #<MyNumberPresenter:0x0000010086b540 @number=3>]
+
+###I have an array of objects, and I want to map them to the value they give from indexing into another object.
+
+    require 'date'
+    [1,2,3].map { |index| Date::ABBR_DAYNAMES[index] } # => ["Mon", "Tue", "Wed"]
+
+NO MORE! Use Enumerable#map_into
+
+    require 'date'
+    [1,2,3].map_into Date::ABBR_DAYNAMES # => ["Mon", "Tue", "Wed"]
+
+
+###I have an array of objects, and I'd like to convert them using a given object's method.
+
+    class Converter
+      def hellos(times)
+        "hello"*times
+      end
+    end
+
+    converter = Converter.new
+
+    [1,2,3].map { |times| converter.hellos(times) }
+    # => ["hello", "hellohello", "hellohellohello"]
+
+NO MORE! Use Object#map_over
+
+    class Converter
+      def hellos(times)
+        "hello"*times
+      end
+    end
+
+    converter = Converter.new
+
+    converter.map_over [1,2,3], :hellos
+    # => ["hello", "hellohello", "hellohellohello"]
+
+## Is this useful?
+YES!!!!! Use it.
+
+## Who built this
+Originally, [Corey Haines](http://github.com/coreyhaines) and [Ryan Briones](http://github.com/ryanbriones)

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/enumeradical.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "enumeradical/version"
+
+Gem::Specification.new do |s|
+  s.name        = "enumeradical"
+  s.version     = Enumeradical::VERSION
+  s.authors     = ["coreyhaines"]
+  s.email       = ["coreyhaines@gmail.com"]
+  s.summary     = %q{Enumeradical takes bland enumerable functions and uses them to create AMAZINGALITY!}
+  s.description = %q{Enumeradical is a collection of useful functions for iterating over collections in common ways.}
+
+  s.rubyforge_project = "enumeradical"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "travis-lint"
+  s.add_development_dependency "rspec"
+end

data/lib/enumeradical/core_extensions/enumerable.rb

@@ -0,0 +1,19 @@
+require 'enumeradical/core_extensions/object'
+
+module Enumerable
+  def map_into(into = nil)
+    do_map into, :[]
+  end
+
+  def map_to(to = nil)
+    do_map to, :new
+  end
+
+private
+  def do_map(obj, method)
+    return self unless obj
+    raise ArgumentError, "argument must respond to #{method}" unless obj.respond_to?(method)
+    obj.map_over(self, method)
+  end
+end
+

data/lib/enumeradical/core_extensions/object.rb

@@ -0,0 +1,11 @@
+module Enumeradical
+  module CoreExtensions
+    module Object
+      def map_over(this_list, with_this_method)
+        return [] unless this_list
+        raise ArgumentError.new("given list must support map") unless this_list.respond_to?(:map)
+        this_list.map &method(with_this_method)
+      end
+    end
+  end
+end

data/lib/enumeradical/version.rb

@@ -0,0 +1,3 @@
+module Enumeradical
+  VERSION = "0.9.0"
+end

data/lib/enumeradical.rb

@@ -0,0 +1,7 @@
+require_relative "enumeradical/version"
+require_relative "enumeradical/core_extensions/object"
+require_relative "enumeradical/core_extensions/enumerable"
+
+module Enumeradical
+end
+Object.send :include, Enumeradical::CoreExtensions::Object

data/spec/core_extensions/enumerable_spec.rb

@@ -0,0 +1,61 @@
+require "core_extensions/enumerable"
+Object.send :include, Enumeradical::CoreExtensions::Object
+
+describe "CoreExtensions::Enumerable" do
+  describe "#map_into" do
+    example "empty array maps into empty array" do
+      [].map_into.should be_empty
+    end
+
+    example "not passing an object is considered identity map" do
+      [1].map_into.should == [1]
+    end
+
+    it "looks up the value from given object" do
+      [1].map_into({1 => "foo"}).should == ["foo"]
+    end
+
+    context "invalid situations" do
+      context "mapping into a non-indexable object" do
+        it "raises ArgumentError" do
+          lambda {
+            [1].map_into(Object.new)
+          }.should raise_error(ArgumentError, "argument must respond to []")
+        end
+      end
+    end
+  end
+
+  describe "#map_to" do
+    class ObjectWithOnConstructorArgument
+      attr_accessor :arg
+      def initialize(arg)
+        @arg = arg
+      end
+    end
+
+    example "empty array maps into empty array" do
+      [].map_to.should be_empty
+    end
+
+    example "not passing an object is considered identity map" do
+      [1].map_to.should == [1]
+    end
+
+    it "instantiates the given object with item from array" do
+      created_object = [2].map_to(ObjectWithOnConstructorArgument).first
+      created_object.arg.should == 2
+    end
+
+    context "invalid situations" do
+      context "mapping into a object without .new" do
+        it "raises ArgumentError" do
+          lambda {
+            [1].map_to(Object.new)
+          }.should raise_error(ArgumentError, "argument must respond to new")
+        end
+      end
+    end
+  end
+end
+

data/spec/core_extensions/object_spec.rb

@@ -0,0 +1,34 @@
+require 'core_extensions/object'
+
+describe "CoreExtensions::Object" do
+  class MixedIn
+    include Enumeradical::CoreExtensions::Object
+    def multiple_by_two(number)
+      number*2
+    end
+  end
+
+  describe "#map_over" do
+    let(:object) { MixedIn.new }
+    let(:list) { [1,2,3] }
+    it "maps the method over each element of the given list" do
+      object.map_over(list, :multiple_by_two).should == [2,4,6]
+    end
+
+    it "supports passing a string as the name of the method" do
+      object.map_over(list, "multiple_by_two").should == [2,4,6]
+    end
+
+    context "invalid usage" do
+      it "requires a list that can be iterated over" do
+        lambda {
+        object.map_over(Object.new, :multiple_by_two).should == [2,4,6]
+        }.should raise_error(ArgumentError, "given list must support map")
+      end
+
+      it "returns an empty list if list is nil" do
+        object.map_over(nil, :multiple_by_two).should be_empty
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: enumeradical
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+  prerelease: 
+platform: ruby
+authors:
+- coreyhaines
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: travis-lint
+  requirement: &2152294480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2152294480
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2152293900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2152293900
+description: Enumeradical is a collection of useful functions for iterating over collections
+  in common ways.
+email:
+- coreyhaines@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- .travis.yml
+- Gemfile
+- README.markdown
+- Rakefile
+- enumeradical.gemspec
+- lib/enumeradical.rb
+- lib/enumeradical/core_extensions/enumerable.rb
+- lib/enumeradical/core_extensions/object.rb
+- lib/enumeradical/version.rb
+- spec/core_extensions/enumerable_spec.rb
+- spec/core_extensions/object_spec.rb
+homepage: 
+licenses: []
+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: enumeradical
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Enumeradical takes bland enumerable functions and uses them to create AMAZINGALITY!
+test_files:
+- spec/core_extensions/enumerable_spec.rb
+- spec/core_extensions/object_spec.rb