dm-ambition 1.1.0 → 1.2.0

data/.rvmrc

@@ -0,0 +1 @@
+rvm use @$(basename `pwd`) --create

data/.travis.yml

@@ -0,0 +1,83 @@
+bundler_args: --without guard metrics
+script: "bundle exec rake spec"
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - ruby-head
+  - ree
+  - jruby
+  - rbx
+env:
+  -
+  - JRUBY_OPTS="--1.8"
+  - JRUBY_OPTS="--1.9"
+  - RBXOPT="-X18"
+#  - RBXOPT="-X19"  # uncomment when rbx 1.9 mode is more stable
+matrix:
+  exclude:
+    # exclude 1.8.7
+    - rvm: 1.8.7
+      env: JRUBY_OPTS="--1.8"
+    - rvm: 1.8.7
+      env: JRUBY_OPTS="--1.9"
+    - rvm: 1.8.7
+      env: RBXOPT="-X18"
+    - rvm: 1.8.7
+      env: RBXOPT="-X19"
+
+    # exclude 1.9.2
+    - rvm: 1.9.2
+      env: JRUBY_OPTS="--1.8"
+    - rvm: 1.9.2
+      env: JRUBY_OPTS="--1.9"
+    - rvm: 1.9.2
+      env: RBXOPT="-X18"
+    - rvm: 1.9.2
+      env: RBXOPT="-X19"
+
+    # exclude 1.9.3
+    - rvm: 1.9.3
+      env: JRUBY_OPTS="--1.8"
+    - rvm: 1.9.3
+      env: JRUBY_OPTS="--1.9"
+    - rvm: 1.9.3
+      env: RBXOPT="-X18"
+    - rvm: 1.9.3
+      env: RBXOPT="-X19"
+
+    # exclude ruby-head
+    - rvm: ruby-head
+      env: JRUBY_OPTS="--1.8"
+    - rvm: ruby-head
+      env: JRUBY_OPTS="--1.9"
+    - rvm: ruby-head
+      env: RBXOPT="-X18"
+    - rvm: ruby-head
+      env: RBXOPT="-X19"
+
+    # exclude ree
+    - rvm: ree
+      env: JRUBY_OPTS="--1.8"
+    - rvm: ree
+      env: JRUBY_OPTS="--1.9"
+    - rvm: ree
+      env: RBXOPT="-X18"
+    - rvm: ree
+      env: RBXOPT="-X19"
+
+    # exclude jruby
+    - rvm: jruby
+      env:
+    - rvm: jruby
+      env: RBXOPT="-X18"
+    - rvm: jruby
+      env: RBXOPT="-X19"
+
+    # exclude rbx
+    - rvm: rbx
+      env:
+    - rvm: rbx
+      env: JRUBY_OPTS="--1.8"
+    - rvm: rbx
+      env: JRUBY_OPTS="--1.9"

data/Gemfile

@@ -1,41 +1,49 @@
-source 'http://rubygems.org'
+source :rubygems
 
 SOURCE         = ENV.fetch('SOURCE', :git).to_sym
 REPO_POSTFIX   = SOURCE == :path ? ''                                : '.git'
 DATAMAPPER     = SOURCE == :path ? Pathname(__FILE__).dirname.parent : 'http://github.com/datamapper'
-DM_VERSION     = '~> 1.1.0'
-DO_VERSION     = '~> 0.10.2'
+DM_VERSION     = '~> 1.2'
+DO_VERSION     = '~> 0.10.6'
 DM_DO_ADAPTERS = %w[ sqlite postgres mysql oracle sqlserver ]
 
 gem 'dm-core',   DM_VERSION, SOURCE => "#{DATAMAPPER}/dm-core#{REPO_POSTFIX}"
 gem 'ParseTree', '~> 3.0.7', :platforms => :mri_18
-gem 'ruby2ruby', '~> 1.2.5'
-gem 'sourcify',  '~> 0.4.2'
+gem 'ruby2ruby', '~> 1.3.1'
+gem 'sourcify',  '~> 0.5.0'
 
 group :development do
+  gem 'jeweler', '~> 1.6.4'
+  gem 'rake',    '~> 0.9.2'
+  gem 'rspec',   '~> 1.3.2'
+  gem 'yard',    '~> 0.7.2'
+end
 
-  gem 'dm-migrations', DM_VERSION, SOURCE => "#{DATAMAPPER}/dm-migrations#{REPO_POSTFIX}"
-  gem 'jeweler',       '~> 1.5.2'
-  gem 'rake',          '~> 0.8.7'
-  gem 'rspec',         '~> 1.3.1'
-
+group :guard do
+  gem 'guard',         '~> 0.7.0'
+  gem 'guard-bundler', '~> 0.1.3'
+  gem 'guard-rspec',   '~> 0.4.5'
 end
 
 platforms :mri_18 do
-  group :quality do
-
-    gem 'metric_fu', '~> 2.1.0'
-    gem 'rcov',      '~> 0.9.9'
-    gem 'reek',      '~> 1.2.8'
-    gem 'roodi',     '~> 2.1.0'
-    gem 'yard',      '~> 0.6.5'
-    gem 'yardstick', '~> 0.3.0'
-
+  group :metrics do
+    gem 'arrayfields', '~> 4.7.4'
+    gem 'fattr',       '~> 2.2.0'
+    gem 'flay',        '~> 1.4.2'
+    gem 'flog',        '~> 2.5.3'
+    gem 'heckle',      '~> 1.4.3'
+    gem 'json',        '~> 1.6.1'
+    gem 'map',         '~> 4.4.0'
+    gem 'metric_fu',   '~> 2.1.1'
+    gem 'mspec',       '~> 1.5.17'
+    gem 'rcov',        '~> 0.9.9'
+    gem 'reek',        '~> 1.2.8', :git => 'git://github.com/dkubb/reek.git'
+    gem 'roodi',       '~> 2.1.0'
+    gem 'yardstick',   '~> 0.4.0'
   end
 end
 
 group :datamapper do
-
   adapters = ENV['ADAPTER'] || ENV['ADAPTERS']
   adapters = adapters.to_s.tr(',', ' ').split.uniq - %w[ in_memory ]
 
@@ -63,5 +71,4 @@ group :datamapper do
   plugins.each do |plugin|
     gem plugin, DM_VERSION, SOURCE => "#{DATAMAPPER}/#{plugin}#{REPO_POSTFIX}"
   end
-
 end

data/README.md

@@ -0,0 +1,120 @@
+# dm-ambition
+
+DataMapper::Ambition is a plugin that provides an Ambition-like API for
+accessing DataMapper models.
+
+## Installation
+
+With Rubygems:
+
+```bash
+$ gem install dm-ambition
+$ irb -rubygems
+>> require 'dm-ambition'
+=> true
+```
+
+With git and local working copy:
+
+```bash
+$ git clone git://github.com/dkubb/dm-ambition.git
+$ cd dm-ambition
+$ rake install
+$ irb -rubygems
+>> require 'dm-ambition'
+=> true
+```
+
+## Testing
+
+The simplest way to test is with Bundler since it handles all dependencies:
+
+```bash
+$ rake local_gemfile
+$ BUNDLE_GEMFILE="Gemfile.local" ADAPTER="in_memory" bundle
+$ BUNDLE_GEMFILE="Gemfile.local" ADAPTER="in_memory" bundle exec rake spec
+```
+
+## Examples
+
+The standard Enumerable methods `select`, `detect`, `reject`, `find_all`, and
+`find` may be used with dm-ambition. These methods may be applied to the Model
+or Collection object.
+
+```ruby
+# with == operator
+model_or_collection.select { |u| u.name == 'Dan Kubb' }
+
+# with =~ operator
+model_or_collection.select { |u| u.name =~ /Dan Kubb/ }
+
+# with > operator
+model_or_collection.select { |u| u.id > 1 }
+
+# with >= operator
+model_or_collection.select { |u| u.id >= 1 }
+
+# with < operator
+model_or_collection.select { |u| u.id < 1 }
+
+# with <= operator
+model_or_collection.select { |u| u.id <= 1 }
+
+# with < operator
+model_or_collection.select { |u| u.id < 1 }
+
+# with receiver.attribute.nil?
+model_or_collection.select { |u| u.id.nil? }
+
+# with nil bind value
+model_or_collection.select { |u| u.id == nil }
+
+# with true bind value
+model_or_collection.select { |u| u.admin == true }
+
+# with false bind value
+model_or_collection.select { |u| u.admin == false }
+
+# with AND conditions
+model_or_collection.select { |u| u.id == 1 && u.name == 'Dan Kubb' }
+
+# with negated conditions
+model_or_collection.select { |u| !(u.id == 1) }
+
+# with double-negated conditions
+model_or_collection.select { |u| !(!(u.id == 1)) }
+
+# with matching from receiver
+model_or_collection.select { |u| u == user }
+
+# with matching to receiver
+model_or_collection.select { |u| user == u }
+
+# using send on receiver
+model_or_collection.select { |u| u.send(:name) == 'Dan Kubb' }
+
+# with Array#include?
+model_or_collection.select { |u| user_ids.include?(u.id) }
+
+# with Range#include?
+model_or_collection.select { |u| (1..10).include?(u.id) }
+
+# with Hash#key?
+model_or_collection.select { |u| { 1 => 'Dan Kubb' }.key?(u.id) }
+
+# with Hash#value?
+model_or_collection.select { |u| { 'Dan Kubb' => 1 }.value?(u.id) }
+
+# with receiver and Array#include?
+model_or_collection.select { |u| users.include?(u) }
+
+# with receiver and Hash#key?
+model_or_collection.select { |u| { user => 'Dan Kubb' }.key?(u) }
+
+# with receiver and Hash#value?
+model_or_collection.select { |u| { 'Dan Kubb' => user }.value?(u) }
+```
+
+## Copyright
+
+Copyright &copy; 2009-2011 Dan Kubb. See LICENSE for details.

data/Rakefile

@@ -4,7 +4,7 @@ require 'rake'
 require File.expand_path('../lib/dm-ambition/version', __FILE__)
 
 begin
-  gem 'jeweler', '~> 1.5.2'
+  gem 'jeweler', '~> 1.6.4'
   require 'jeweler'
 
   Jeweler::Tasks.new do |gem|

data/dm-ambition.gemspec

@@ -4,25 +4,27 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
-  s.name = %q{dm-ambition}
-  s.version = "1.1.0"
+  s.name = "dm-ambition"
+  s.version = "1.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Dan Kubb"]
-  s.date = %q{2011-04-06}
-  s.description = %q{DataMapper plugin providing an Ambition-like API}
-  s.email = %q{dan.kubb@gmail.com}
+  s.date = "2011-10-25"
+  s.description = "DataMapper plugin providing an Ambition-like API"
+  s.email = "dan.kubb@gmail.com"
   s.extra_rdoc_files = [
     "LICENSE",
-    "README.rdoc",
+    "README.md",
     "TODO"
   ]
   s.files = [
     ".document",
+    ".rvmrc",
+    ".travis.yml",
     "Gemfile",
     "LICENSE",
     "Manifest.txt",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "TODO",
     "dm-ambition.gemspec",
@@ -48,51 +50,44 @@ Gem::Specification.new do |s|
     "tasks/yard.rake",
     "tasks/yardstick.rake"
   ]
-  s.homepage = %q{http://github.com/dkubb/dm-ambition}
+  s.homepage = "http://github.com/dkubb/dm-ambition"
   s.require_paths = ["lib"]
   s.required_ruby_version = Gem::Requirement.new("~> 1.8.7")
-  s.rubyforge_project = %q{dm-ambition}
-  s.rubygems_version = %q{1.7.2}
-  s.summary = %q{DataMapper plugin providing an Ambition-like API}
-  s.test_files = [
-    "spec/public/collection_spec.rb",
-    "spec/public/model_spec.rb",
-    "spec/public/shared/filter_shared_spec.rb",
-    "spec/semipublic/query_spec.rb",
-    "spec/spec_helper.rb"
-  ]
+  s.rubyforge_project = "dm-ambition"
+  s.rubygems_version = "1.8.11"
+  s.summary = "DataMapper plugin providing an Ambition-like API"
 
   if s.respond_to? :specification_version then
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<dm-core>, ["~> 1.1.0"])
+      s.add_runtime_dependency(%q<dm-core>, ["~> 1.2"])
       s.add_runtime_dependency(%q<ParseTree>, ["~> 3.0.7"])
-      s.add_runtime_dependency(%q<ruby2ruby>, ["~> 1.2.5"])
-      s.add_runtime_dependency(%q<sourcify>, ["~> 0.4.2"])
-      s.add_development_dependency(%q<dm-migrations>, ["~> 1.1.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
-      s.add_development_dependency(%q<rake>, ["~> 0.8.7"])
-      s.add_development_dependency(%q<rspec>, ["~> 1.3.1"])
+      s.add_runtime_dependency(%q<ruby2ruby>, ["~> 1.3.1"])
+      s.add_runtime_dependency(%q<sourcify>, ["~> 0.5.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rake>, ["~> 0.9.2"])
+      s.add_development_dependency(%q<rspec>, ["~> 1.3.2"])
+      s.add_development_dependency(%q<yard>, ["~> 0.7.2"])
     else
-      s.add_dependency(%q<dm-core>, ["~> 1.1.0"])
+      s.add_dependency(%q<dm-core>, ["~> 1.2"])
       s.add_dependency(%q<ParseTree>, ["~> 3.0.7"])
-      s.add_dependency(%q<ruby2ruby>, ["~> 1.2.5"])
-      s.add_dependency(%q<sourcify>, ["~> 0.4.2"])
-      s.add_dependency(%q<dm-migrations>, ["~> 1.1.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
-      s.add_dependency(%q<rake>, ["~> 0.8.7"])
-      s.add_dependency(%q<rspec>, ["~> 1.3.1"])
+      s.add_dependency(%q<ruby2ruby>, ["~> 1.3.1"])
+      s.add_dependency(%q<sourcify>, ["~> 0.5.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rake>, ["~> 0.9.2"])
+      s.add_dependency(%q<rspec>, ["~> 1.3.2"])
+      s.add_dependency(%q<yard>, ["~> 0.7.2"])
     end
   else
-    s.add_dependency(%q<dm-core>, ["~> 1.1.0"])
+    s.add_dependency(%q<dm-core>, ["~> 1.2"])
     s.add_dependency(%q<ParseTree>, ["~> 3.0.7"])
-    s.add_dependency(%q<ruby2ruby>, ["~> 1.2.5"])
-    s.add_dependency(%q<sourcify>, ["~> 0.4.2"])
-    s.add_dependency(%q<dm-migrations>, ["~> 1.1.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
-    s.add_dependency(%q<rake>, ["~> 0.8.7"])
-    s.add_dependency(%q<rspec>, ["~> 1.3.1"])
+    s.add_dependency(%q<ruby2ruby>, ["~> 1.3.1"])
+    s.add_dependency(%q<sourcify>, ["~> 0.5.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rake>, ["~> 0.9.2"])
+    s.add_dependency(%q<rspec>, ["~> 1.3.2"])
+    s.add_dependency(%q<yard>, ["~> 0.7.2"])
   end
 end
 

data/lib/dm-ambition/query.rb

@@ -1,20 +1,29 @@
 module DataMapper
   module Ambition
     module Query
-      @@sexps = {}
 
       # TODO: spec and document this
       # @api semipublic
       def filter(&block)
-        # TODO: benchmark Marshal versus just building the sexp on demand
+        processor = FilterProcessor.new(block.binding, model)
+        processor.process(sexp_for(block))
+        self.class.new(repository, model, options.merge(:conditions => conditions & processor.conditions))
+      end
 
-        # deep clone the sexp for multiple re-use
-        sexp = Marshal.load(@@sexps[block.to_s] ||= Marshal.dump(block.to_sexp))
+    private
 
-        processor = FilterProcessor.new(block.binding, model)
-        processor.process(sexp)
+      if defined?(RUBY_ENGINE) && RUBY_ENGINE == 'rbx'
+        # do not deep clone sexp
+        def sexp_for(block)
+          block.to_sexp
+        end
+      else
+        @@sexps = {}
 
-        self.class.new(repository, model, options.merge(:conditions => conditions & processor.conditions))
+        # deep clone the sexp for multiple re-use
+        def sexp_for(block)
+          Marshal.load(@@sexps[block.to_s] ||= Marshal.dump(block.to_sexp))
+        end
       end
 
     end # module Query

data/lib/dm-ambition/query/filter_processor.rb

@@ -4,6 +4,8 @@ module DataMapper
       class FilterProcessor < SexpProcessor
         attr_reader :conditions
 
+        SEND_METHODS = [ :send, :__send__ ].freeze
+
         def initialize(binding, model)
           super()
 
@@ -32,7 +34,7 @@ module DataMapper
           operator = exp.shift
           rhs      = process(exp.shift)
 
-          while [ :send, :__send__ ].include?(operator)
+          while SEND_METHODS.include?(operator)
             operator = rhs.shift
           end
 

data/lib/dm-ambition/version.rb

@@ -1,5 +1,5 @@
 module DataMapper
   module Ambition
-    VERSION = '1.1.0'
+    VERSION = '1.2.0'
   end
 end

data/spec/semipublic/query_spec.rb

@@ -18,6 +18,8 @@ describe DataMapper::Ambition::Query do
       property :last_name,  String, :key => true
     end
 
+    DataMapper.finalize
+
     if DataMapper.respond_to?(:auto_migrate!)
       DataMapper.auto_migrate!
     end

data/spec/spec_helper.rb

@@ -1,3 +1,5 @@
+ENV['ADAPTER'] ||= 'in_memory'
+
 require 'dm-ambition'
 
 require 'dm-core/spec/setup'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: dm-ambition
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 31
   prerelease: 
   segments: 
   - 1
-  - 1
+  - 2
   - 0
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors: 
 - Dan Kubb
@@ -15,25 +15,26 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-06 00:00:00 Z
+date: 2011-10-25 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 19
+        hash: 11
         segments: 
         - 1
-        - 1
-        - 0
-        version: 1.1.0
+        - 2
+        version: "1.2"
   version_requirements: *id001
   name: dm-core
-  prerelease: false
-  type: :runtime
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -47,25 +48,25 @@ dependencies:
         version: 3.0.7
   version_requirements: *id002
   name: ParseTree
-  prerelease: false
-  type: :runtime
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 21
+        hash: 25
         segments: 
         - 1
-        - 2
-        - 5
-        version: 1.2.5
+        - 3
+        - 1
+        version: 1.3.1
   version_requirements: *id003
   name: ruby2ruby
-  prerelease: false
-  type: :runtime
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -74,77 +75,75 @@ dependencies:
         hash: 11
         segments: 
         - 0
-        - 4
-        - 2
-        version: 0.4.2
+        - 5
+        - 0
+        version: 0.5.0
   version_requirements: *id004
   name: sourcify
-  prerelease: false
-  type: :runtime
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
   requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 19
+        hash: 7
         segments: 
         - 1
-        - 1
-        - 0
-        version: 1.1.0
+        - 6
+        - 4
+        version: 1.6.4
   version_requirements: *id005
-  name: dm-migrations
-  prerelease: false
-  type: :development
+  name: jeweler
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
   requirement: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 7
+        hash: 63
         segments: 
-        - 1
-        - 5
+        - 0
+        - 9
         - 2
-        version: 1.5.2
+        version: 0.9.2
   version_requirements: *id006
-  name: jeweler
-  prerelease: false
-  type: :development
+  name: rake
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
   requirement: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 49
+        hash: 31
         segments: 
-        - 0
-        - 8
-        - 7
-        version: 0.8.7
+        - 1
+        - 3
+        - 2
+        version: 1.3.2
   version_requirements: *id007
-  name: rake
-  prerelease: false
-  type: :development
+  name: rspec
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
   requirement: &id008 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 25
+        hash: 7
         segments: 
-        - 1
-        - 3
-        - 1
-        version: 1.3.1
+        - 0
+        - 7
+        - 2
+        version: 0.7.2
   version_requirements: *id008
-  name: rspec
-  prerelease: false
-  type: :development
+  name: yard
 description: DataMapper plugin providing an Ambition-like API
 email: dan.kubb@gmail.com
 executables: []
@@ -153,14 +152,16 @@ extensions: []
 
 extra_rdoc_files: 
 - LICENSE
-- README.rdoc
+- README.md
 - TODO
 files: 
 - .document
+- .rvmrc
+- .travis.yml
 - Gemfile
 - LICENSE
 - Manifest.txt
-- README.rdoc
+- README.md
 - Rakefile
 - TODO
 - dm-ambition.gemspec
@@ -216,13 +217,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: dm-ambition
-rubygems_version: 1.7.2
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: DataMapper plugin providing an Ambition-like API
-test_files: 
-- spec/public/collection_spec.rb
-- spec/public/model_spec.rb
-- spec/public/shared/filter_shared_spec.rb
-- spec/semipublic/query_spec.rb
-- spec/spec_helper.rb
+test_files: []
+

data/README.rdoc

@@ -1,127 +0,0 @@
-= dm-ambition
-
-DataMapper::Ambition is a plugin that provides an Ambition-like API for
-accessing DataMapper models.
-
-== Installation
-
-With Rubygems:
-
-  $ gem install dm-ambition
-  $ irb -rubygems
-  >> require 'dm-ambition'
-  => true
-
-With git and local working copy:
-
-  $ git clone git://github.com/dkubb/dm-ambition.git
-  $ cd dm-ambition
-  $ rake install
-  $ irb -rubygems
-  >> require 'dm-ambition'
-  => true
-
-== Testing
-
-The simplest way to test is with Bundler since it handles all dependencies:
-
-  $ rake local_gemfile
-  $ BUNDLE_GEMFILE="Gemfile.local" ADAPTER="in_memory" bundle install --without=quality --relock
-  $ BUNDLE_GEMFILE="Gemfile.local" ADAPTER="in_memory" bundle exec rake spec
-
-== Examples
-
-    # with == operator
-    User.select { |u| u.name == 'Dan Kubb' }
-
-    # with =~ operator
-    User.select { |u| u.name =~ /Dan Kubb/ }
-
-    # with > operator
-    User.select { |u| u.id > 1 }
-
-    # with >= operator
-    User.select { |u| u.id >= 1 }
-
-    # with < operator
-    User.select { |u| u.id < 1 }
-
-    # with <= operator
-    User.select { |u| u.id <= 1 }
-
-    # with < operator
-    User.select { |u| u.id < 1 }
-
-    # with receiver.attribute.nil?
-    User.select { |u| u.id.nil? }
-
-    # with nil bind value
-    User.select { |u| u.id == nil }
-
-    # with true bind value
-    User.select { |u| u.admin == true }
-
-    # with false bind value
-    User.select { |u| u.admin == false }
-
-    # with AND conditions
-    User.select { |u| u.id == 1 && u.name == 'Dan Kubb' }
-
-    # with negated conditions
-    User.select { |u| !(u.id == 1) }
-
-    # with double-negated conditions
-    User.select { |u| !(!(u.id == 1)) }
-
-    # with matching from receiver
-    User.select { |u| u == user }
-
-    # with matching to receiver
-    User.select { |u| user == u }
-
-    # using send on receiver
-    User.select { |u| u.send(:name) == 'Dan Kubb' }
-
-    # with Array#include?
-    User.select { |u| user_ids.include?(u.id) }
-
-    # with Range#include?
-    User.select { |u| (1..10).include?(u.id) }
-
-    # with Hash#key?
-    User.select { |u| { 1 => 'Dan Kubb' }.key?(u.id) }
-
-    # with Hash#value?
-    User.select { |u| { 'Dan Kubb' => 1 }.value?(u.id) }
-
-    # with receiver and Array#include?
-    User.select { |u| users.include?(u) }
-
-    # with receiver and Hash#key?
-    User.select { |u| { user => 'Dan Kubb' }.key?(u) }
-
-    # with receiver and Hash#value?
-    User.select { |u| { 'Dan Kubb' => user }.value?(u) }
-
-== License
-
-Copyright (c) 2011 Dan Kubb
-
-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.