ambition 0.3.1 → 0.5.0

data/Manifest

@@ -1,48 +1,41 @@
-./init.rb
-./lib/ambition/api.rb
-./lib/ambition/database_statements.rb
-./lib/ambition/proc_to_ruby.rb
-./lib/ambition/processor.rb
-./lib/ambition/query.rb
-./lib/ambition/ruby_processor.rb
-./lib/ambition/select_processor.rb
-./lib/ambition/simple_processor.rb
-./lib/ambition/sort_processor.rb
-./lib/ambition/source.rb
-./lib/ambition.rb
-./LICENSE
-./Manifest
-./Rakefile
-./README
-./test/benchmark.rb
-./test/chaining_test.rb
-./test/console
-./test/count_test.rb
-./test/databases/boot.rb
-./test/databases/database.yml
-./test/databases/fixtures/admin.rb
-./test/databases/fixtures/companies.yml
-./test/databases/fixtures/company.rb
-./test/databases/fixtures/developer.rb
-./test/databases/fixtures/developers_projects.yml
-./test/databases/fixtures/project.rb
-./test/databases/fixtures/projects.yml
-./test/databases/fixtures/replies.yml
-./test/databases/fixtures/reply.rb
-./test/databases/fixtures/topic.rb
-./test/databases/fixtures/topics.yml
-./test/databases/fixtures/user.rb
-./test/databases/fixtures/users.yml
-./test/databases/lib/activerecord_test_connector.rb
-./test/databases/lib/load_fixtures.rb
-./test/databases/lib/schema.rb
-./test/enumerable_test.rb
-./test/helper.rb
-./test/join_test.rb
-./test/limit_test.rb
-./test/order_test.rb
-./test/profiler.rb
-./test/source_test.rb
-./test/ruby_test.rb
-./test/types_test.rb
-./test/where_test.rb
+app_generators/ambition_adapter/ambition_adapter_generator.rb
+app_generators/ambition_adapter/templates/lib/base.rb.erb
+app_generators/ambition_adapter/templates/lib/init.rb.erb
+app_generators/ambition_adapter/templates/lib/query.rb.erb
+app_generators/ambition_adapter/templates/lib/select.rb.erb
+app_generators/ambition_adapter/templates/lib/slice.rb.erb
+app_generators/ambition_adapter/templates/lib/sort.rb.erb
+app_generators/ambition_adapter/templates/LICENSE
+app_generators/ambition_adapter/templates/Rakefile
+app_generators/ambition_adapter/templates/README
+app_generators/ambition_adapter/templates/test/helper.rb.erb
+app_generators/ambition_adapter/templates/test/select_test.rb.erb
+app_generators/ambition_adapter/templates/test/slice_test.rb.erb
+app_generators/ambition_adapter/templates/test/sort_test.rb.erb
+app_generators/ambition_adapter/USAGE
+bin/ambition_adapter
+lib/ambition/api.rb
+lib/ambition/context.rb
+lib/ambition/core_ext.rb
+lib/ambition/enumerable.rb
+lib/ambition/processors/base.rb
+lib/ambition/processors/ruby.rb
+lib/ambition/processors/select.rb
+lib/ambition/processors/slice.rb
+lib/ambition/processors/sort.rb
+lib/ambition.rb
+LICENSE
+Manifest
+README
+test/adapters/exemplar/association_test.rb
+test/adapters/exemplar/count_test.rb
+test/adapters/exemplar/detect_test.rb
+test/adapters/exemplar/enumerable_test.rb
+test/adapters/exemplar/helper.rb
+test/adapters/exemplar/index_operator.rb
+test/adapters/exemplar/reject_test.rb
+test/adapters/exemplar/select_test.rb
+test/adapters/exemplar/slice_test.rb
+test/adapters/exemplar/sort_test.rb
+test/debug
+test/helper.rb

data/README

@@ -1,207 +1,10 @@
-== Ambitious SQL
+Ambition
+========
 
-A simple experiment and even simpler query library.
+http://github.com/defunkt/ambition
 
-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. 
+$ git clone git://github.com/defunkt/ambition.git
 
-The goal is this: write once, run with ActiveRecord, Sequel, DataMapper,
-whatever. Kind of like Rack for databases.
 
-== Git It (with Git, even)
-
-  $ sudo gem install ambition -y
-
-This will suck in Ambition and its dependencies (ParseTree & ActiveRecord). 
-It's fully usable outside of Rails (I use it in a Camping app or two), as long
-as you're riding ActiveRecord.
-
-To use with Rails, after installing the gem:
-  
-  $ cd vendor/plugins
-  $ gem unpack ambition
-
-RDoc exists: http://rock.errtheblog.com/ambition
-
-Have at the Git repo: 
-
-  $ git clone git://errtheblog.com/git/ambition
-
-== Examples
-
-Basically, you write your SQL in Ruby.  No, not in Ruby.  As Ruby.
-
-  User.select { |u| u.city == 'San Francisco' }.each do |user|
-    puts user.name
-  end
-
-And that's it.
-
-The key is that queries arent 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 +Query+ object without running any SQL.
-
-Our +Query+ object has two useful methods: +to_sql+ and +to_hash+.  With these,
-we can check out what exactly we're building.  Not everyone has +to_sql+,
-though.  Mostly ignore these methods and treat everything like you normally
-would.
-
-See, +to_sql+:
-  >> User.select { |m| m.name == 'jon' }.to_sql
-  => "SELECT * FROM users WHERE users.name = 'jon'"
-
-See, +to_hash+:
-  >> User.select { |m| m.name == 'jon' }.to_hash
-  => {:conditions=>"users.name = 'jon'"} 
-
-== Equality -- select { |u| u.field == 'bob' }
-
-  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)"
-
-== Associations -- select { |u| u.field == 'bob' && u.association.field == 'bob@bob.com' }
-
-The +to_sql+ method doesn't work on associations yet, but that's okay: they can 
-still query through ActiveRecord just fine.
-
-  User.select { |u| u.email == 'chris@ozmm.org' && u.profile.name == 'chris wanstrath' }.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')) 
-
-== Comparisons -- select { |u| u.age > 21 }
-
-  User.select { |m| m.age > 21 }
-  "SELECT * FROM users WHERE users.age > 21"
-
-  User.select { |m| m.age < 21 }.to_sql
-  "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)"
-
-== LIKE and REGEXP (RLIKE) -- select { |m| m.name =~ 'chris' }
-
-  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'"
-
-== #detect
-
-  User.detect { |m| m.name == 'chris' }
-  "SELECT * FROM users WHERE users.name = 'chris' LIMIT 1"
-
-== LIMITs -- first, first(x), [offset, limit], [range], slice
-
-  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"
-
-== ORDER -- sort_by { |u| u.field }
-
-  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()"
-
-== COUNT -- select { |u| u.name == 'jon' }.size
-
-  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
-
-== Other Enumerables
-
-These methods perform COUNT() operations rather than loading your array into memory.  They're all 
-kickers.
-  
-  User.any? { |m| m.name == 'jon' }
-  User.all? { |m| m.name == 'jon' }
-  User.select { |m| m.name == 'jon' }.empty?
-
-== More Sugar
-
-The +downcase+ and +upcase+ methods will map to LOWER() and UPPER(), respectively.
-
-  >> User.select { |m| m.name.downcase =~ 'jon%' }.to_sql
-  => "SELECT * FROM users WHERE LOWER(users.name) LIKE 'jon%'"
-
-== Quoting
-
-Columns and values will be quoted using ActiveRecord's quote_column_name and quote methods, if
-possible.
-
-== SELECT * FROM bugs 
-
-Found a bug?  Sweet.  Add it at the Lighthouse: 
-  http://err.lighthouseapp.com/projects/466-plugins/tickets/new
-
-Feature requests are welcome. 
-
-And hey, join our mailing list!
-
-  http://groups.google.com/group/ambition-rb
-
-* Chris Wanstrath [ chris@ozmm.org ]
+Chris Wanstrath
+chris@ozmm.org

data/ambition.gemspec

@@ -0,0 +1,111 @@
+
+# Gem::Specification for Ambition-0.5.0
+# Originally generated by Echoe
+
+Gem::Specification.new do |s|
+  s.name = %q{ambition}
+  s.version = "0.5.0"
+  s.date = %q{2008-01-29}
+  s.summary = %q{Ambition builds yer API calls from plain jane Ruby.}
+  s.email = %q{chris@ozmm.org}
+  s.homepage = %q{http://errtheblog.com/}
+  s.rubyforge_project = %q{err}
+  s.description = %q{Ambition builds yer API calls from plain jane Ruby.}
+  s.default_executable = %q{ambition_adapter}
+  s.has_rdoc = true
+  s.required_ruby_version = Gem::Version::Requirement.new(">= 1.8.6")
+  s.authors = ["Chris Wanstrath"]
+  s.files = ["app_generators/ambition_adapter/ambition_adapter_generator.rb", "app_generators/ambition_adapter/templates/lib/base.rb.erb", "app_generators/ambition_adapter/templates/lib/init.rb.erb", "app_generators/ambition_adapter/templates/lib/query.rb.erb", "app_generators/ambition_adapter/templates/lib/select.rb.erb", "app_generators/ambition_adapter/templates/lib/slice.rb.erb", "app_generators/ambition_adapter/templates/lib/sort.rb.erb", "app_generators/ambition_adapter/templates/LICENSE", "app_generators/ambition_adapter/templates/Rakefile", "app_generators/ambition_adapter/templates/README", "app_generators/ambition_adapter/templates/test/helper.rb.erb", "app_generators/ambition_adapter/templates/test/select_test.rb.erb", "app_generators/ambition_adapter/templates/test/slice_test.rb.erb", "app_generators/ambition_adapter/templates/test/sort_test.rb.erb", "app_generators/ambition_adapter/USAGE", "bin/ambition_adapter", "lib/ambition/api.rb", "lib/ambition/context.rb", "lib/ambition/core_ext.rb", "lib/ambition/enumerable.rb", "lib/ambition/processors/base.rb", "lib/ambition/processors/ruby.rb", "lib/ambition/processors/select.rb", "lib/ambition/processors/slice.rb", "lib/ambition/processors/sort.rb", "lib/ambition.rb", "LICENSE", "Manifest", "README", "test/adapters/exemplar/association_test.rb", "test/adapters/exemplar/count_test.rb", "test/adapters/exemplar/detect_test.rb", "test/adapters/exemplar/enumerable_test.rb", "test/adapters/exemplar/helper.rb", "test/adapters/exemplar/index_operator.rb", "test/adapters/exemplar/reject_test.rb", "test/adapters/exemplar/select_test.rb", "test/adapters/exemplar/slice_test.rb", "test/adapters/exemplar/sort_test.rb", "test/debug", "test/helper.rb", "ambition.gemspec"]
+  s.executables = ["ambition_adapter"]
+  s.add_dependency(%q<ParseTree>, ["= 2.0.1"])
+  s.add_dependency(%q<ruby2ruby>, ["= 1.1.7"])
+  s.add_dependency(%q<rubigen>, ["= 1.1.1"])
+end
+
+
+# # Original Rakefile source (requires the Echoe gem):
+# 
+# require 'rake'
+# require 'rake/testtask'
+# require 'rake/rdoctask'
+# 
+# Version = '0.5.0'
+# 
+# module Rake::TaskManager
+#   def delete_task(task_class, *args, &block)
+#     task_name, deps = resolve_args(args)
+#     @tasks.delete(task_class.scope_name(@scope, task_name).to_s)
+#   end
+# end
+# class Rake::Task
+#   def self.delete_task(args, &block) Rake.application.delete_task(self, args, &block) end
+# end
+# def delete_task(args, &block) Rake::Task.delete_task(args, &block) end
+# 
+# begin
+#   require 'rubygems'
+#   gem 'echoe', '>=2.7'
+#   ENV['RUBY_FLAGS'] = ""
+#   require 'echoe'
+# 
+#   Echoe.new('ambition', Version) do |p|
+#     p.project        = 'err'
+#     p.summary        = "Ambition builds yer API calls from plain jane Ruby."
+#     p.description    = "Ambition builds yer API calls from plain jane Ruby."
+#     p.url            = "http://errtheblog.com/"
+#     p.author         = 'Chris Wanstrath'
+#     p.email          = "chris@ozmm.org"
+#     p.ruby_version   = '>= 1.8.6'
+#     p.ignore_pattern = /^(\.git|site|adapters).+/
+#     p.test_pattern   = 'test/*_test.rb'
+#     p.dependencies  << 'ParseTree =2.0.1'
+#     p.dependencies  << 'ruby2ruby =1.1.7'
+#     p.dependencies  << 'rubigen =1.1.1'
+#   end
+# 
+# rescue LoadError 
+#   puts "Not doing any of the Echoe gemmy stuff, because you don't have the specified gem versions"
+# end
+# 
+# delete_task :test
+# delete_task :install_gem
+# 
+# Rake::TestTask.new('test') do |t|
+#   t.pattern = 'test/*_test.rb'
+# end
+# 
+# Rake::TestTask.new('test:adapters') do |t|
+#   t.pattern = 'adapters/*/test/*_test.rb'
+# end
+# 
+# Dir['adapters/*'].each do |adapter|
+#   adapter = adapter.split('/').last
+#   Rake::TestTask.new("test:adapters:#{adapter.sub('ambitious_','')}") do |t|
+#     t.pattern = "adapters/#{adapter}/test/*_test.rb"
+#   end
+# end
+# 
+# desc 'Default: run unit tests.'
+# task :default => :test
+# 
+# desc 'Generate RDoc documentation'
+# Rake::RDocTask.new(:rdoc) do |rdoc|
+#   files = ['README', 'LICENSE', 'lib/**/*.rb']
+#   rdoc.rdoc_files.add(files)
+#   rdoc.main     = "README" 
+#   rdoc.title    = "ambition"
+#   rdoc.template = File.exists?(t="/Users/chris/ruby/projects/err/rock/template.rb") ? t : "/var/www/rock/template.rb"
+#   rdoc.rdoc_dir = 'doc' 
+#   rdoc.options << '--inline-source'
+# end
+# 
+# desc 'Generate coverage reports'
+# task :rcov do
+#   `rcov -e gems test/*_test.rb`
+#   puts 'Generated coverage reports.'
+# end
+# 
+# desc 'Install as a gem'
+# task :install_gem do
+#   puts `rake manifest package && gem install pkg/ambition-#{Version}.gem`
+# end

data/app_generators/ambition_adapter/USAGE

@@ -0,0 +1 @@
+o.

data/app_generators/ambition_adapter/ambition_adapter_generator.rb

@@ -0,0 +1,66 @@
+class AmbitionAdapterGenerator < RubiGen::Base
+#  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name'])
+#  default_options :author => nil
+
+  attr_reader :adapter_name, :adapter_module
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    base_name         = self.base_name.sub(/ambitious(-|_)/,'')
+    @adapter_name     = base_name
+    @adapter_module   = base_name.split('_').map { |part| part[0] = part[0...1].upcase; part }.join
+    extract_options
+  end
+
+  def manifest
+    record do |m|
+      # Ensure appropriate folder(s) exists
+      m.directory ''
+      dirs = %W(
+        lib/ambition/adapters/#{adapter_name}
+        test
+      )
+      dirs.each { |path| m.directory path }
+
+      ##
+      # Translator / Query stubs
+      adapter_path = "lib/ambition/adapters/#{adapter_name}"
+
+      %w( base query select slice sort ).each do |file|
+        m.template "lib/#{file}.rb.erb", "#{adapter_path}/#{file}.rb"
+      end
+
+      m.template 'lib/init.rb.erb', "#{adapter_path}.rb"
+
+      ##
+      # Test stubs
+      Dir[File.dirname(__FILE__) + '/templates/test/*.rb.erb'].each do |file|
+        file = File.basename(file, '.*')
+        m.template "test/#{file}.erb", "test/#{file}"
+      end
+
+      ##
+      # Normal files
+      files = %w( LICENSE README Rakefile )
+      files.each do |file|
+        m.template file, file
+      end
+    end
+  end
+
+protected
+  def banner
+    "Coming soon"
+  end
+
+  def add_options!(opts)
+    opts.separator ''
+    opts.separator 'Options:'
+    opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+    opts.separator ''
+  end
+  
+  def extract_options; end
+end