benhoskings-ambitious-activerecord 0.1.3.7 → 0.1.3.8

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2007 Chris Wanstrath
+
+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

@@ -0,0 +1,234 @@
+h2. An Ambitious ActiveRecord Adapter
+
+I could tell you all about how awesome the internals are, or 
+how fun it was to write, or how it'll make you rich and famous, 
+but instead I'm just going to show you some examples. 
+
+h2. Get It 
+
+@$ sudo gem install ambitious-activerecord@
+
+This will suck in the adapter and its dependencies (ActiveRecord & Ambition). 
+It's fully usable outside of Rails (I use it in a Camping app or two), as long
+as you're riding ActiveRecord.
+
+Now require it in your app:
+
+<pre>
+require 'rubygems'
+require 'ambition/adapters/activerecord'
+</pre>
+
+h2. Examples
+
+Basically, you write your SQL in Ruby.  No, not in Ruby.  As Ruby.
+
+<ruby>
+User.select { |u| u.city == 'San Francisco' }.each do |user|
+  puts user.name
+end
+</ruby>
+
+And that's it.
+
+The key is that queries aren't actually run until the data they represent is 
+requested. Usually this is done with what I call a kicker method. You can call them 
+that, too.
+
+Kicker methods are guys like @detect@, @each@, @each_with_index@, @map@, @entries@, 
+@to_a@, and @first@ (with no argument). Methods like @select@, @sort_by@, and @first@ 
+(with an argument) are not kicker methods and return a @Context@ object without running any SQL.
+
+Our @Context@ object has two useful methods: @to_s@ and @to_hash@.  With these,
+we can check out what exactly we're building.  Not everyone has @to_s@,
+though.  Mostly ignore these methods and treat everything like you normally
+would.
+
+See, @to_s@:
+
+<ruby>
+>> User.select { |m| m.name == 'jon' }.to_s
+=> "SELECT * FROM users WHERE users.name = 'jon'"
+</ruby>
+
+See, @to_hash@:
+
+<ruby>
+>> User.select { |m| m.name == 'jon' }.to_hash
+=> { :conditions => "users.name = 'jon'" }
+</ruby>
+
+h2. Equality - select { |u| u.field == 'bob' }
+
+<ruby>
+User.select { |m| m.name == 'jon' }
+"SELECT * FROM users WHERE users.name = 'jon'"
+
+User.select { |m| m.created_at > 2.days.ago }
+"SELECT * FROM users WHERE users.created_at > '2007-09-26 20:37:47'"
+
+User.select { |m| m.name == 'jon' }
+"SELECT * FROM users WHERE users.name = 'jon'"
+
+User.select { |m| m.name != 'jon' }
+"SELECT * FROM users WHERE users.name <> 'jon'"
+
+User.select { |m| m.name == 'jon' && m.age == 21 }
+"SELECT * FROM users WHERE (users.name = 'jon' AND users.age = 21)"
+
+User.select { |m| m.name == 'jon' || m.age == 21 }
+"SELECT * FROM users WHERE (users.name = 'jon' OR users.age = 21)"
+  
+User.select { |m| m.name == 'jon' || m.age == 21 && m.password == 'pass' }
+"SELECT * FROM users WHERE 
+ (users.name = 'jon' OR (users.age = 21 AND users.password = 'pass'))"
+
+User.select { |m| (m.name == 'jon' || m.name == 'rick') && m.age == 21 }
+"SELECT * FROM users WHERE 
+ ((users.name = 'jon' OR users.name = 'rick') AND users.age = 21)"
+</ruby>
+  
+h2. Associations - select { |u| u.field == 'bob' && u.association.field == 'bob@bob.com' }
+
+The @to_s@ method doesn't work on associations yet, but that's okay: they can 
+still query through ActiveRecord just fine.
+
+<ruby>
+User.select do |u| 
+  u.email == 'chris@ozmm.org' && u.profile.name == 'chris wanstrath' 
+end.map(&:title)
+
+"SELECT users.id AS t0_r0, ... FROM users 
+ LEFT OUTER JOIN profiles ON profiles.user_id = users.id 
+ WHERE ((users.email = 'chris@ozmm.org' AND profiles.name = 'chris wanstrath'))"
+</ruby>
+
+h2. Comparisons - select { |u| u.age > 21 }
+
+<ruby>
+User.select { |m| m.age > 21 }
+"SELECT * FROM users WHERE users.age > 21"
+
+User.select { |m| m.age < 21 }.to_s
+"SELECT * FROM users WHERE users.age < 21"
+
+User.select { |m| [1, 2, 3, 4].include? m.id }
+"SELECT * FROM users WHERE users.id IN (1, 2, 3, 4)"
+</ruby>
+
+h2. LIKE and REGEXP (RLIKE) - select { |m| m.name =~ 'chris' }
+
+<ruby>
+User.select { |m| m.name =~ 'chris' }
+"SELECT * FROM users WHERE users.name LIKE 'chris'"
+
+User.select { |m| m.name =~ 'chri%' }
+"SELECT * FROM users WHERE users.name LIKE 'chri%'"
+
+User.select { |m| m.name !~ 'chris' }
+"SELECT * FROM users WHERE users.name NOT LIKE 'chris'"
+
+User.select { |m| !(m.name =~ 'chris') }
+"SELECT * FROM users WHERE users.name NOT LIKE 'chris'"
+
+User.select { |m| m.name =~ /chris/ }
+"SELECT * FROM users WHERE users.name REGEXP 'chris'"
+</ruby>
+
+h2. #detect
+
+<ruby>
+User.detect { |m| m.name == 'chris' }
+"SELECT * FROM users WHERE users.name = 'chris' LIMIT 1"
+</ruby>
+
+h2. LIMITs - first, first(x), [offset, limit], [range], slice
+
+<ruby>
+User.select { |m| m.name == 'jon' }.first
+"SELECT * FROM users WHERE users.name = 'jon' LIMIT 1"
+
+User.select { |m| m.name == 'jon' }.first(5)
+"SELECT * FROM users WHERE users.name = 'jon' LIMIT 5"
+
+User.select { |m| m.name == 'jon' }[10, 20]
+"SELECT * FROM users WHERE users.name = 'jon' LIMIT 10, 20"
+
+User.select { |m| m.name == 'jon' }[10..20]
+"SELECT * FROM users WHERE users.name = 'jon' LIMIT 10, 10"
+</ruby>
+
+h2. ORDER - sort_by { |u| u.field }
+
+<ruby>
+User.select { |m| m.name == 'jon' }.sort_by { |m| m.name }
+"SELECT * FROM users WHERE users.name = 'jon' ORDER BY users.name"
+
+User.select { |m| m.name == 'jon' }.sort_by { |m| [ m.name,  m.age ] }
+"SELECT * FROM users WHERE users.name = 'jon' ORDER BY users.name, users.age"
+
+User.select { |m| m.name == 'jon' }.sort_by { |m| [ m.name,  -m.age ] }
+"SELECT * FROM users WHERE users.name = 'jon' 
+ ORDER BY users.name, users.age DESC"
+
+User.select { |m| m.name == 'jon' }.sort_by { |m| [ -m.name,  -m.age ] }
+"SELECT * FROM users WHERE users.name = 'jon' 
+ ORDER BY users.name DESC, users.age DESC"
+
+User.select { |m| m.name == 'jon' }.sort_by { |m| -m.age }
+"SELECT * FROM users WHERE users.name = 'jon' ORDER BY users.age DESC"
+
+User.select { |m| m.name == 'jon' }.sort_by { |m| -m.profiles.title }
+"SELECT users.id AS t0_r0, ... FROM users 
+ LEFT OUTER JOIN profiles ON profiles.user_id = users.id 
+ WHERE (users.name = 'jon') ORDER BY profiles.title DESC"
+
+User.select { |m| m.name == 'jon' }.sort_by { rand }
+"SELECT * FROM users WHERE users.name = 'jon' ORDER BY RAND()"
+</ruby>
+
+h2. COUNT - select { |u| u.name == 'jon' }.size
+
+<ruby>
+User.select { |m| m.name == 'jon' }.size
+"SELECT count(*) AS count_all FROM users WHERE (users.name = 'jon')"
+
+>> User.select { |m| m.name == 'jon' }.size
+=> 21
+</ruby>
+
+h2. Other Enumerables
+
+These methods perform COUNT() operations rather than loading your array into memory.  They're all 
+kickers.
+  
+<ruby>  
+User.any? { |m| m.name == 'jon' }
+User.all? { |m| m.name == 'jon' }
+User.select { |m| m.name == 'jon' }.empty?
+</ruby>
+
+h2. More Sugar
+
+The @downcase@ and @upcase@ methods will map to LOWER() and UPPER(), respectively.
+
+<ruby>
+>> User.select { |m| m.name.downcase =~ 'jon%' }.to_s
+=> "SELECT * FROM users WHERE LOWER(users.name) LIKE 'jon%'"
+</ruby>
+
+h2. Quoting
+
+Columns and values will be quoted using ActiveRecord's quote_column_name and quote methods, if
+possible.
+
+h2. SELECT * FROM bugs 
+
+Found a bug?  Sweet.  Add it at "the Lighthouse":http://err.lighthouseapp.com/projects/466-plugins/tickets/new.
+
+More information on Ambition:
+
+  * "http://ambition.rubyforge.org":http://ambition.rubyforge.org
+  * "http://groups.google.com/group/ambition-rb/":http://groups.google.com/group/ambition-rb/
+
+- Chris Wanstrath [ chris@ozmm.org ]

data/Rakefile

@@ -0,0 +1,13 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "benhoskings-ambitious-activerecord"
+    gemspec.summary = "An ambitious adapter for ActiveRecord"
+    gemspec.email = "chris@ozmm.org"
+    gemspec.homepage = "http://errtheblog.com/"
+    gemspec.authors = ['Chris Wanstrath', 'Ben Hoskings']
+    gemspec.add_dependency 'activerecord', '>=1.15.6'
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/ambitious-activerecord.gemspec

@@ -4,13 +4,13 @@
 
 Gem::Specification.new do |s|
   s.name = %q{ambitious-activerecord}
-  s.version = "0.1.3.7"
+  s.version = "0.1.3.8"
 
   s.specification_version = 2 if s.respond_to? :specification_version=
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Chris Wanstrath", "Ben Hoskings"]
-  s.date = %q{2009-05-04}
+  s.date = %q{2009-10-04}
   s.description = %q{An ambitious adapter for ActiveRecord}
   s.email = %q{chris@ozmm.org, ben@hoskings.net}
   s.extra_rdoc_files = ["lib/ambition/adapters/active_record/base.rb", "lib/ambition/adapters/active_record/query.rb", "lib/ambition/adapters/active_record/select.rb", "lib/ambition/adapters/active_record/slice.rb", "lib/ambition/adapters/active_record/sort.rb", "lib/ambition/adapters/active_record/statements.rb", "lib/ambition/adapters/active_record.rb"]

data/lib/ambition/adapters/active_record/base.rb

@@ -12,9 +12,9 @@ module Ambition
           end
 
           case value
-          when true,  'true'  
+          when true
             '1'
-          when false, 'false' 
+          when false
             '0'
           when Regexp
             "'#{value.source}'"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: benhoskings-ambitious-activerecord
 version: !ruby/object:Gem::Version 
-  version: 0.1.3.7
+  version: 0.1.3.8
 platform: ruby
 authors: 
 - Chris Wanstrath
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-05-04 00:00:00 -07:00
+date: 2009-10-22 00:00:00 +10:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -23,39 +23,30 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.15.6
     version: 
-- !ruby/object:Gem::Dependency 
-  name: benhoskings-ambition
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: 0.5.4.3
-    version: 
-description: An ambitious adapter for ActiveRecord
-email: chris@ozmm.org, ben@hoskings.net
+description: 
+email: chris@ozmm.org
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- lib/ambition/adapters/active_record/base.rb
-- lib/ambition/adapters/active_record/query.rb
-- lib/ambition/adapters/active_record/select.rb
-- lib/ambition/adapters/active_record/slice.rb
-- lib/ambition/adapters/active_record/sort.rb
-- lib/ambition/adapters/active_record/statements.rb
-- lib/ambition/adapters/active_record.rb
+- LICENSE
+- README
 files: 
+- .gitignore
+- LICENSE
+- Manifest
+- README
+- Rakefile
+- ambitious-activerecord.gemspec
+- lib/ambition/adapters/active_record.rb
 - lib/ambition/adapters/active_record/base.rb
+- lib/ambition/adapters/active_record/context.rb
 - lib/ambition/adapters/active_record/query.rb
 - lib/ambition/adapters/active_record/select.rb
 - lib/ambition/adapters/active_record/slice.rb
 - lib/ambition/adapters/active_record/sort.rb
 - lib/ambition/adapters/active_record/statements.rb
-- lib/ambition/adapters/active_record/context.rb
-- lib/ambition/adapters/active_record.rb
 - test/benchmark.rb
 - test/chaining_test.rb
 - test/count_test.rb
@@ -69,18 +60,13 @@ files:
 - test/sort_test.rb
 - test/source_test.rb
 - test/types_test.rb
-- Manifest
-- ambitious-activerecord.gemspec
 has_rdoc: true
-homepage: http://ambition.rubyforge.org/
+homepage: http://errtheblog.com/
+licenses: []
+
 post_install_message: 
 rdoc_options: 
-- --line-numbers
-- --inline-source
-- --title
-- Ambitious-activerecord
-- --main
-- README
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -97,16 +83,19 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: ambition
-rubygems_version: 1.2.0
+rubyforge_project: 
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: An ambitious adapter for ActiveRecord
 test_files: 
+- test/benchmark.rb
 - test/chaining_test.rb
 - test/count_test.rb
 - test/enumerable_test.rb
+- test/helper.rb
 - test/join_test.rb
+- test/profiler.rb
 - test/ruby_test.rb
 - test/select_test.rb
 - test/slice_test.rb