meta_where 0.9.0

data/test/fixtures/note.rb

@@ -0,0 +1,3 @@
+class Note < ActiveRecord::Base
+  belongs_to :notable, :polymorphic => true
+end

data/test/fixtures/notes.yml

@@ -0,0 +1,79 @@
+peter:
+  notable_type: Developer
+  notable_id  : 1
+  note        : A straight shooter with upper management written all over him.
+  
+michael:
+  notable_type: Developer
+  notable_id  : 2
+  note        : Doesn't like the singer of the same name. The nerve!
+
+samir:
+  notable_type: Developer
+  notable_id  : 3
+  note        : Naga.... Naga..... Not gonna work here anymore anyway.
+
+herb:
+  notable_type: Developer
+  notable_id  : 4
+  note        : Will show you what he's doing.
+
+dude:
+  notable_type: Developer
+  notable_id  : 5
+  note        : Nothing of note.
+
+ernie:
+  notable_type: Developer
+  notable_id  : 6
+  note        : Complete slacker. Should probably be fired.
+
+someone:
+  notable_type: Developer
+  notable_id  : 7
+  note        : Just another developer.
+
+another:
+  notable_type: Developer
+  notable_id  : 8
+  note        : Placing a note in this guy's file for insubordination.
+
+initech:
+  notable_type: Company
+  notable_id  : 1
+  note        : Innovation + Technology!
+
+aos:
+  notable_type: Company
+  notable_id  : 2
+  note        : Advanced solutions of an optical nature.
+
+mission_data:
+  notable_type: Company
+  notable_id  : 3
+  note        : Best design + development shop in the 'ville.
+
+y2k:
+  notable_type: Project
+  notable_id  : 1
+  note        : It may have already passed but that's no excuse to be unprepared!
+
+virus:
+  notable_type: Project
+  notable_id  : 2
+  note        : It could bring the company to its knees.
+
+awesome:
+  notable_type: Project
+  notable_id  : 3
+  note        : This note is AWESOME!!!
+
+metasearch:
+  notable_type: Project
+  notable_id  : 4
+  note        : A complete waste of the developer's time.
+
+another:
+  notable_type: Project
+  notable_id  : 5
+  note        : This is another project note.

data/test/fixtures/people.yml

@@ -0,0 +1,14 @@
+grandpa:
+  name     : Abraham
+  id       : 1
+  parent_id: nil
+
+father:
+  name     : Isaac
+  id       : 2
+  parent_id: 1
+
+son:
+  name     : Jacob
+  id       : 3
+  parent_id: 2

data/test/fixtures/person.rb

@@ -0,0 +1,4 @@
+class Person < ActiveRecord::Base
+  belongs_to :parent, :class_name => 'Person', :foreign_key => :parent_id
+  has_many   :children, :class_name => 'Person', :foreign_key => :parent_id
+end

data/test/fixtures/project.rb

@@ -0,0 +1,4 @@
+class Project < ActiveRecord::Base
+  has_and_belongs_to_many :developers
+  has_many :notes, :as => :notable
+end

data/test/fixtures/projects.yml

@@ -0,0 +1,24 @@
+y2k:
+  estimated_hours: 1000
+  name           : Y2K Software Updates
+  id             : 1
+
+virus:
+  estimated_hours: 80
+  name           : Virus
+  id             : 2
+  
+awesome:
+  estimated_hours: 100
+  name           : Do something awesome
+  id             : 3
+  
+metasearch:
+  estimated_hours: 100
+  name           : MetaSearch Development
+  id             : 4
+  
+another:
+  estimated_hours: 120
+  name           : Another Project
+  id             : 5

data/test/fixtures/schema.rb

@@ -0,0 +1,52 @@
+ActiveRecord::Schema.define do
+
+  create_table "companies", :force => true do |t|
+    t.string   "name"
+    t.datetime "created_at"
+    t.datetime "updated_at"
+  end
+  
+  create_table "developers", :force => true do |t|
+    t.integer  "company_id"
+    t.string   "name"
+    t.integer  "salary"
+    t.boolean  "slacker"
+  end
+  
+  create_table "projects", :force => true do |t|
+    t.string   "name"
+    t.float    "estimated_hours"
+  end
+  
+  create_table "developers_projects", :id => false, :force => true do |t|
+    t.integer  "developer_id"
+    t.integer  "project_id"
+  end
+  
+  create_table "notes", :force => true do |t|
+    t.string   "notable_type"
+    t.integer  "notable_id"
+    t.string   "note"
+  end
+
+  create_table "data_types", :force => true do |t|
+    t.integer  "company_id"
+    t.string   "str"
+    t.text     "txt"
+    t.integer  "int"
+    t.float    "flt"
+    t.decimal  "dec"
+    t.datetime "dtm"
+    t.timestamp "tms"
+    t.time     "tim"
+    t.date     "dat"
+    t.binary   "bin"
+    t.boolean  "bln"
+  end
+  
+  create_table "people", :force => true do |t|
+    t.integer  "parent_id"
+    t.string   "name"
+  end
+
+end

data/test/helper.rb

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'active_record'
+require 'active_record/fixtures'
+require 'active_support/time'
+
+FIXTURES_PATH = File.join(File.dirname(__FILE__), 'fixtures')
+
+Time.zone = 'Eastern Time (US & Canada)'
+
+ActiveRecord::Base.establish_connection(
+  :adapter => defined?(JRUBY_VERSION) ? 'jdbcsqlite3' : 'sqlite3',
+  :database => ':memory:'
+)
+
+dep = defined?(ActiveSupport::Dependencies) ? ActiveSupport::Dependencies : ::Dependencies
+dep.autoload_paths.unshift FIXTURES_PATH
+
+ActiveRecord::Base.silence do
+  ActiveRecord::Migration.verbose = false
+  load File.join(FIXTURES_PATH, 'schema.rb')
+end
+
+Fixtures.create_fixtures(FIXTURES_PATH, ActiveRecord::Base.connection.tables)
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'meta_where'
+MetaWhere.operator_overload!
+
+class Test::Unit::TestCase
+end

data/test/test_relations.rb

@@ -0,0 +1,225 @@
+require 'helper'
+
+class TestRelations < Test::Unit::TestCase
+  context "A company relation" do
+    setup do
+      @r = Company.scoped
+    end
+
+    should "behave as expected with one-level hash params" do
+      results = @r.where(:name => 'Initech')
+      assert_equal 1, results.size
+      assert_equal results.first, Company.find_by_name('Initech')
+    end
+
+    should "behave as expected with nested hash params" do
+      results = @r.where(
+        :developers => {
+          :name => 'Peter Gibbons',
+          :notes => {
+            :note => 'A straight shooter with upper management written all over him.'
+          }
+        }
+      )
+      assert_raises ActiveRecord::StatementInvalid do
+        results.all
+      end
+      results = results.joins(:developers => :notes)
+      assert_equal 1, results.size
+      assert_equal results.first, Company.find_by_name('Initech')
+    end
+
+    should "create new records with values from equality predicates" do
+      assert_equal "New Company",
+                   @r.where(:name => 'New Company').new.name
+      assert_equal "New Company",
+                   @r.where(:name.eq => 'New Company').new.name
+      assert_equal "New Company",
+                   @r.where(:name.eq % 'New Company').new.name
+    end
+
+    should "create new records with values from equality predicates using last supplied predicate" do
+      assert_equal "Newer Company",
+                   @r.where(:name => 'New Company').where(:name => 'Newer Company').new.name
+      assert_equal "Newer Company",
+                   @r.where(:name.eq => 'New Company').where(:name.eq => 'Newer Company').new.name
+      assert_equal "Newer Company",
+                   @r.where(:name.eq % 'New Company').where(:name.eq % 'Newer Company').new.name
+    end
+
+    should "behave as expected with SQL interpolation" do
+      results = @r.where('name like ?', '%tech')
+      assert_equal 1, results.size
+      assert_equal results.first, Company.find_by_name('Initech')
+    end
+
+    should "behave as expected with mixed hash and SQL interpolation" do
+      results = @r.where('name like ?', '%tech').where(:created_at => 100.years.ago..Time.now)
+      assert_equal 1, results.size
+      assert_equal results.first, Company.find_by_name('Initech')
+    end
+
+    should "allow multiple condition params in a single where" do
+      results = @r.where(['name like ?', '%tech'], :created_at => 100.years.ago..Time.now)
+      assert_equal 1, results.size
+      assert_equal results.first, Company.find_by_name('Initech')
+    end
+
+    should "allow predicate method selection on hash keys" do
+      assert_equal @r.where(:name.eq => 'Initech').all, @r.where(:name => 'Initech').all
+      assert_equal @r.where(:name.matches => 'Mission%').all, @r.where('name LIKE ?', 'Mission%').all
+    end
+
+    should "allow operators to select predicate methods" do
+      assert_equal @r.where(:name ^ 'Initech').all, @r.where('name != ?', 'Initech').all
+      assert_equal @r.where(:id + [1,3]).all, @r.where('id IN (?)', [1,3]).all
+      assert_equal @r.where(:name =~ 'Advanced%').all, @r.where('name LIKE ?', 'Advanced%').all
+    end
+
+    should "use % 'substitution' for hash key predicate methods" do
+      assert_equal @r.where(:name.like % 'Advanced%').all, @r.where('name LIKE ?', 'Advanced%').all
+    end
+
+    should "allow | and & for compound predicates" do
+      assert_equal @r.where(:name.like % 'Advanced%' | :name.like % 'Init%').all,
+                   @r.where('name LIKE ? OR name LIKE ?', 'Advanced%', 'Init%').all
+      assert_equal @r.where(:name.like % 'Mission%' & :name.like % '%Data').all,
+                   @r.where('name LIKE ? AND name LIKE ?', 'Mission%', '%Data').all
+    end
+
+    should "allow nested conditions hashes to have array values" do
+      assert_equal @r.joins(:data_types).where(:data_types => {:dec => 2..5}).all,
+                   @r.joins(:data_types).where(:data_types => [:dec >= 2, :dec <= 5]).all
+    end
+
+    should "allow combinations of options that no sane developer would ever try to use" do
+      assert_equal @r.find_all_by_name('Initech'),
+                   @r.joins(:data_types, :developers => [:projects, :notes]).
+                     where(
+                      {
+                        :data_types => [:dec > 3, {:bln.eq => true}]
+                      } &
+                      {
+                        :developers => {
+                          :name.like => 'Peter Gibbons'
+                        }
+                      } &
+                      {
+                        :developers => {
+                          :projects => {
+                            :estimated_hours.gteq => 1000
+                          },
+                          :notes => [:note.matches % '%straight shooter%']
+                        }
+                      }
+                     ).uniq
+    end
+
+    should "allow ordering by attributes in ascending order" do
+      last_created = @r.all.sort {|a, b| a.created_at <=> b.created_at}.last
+      assert_equal last_created, @r.order(:created_at.asc).last
+    end
+
+    should "allow ordering by attributes in descending order" do
+      last_created = @r.all.sort {|a, b| a.created_at <=> b.created_at}.last
+      assert_equal last_created, @r.order(:created_at.desc).first
+    end
+
+    should "allow ordering by attributes on nested associations" do
+      highest_paying = Developer.order(:salary.desc).first.company
+      assert_equal highest_paying, @r.joins(:developers).order(:developers => :salary.desc).first
+    end
+
+    context "with eager-loaded developers" do
+      setup do
+        @r = @r.includes(:developers).where(:developers => {:name => 'Ernie Miller'})
+      end
+
+      should "return the expected result" do
+        assert_equal Company.where(:name => 'Mission Data'), @r.all
+      end
+
+      should "generate debug SQL with the joins in place" do
+        assert_match /LEFT OUTER JOIN "developers"/, @r.debug_sql
+      end
+    end
+  end
+
+  context "A merged relation" do
+    setup do
+      @r = Developer.where(:salary.gteq % 70000) & Company.where(:name.matches % 'Initech')
+    end
+
+    should "keep the table of the second relation intact in the query" do
+      assert_match /#{Company.quoted_table_name}."name"/, @r.to_sql
+    end
+
+    should "return expected results" do
+      assert_equal ['Peter Gibbons', 'Michael Bolton'], @r.all.map(&:name)
+    end
+  end
+
+  context "A merged relation with an alternate association" do
+    setup do
+      @r = Company.scoped.merge(Developer.where(:salary.gt => 70000), :slackers)
+    end
+
+    should "use the proper association" do
+      assert_match Company.joins(:slackers).where(:slackers => {:salary.gt => 70000}).to_sql,
+                   @r.to_sql
+    end
+
+    should "return expected results" do
+      assert_equal ['Initech', 'Advanced Optical Solutions'], @r.all.map(&:name)
+    end
+  end
+
+  context "A Person relation" do
+    setup do
+      @r = Person.scoped
+    end
+
+    context "with self-referencing joins" do
+      setup do
+        @r = @r.where(:children => {:children => {:name => 'Jacob'}}).joins(:children => :children)
+      end
+
+      should "join the table multiple times with aliases" do
+        assert_equal 2, @r.to_sql.scan('INNER JOIN').size
+        assert_match /INNER JOIN "people" "children_people"/, @r.to_sql
+        assert_match /INNER JOIN "people" "children_people_2"/, @r.to_sql
+      end
+
+      should "place the condition on the correct join" do
+        assert_match /"children_people_2"."name" = 'Jacob'/, @r.to_sql
+      end
+
+      should "return the expected result" do
+        assert_equal Person.where(:name => 'Abraham'), @r.all
+      end
+    end
+
+    context "with self-referencing joins on parent and children" do
+      setup do
+        @r = @r.where(:children => {:children => {:parent => {:parent => {:name => 'Abraham'}}}})
+               .joins(:children => {:children => {:parent => :parent}})
+      end
+
+      should "join the table multiple times with aliases" do
+        assert_equal 4, @r.to_sql.scan('INNER JOIN').size
+        assert_match /INNER JOIN "people" "children_people"/, @r.to_sql
+        assert_match /INNER JOIN "people" "children_people_2"/, @r.to_sql
+        assert_match /INNER JOIN "people" "parents_people"/, @r.to_sql
+        assert_match /INNER JOIN "people" "parents_people_2"/, @r.to_sql
+      end
+
+      should "place the condition on the correct join" do
+        assert_match /"parents_people_2"."name" = 'Abraham'/, @r.to_sql
+      end
+
+      should "return the expected result" do
+        assert_equal Person.where(:name => 'Abraham'), @r.all
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification 
+name: meta_where
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 9
+  - 0
+  version: 0.9.0
+platform: ruby
+authors: 
+- Ernie Miller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-24 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        - rc2
+        version: 3.0.0.rc2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        - rc2
+        version: 3.0.0.rc2
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: arel
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        - rc1
+        version: 1.0.0.rc1
+  type: :runtime
+  version_requirements: *id004
+description: "\n      MetaWhere offers the ability to call any Arel predicate methods\n      (with a few convenient aliases) on your Model's attributes instead\n      of the ones normally offered by ActiveRecord's hash parameters. It also\n      adds convenient syntax for order clauses, smarter mapping of nested hash\n      conditions, and a debug_sql method to see the real SQL your code is\n      generating without running it against the database. If you like the new\n      AR 3.0 query interface, you'll love it with MetaWhere.\n    "
+email: ernie@metautonomo.us
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- .gitmodules
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/core_ext/hash.rb
+- lib/core_ext/symbol.rb
+- lib/core_ext/symbol_operators.rb
+- lib/meta_where.rb
+- lib/meta_where/builder.rb
+- lib/meta_where/column.rb
+- lib/meta_where/compound.rb
+- lib/meta_where/condition.rb
+- lib/meta_where/join_dependency.rb
+- lib/meta_where/relation.rb
+- lib/meta_where/utility.rb
+- meta_where.gemspec
+- test/fixtures/companies.yml
+- test/fixtures/company.rb
+- test/fixtures/data_type.rb
+- test/fixtures/data_types.yml
+- test/fixtures/developer.rb
+- test/fixtures/developers.yml
+- test/fixtures/developers_projects.yml
+- test/fixtures/note.rb
+- test/fixtures/notes.yml
+- test/fixtures/people.yml
+- test/fixtures/person.rb
+- test/fixtures/project.rb
+- test/fixtures/projects.yml
+- test/fixtures/schema.rb
+- test/helper.rb
+- test/test_relations.rb
+has_rdoc: true
+homepage: http://metautonomo.us/projects/metawhere/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Add a dash of Arel awesomeness to your condition hashes.
+test_files: 
+- test/fixtures/company.rb
+- test/fixtures/data_type.rb
+- test/fixtures/developer.rb
+- test/fixtures/note.rb
+- test/fixtures/person.rb
+- test/fixtures/project.rb
+- test/fixtures/schema.rb
+- test/helper.rb
+- test/test_relations.rb