chooser 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 400914377a1ff29eecb4968892ed4ca23ba3765c
+  data.tar.gz: 5d825e61dc9212243384b286cf8efad66532f001
+SHA512:
+  metadata.gz: 19187b4739a791535150822ae36d12e91aeaca23ec726760faa99c1233d8dc8531485f93b38540fbb4747af9c5f8f9464cb45761b59fcaa221adb9b7892b671f
+  data.tar.gz: 7a5b50a163549081e75454ed799063738ae9b755c7930df1deec100ca925ba58525ade2fab90c156699766ce5474984d4832eea356737114d0fafe22eeec0858

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Alexander Avoyants
+
+MIT License
+
+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,64 @@
+# Chooser
+
+Provides short interface for choosig elements from array of structs.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'chooser'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install chooser
+
+## Usage
+
+Given array of struct kind objects.
+
+```rb
+Person = Struct.new(:name, :profession, :address, :age)
+
+alex = Person.new("Alex", "Programmer", "123 Maple, Anytown NC", 27)
+dave = Person.new("Dave", "Programmer", "236 Main", 32)
+nick = Person.new("Nick", "Designer", "237 Main st.", 29)
+jack = Person.new("Jack", "QA", "1010 Center st.", 29)
+
+people = [alex, dave, nick, jack]
+```
+
+Filtering elements by attribute equality.
+
+```rb
+people.choose(:profession => "Programmer") # => [alex, dave]
+```
+
+Filtering elements by attribute equality and inclusion.
+
+```rb
+people.choose(:profession => "Designer", :age => (29..32)) # => [nick]
+```
+
+Filtering elements by matching regexp.
+
+```rb
+people.choose(:address => /Main/) # => [dave, nick]
+```
+
+Filtering elements by instance evaluating string.
+
+```rb
+people.choose("age >= 29") # => [dave, nick, jack]
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/chooser/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,3 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+task default: :spec

data/chooser.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'chooser/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "chooser"
+  spec.version       = Chooser::VERSION
+  spec.authors       = ["Alexander Avoyants"]
+  spec.email         = ["shhavel@gmail.com"]
+  spec.summary       = %q{Provides short interface for choosig elements from array of structs.}
+  spec.description   = %q{Provides short interface for choosig elements from array of structs, e.g. target.choose(:street => "Main", :age => [24..30]) or target.choose("address =~ /Main/")}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/lib/chooser/version.rb

@@ -0,0 +1,3 @@
+module Chooser
+  VERSION = "0.0.1"
+end

data/lib/chooser.rb

@@ -0,0 +1,27 @@
+require "chooser/version"
+
+module Chooser
+  def choose(selector)
+    ary = []
+    if selector.is_a?(Hash)
+      each do |ob|
+        ary << ob if selector.all? do |m, v|
+          ob.public_send(m) == v ||
+          (v.respond_to?(:include?) && v.include?(ob.public_send(m))) ||
+          (v.is_a?(Regexp) && v =~ ob.public_send(m))
+        end
+      end
+    elsif selector.is_a?(String)
+      each do |ob|
+        ary << ob if !!ob.instance_eval(selector)
+      end
+    else
+      raise ArgumentError, 'Supply an options hash (e.g. target.choose :street => "Main", :age => [24..30]) or evaluated string (e.g. target.choose "address =~ /Main/").'
+    end
+    ary
+  end
+end
+
+class Array
+  include Chooser
+end

data/spec/chooser_spec.rb

@@ -0,0 +1,65 @@
+require "spec_helper"
+
+describe "Array#choose" do
+  let(:alex) { Person.new("Alex", "Programmer", "123 Maple, Anytown NC", 27) }
+  let(:dave) { Person.new("Dave", "Programmer", "236 Main", 32) }
+  let(:nick) { Person.new("Nick", "Designer", "237 Main st.", 29) }
+  let(:jack) { Person.new("Jack", "QA", "1010 Center st.", 29) }
+  let(:people) { [alex, dave, nick, jack] }
+
+  context "choose elements by attribute equality" do
+    it "chooses elements with requested profession" do
+      expect(people.choose(:profession => "Programmer")).to match_array([alex, dave])
+    end
+
+    it "chooses elements with requested age" do
+      expect(people.choose(:age => 29)).to match_array([nick, jack])
+    end
+
+    it "chooses elements with requested profession and age" do
+      expect(people.choose(:profession => "Designer", :age => 29)).to match_array([nick])
+    end
+
+    it "returns empty array if no match found" do
+      expect(people.choose(:profession => "Designer", :age => 34)).to eq([])
+    end
+  end
+
+  context "choose elements by attribute inclusion" do
+    it "chooses elements with age included into requested array" do
+      expect(people.choose(:age => [29, 32])).to match_array([dave, nick, jack])
+    end
+
+    it "chooses elements with age included into requested array and with requested profession" do
+      expect(people.choose(:age => [29, 32], :profession => "QA")).to match_array([jack])
+    end
+
+    it "chooses elements with age included into requested range and with requested profession" do
+      expect(people.choose(:age => (27..29))).to match_array([alex, nick, jack])
+    end
+
+    it "chooses elements with age included into requested range and with matching profession" do
+      expect(people.choose(:age => (27..29), :profession => /Designer|QA/)).to match_array([nick, jack])
+    end
+
+    it "chooses elements with natched address" do
+      expect(people.choose(:address => /Main/)).to match_array([dave, nick])
+    end
+  end
+
+  context "choose elements by passing evaluated string of code" do
+    it "chooses elements with matched address" do
+      expect(people.choose("address =~ /Main/")).to match_array([dave, nick])
+    end
+
+    it "chooses elements with age less or euqual than requested" do
+      expect(people.choose("age <= 29")).to match_array([alex, nick, jack])
+    end
+  end
+
+  context "incorrect arguments" do
+    it "raises exception if receives incorrect argument" do
+      expect { people.choose([27, 29]) }.to raise_error ArgumentError
+    end
+  end 
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require "chooser"
+
+Dir["./spec/support/**/*.rb"].sort.each {|f| require f}
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+end

data/spec/support/person.rb

@@ -0,0 +1 @@
+Person = Struct.new(:name, :profession, :address, :age)

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: chooser
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Alexander Avoyants
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Provides short interface for choosig elements from array of structs,
+  e.g. target.choose(:street => "Main", :age => [24..30]) or target.choose("address
+  =~ /Main/")
+email:
+- shhavel@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- chooser.gemspec
+- lib/chooser.rb
+- lib/chooser/version.rb
+- spec/chooser_spec.rb
+- spec/spec_helper.rb
+- spec/support/person.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Provides short interface for choosig elements from array of structs.
+test_files:
+- spec/chooser_spec.rb
+- spec/spec_helper.rb
+- spec/support/person.rb