defunkt-ambition 0.5.3

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/Manifest

@@ -0,0 +1,42 @@
+app_generators/ambition_adapter/ambition_adapter_generator.rb
+app_generators/ambition_adapter/templates/lib/adapter/base.rb.erb
+app_generators/ambition_adapter/templates/lib/adapter/query.rb.erb
+app_generators/ambition_adapter/templates/lib/adapter/select.rb.erb
+app_generators/ambition_adapter/templates/lib/adapter/slice.rb.erb
+app_generators/ambition_adapter/templates/lib/adapter/sort.rb.erb
+app_generators/ambition_adapter/templates/lib/init.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/sexp_translator.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

@@ -0,0 +1,24 @@
+= Ambition
+
+
+== Get it
+
+
+
+$ git clone git://github.com/defunkt/ambition.git
+
+== Resources
+
+ * http://ambition.rubyforge.org/
+ * http://groups.google.com/group/ambition-rb/
+ * http://errtheblog.com/posts/63-full-of-ambition
+ * http://errtheblog.com/posts/82-adapting-ambitiously
+ * http://errtheblog.com/posts/86-sugary-adapters
+ * http://errtheblog.com/posts/64-even-more-ambitious
+
+
+
+== Author
+
+Chris Wanstrath
+chris@ozmm.org

data/ambition.gemspec

@@ -0,0 +1,120 @@
+
+# Gem::Specification for Ambition-0.5.3
+# Originally generated by Echoe
+
+Gem::Specification.new do |s|
+  s.name = %q{ambition}
+  s.version = "0.5.3"
+
+  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"]
+  s.date = %q{2008-04-26}
+  s.default_executable = %q{ambition_adapter}
+  s.description = %q{Ambition builds yer API calls from plain jane Ruby.}
+  s.email = %q{chris@ozmm.org}
+  s.executables = ["ambition_adapter"]
+  s.extra_rdoc_files = ["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/sexp_translator.rb", "lib/ambition.rb", "LICENSE", "README"]
+  s.files = ["app_generators/ambition_adapter/ambition_adapter_generator.rb", "app_generators/ambition_adapter/templates/lib/adapter/base.rb.erb", "app_generators/ambition_adapter/templates/lib/adapter/query.rb.erb", "app_generators/ambition_adapter/templates/lib/adapter/select.rb.erb", "app_generators/ambition_adapter/templates/lib/adapter/slice.rb.erb", "app_generators/ambition_adapter/templates/lib/adapter/sort.rb.erb", "app_generators/ambition_adapter/templates/lib/init.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/sexp_translator.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.has_rdoc = true
+  s.homepage = %q{http://errtheblog.com/}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Ambition", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.required_ruby_version = Gem::Requirement.new(">= 1.8.6")
+  s.rubyforge_project = %q{err}
+  s.rubygems_version = %q{1.0.1}
+  s.summary = %q{Ambition builds yer API calls from plain jane Ruby.}
+
+  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.3'
+# 
+# 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/adapter/#{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
+    "Usage: ambition_adapter adapter_name"
+  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

data/app_generators/ambition_adapter/templates/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2007 Your Name
+
+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/app_generators/ambition_adapter/templates/README

@@ -0,0 +1,6 @@
+<%= string = "An Ambitious #{adapter_module} Adapter" %>
+<%= '=' * string.size %>
+
+More information on Ambition:
+-> http://ambition.rubyforge.org
+-> http://groups.google.com/group/ambition-rb/

data/app_generators/ambition_adapter/templates/Rakefile

@@ -0,0 +1,31 @@
+require 'rake'
+
+Version = '0.1.0'
+
+begin
+  require 'rubygems'
+  gem 'echoe', '>=2.7'
+  ENV['RUBY_FLAGS'] = ""
+  require 'echoe'
+
+  Echoe.new('ambitious-<%= adapter_name %>') do |p|
+    p.dependencies  << '<%= adapter_name %> >=1.0'
+    p.summary        = "An ambitious adapter for <%= adapter_module %>"
+    p.author         = 'Your Name'
+    p.email          = "your@email.com"
+
+    p.project        = 'ambition'
+    p.url            = "http://ambition.rubyforge.org/"
+    p.test_pattern   = 'test/*_test.rb'
+    p.version        = Version
+    p.dependencies  << 'ambition >=0.5.0'
+  end
+
+rescue LoadError 
+  puts "Not doing any of the Echoe gemmy stuff, because you don't have the specified gem versions"
+end
+
+desc 'Install as a gem'
+task :install_gem do
+  puts `rake manifest package && gem install pkg/ambitious-<%= adapter_name %>-#{Version}.gem`
+end

data/app_generators/ambition_adapter/templates/lib/adapter/base.rb.erb

@@ -0,0 +1,12 @@
+module Ambition
+  module Adapters
+    module <%= adapter_module %>
+      class Base
+        ##
+        # Extract common functionality into this class.
+        # All your classes, by default, inherit from this
+        # one -- Query and the Translators.
+      end
+    end
+  end
+end

data/app_generators/ambition_adapter/templates/lib/adapter/query.rb.erb

@@ -0,0 +1,52 @@
+=begin
+
+These methods are king:
+
+  - owner
+  - clauses
+  - stash
+
++owner+ is the class from which the request was generated.
+
+User.select { |u| u.name == 'Pork' }
+# => owner == User
+
++clauses+ is the hash of translated arrays, keyed by processors
+
+User.select { |u| u.name == 'Pork' }
+# => clauses ==  { :select => [ "users.name = 'Pork'" ] }
+
++stash+ is your personal private stash.  A hash you can use for
+keeping stuff around.
+
+User.select { |u| u.profile.name == 'Pork' }
+# => stash == { :include => [ :profile ] }
+
+The above is totally arbitrary.  It's basically a way for your
+translators to talk to each other and, more importantly, to the Query
+object.
+
+=end
+module Ambition
+  module Adapters
+    module <%= adapter_module %>
+      class Query < Base
+        def kick
+          raise "Example: owner.find(:all, to_hash)"
+        end
+
+        def size
+          raise "Example: owner.count(to_hash)"
+        end
+
+        def to_hash
+          raise "Not implemented"
+        end
+
+        def to_s
+          raise "Not implemented"
+        end
+      end
+    end
+  end
+end

data/app_generators/ambition_adapter/templates/lib/adapter/select.rb.erb

@@ -0,0 +1,100 @@
+##
+# The format of the documentation herein is:
+#
+# >> method with block
+# => methods on this class called by Ambition (with arguments)
+#
+module Ambition
+  module Adapters
+    module <%= adapter_module %>
+      class Select < Base
+        # >> select { |u| u.name == 'chris' } 
+        # => #call(:name)
+        def call(method)
+          raise "Not implemented."
+        end
+
+        # >> select { |u| u.name.downcase == 'chris' } 
+        # => #call(:name, :downcase)
+        def chained_call(*methods)
+          # An idiom here is to call the chained method and pass it
+          # the first method.
+          #
+          #   if respond_to? methods[1]
+          #     send(methods[1], methods[0])
+          #   end
+          #
+          # In the above example, this translates to calling:
+          #
+          #   #downcase(:name)
+          #
+          raise "Not implemented."
+        end
+
+        # &&
+        # >> select { |u| u.name == 'chris' && u.age == 22 }
+        # => #both( processed left side, processed right side )
+        def both(left, right)
+          raise "Not implemented."
+        end
+
+        # ||
+        # >> select { |u| u.name == 'chris' || u.age == 22 }
+        # => #either( processed left side, processed right side )
+        def either(left, right)
+          raise "Not implemented."
+        end
+
+        # >> select { |u| u.name == 'chris' }
+        # => #==( call(:name), 'chris' )
+        def ==(left, right)
+          raise "Not implemented."
+        end
+
+        # !=
+        # >> select { |u| u.name != 'chris' }
+        # => #not_equal( call(:name), 'chris' )
+        def not_equal(left, right)
+          raise "Not implemented."
+        end
+
+        # >> select { |u| u.name =~ 'chris' }
+        # => #=~( call(:name), 'chris' )
+        def =~(left, right)
+          raise "Not implemented."
+        end
+
+        # !~
+        # >> select { |u| u.name !~ 'chris' }
+        # => #not_regexp( call(:name), 'chris' )
+        def not_regexp(left, right)
+          raise "Not implemented."
+        end
+
+        ##
+        # Etc.
+        def <(left, right)
+          raise "Not implemented."
+        end
+
+        def >(left, right)
+          raise "Not implemented."
+        end
+
+        def >=(left, right)
+          raise "Not implemented."
+        end
+
+        def <=(left, right)
+          raise "Not implemented."
+        end
+
+        # >> select { |u| [1, 2, 3].include? u.id }
+        # => #include?( [1, 2, 3], call(:id) )
+        def include?(left, right)
+          raise "Not implemented."
+        end
+      end
+    end
+  end
+end

data/app_generators/ambition_adapter/templates/lib/adapter/slice.rb.erb

@@ -0,0 +1,19 @@
+module Ambition
+  module Adapters
+    module <%= adapter_module %>
+      class Slice < Base
+        # >> User.first(5)
+        # => #slice(0, 5)
+        #
+        # >> User.first
+        # => #slice(0, 1)
+        #
+        # >> User[10, 20]
+        # => #slice(10, 20)
+        def slice(start, length)
+          raise "Not implemented."
+        end
+      end
+    end
+  end
+end

data/app_generators/ambition_adapter/templates/lib/adapter/sort.rb.erb

@@ -0,0 +1,43 @@
+module Ambition
+  module Adapters
+    module <%= adapter_module %>
+      class Sort < Base
+        # >> sort_by { |u| u.age }
+        # => #sort_by(:age)
+        def sort_by(method)
+          raise "Not implemented."
+        end
+
+        # >> sort_by { |u| -u.age }
+        # => #reverse_sort_by(:age)
+        def reverse_sort_by(method)
+          raise "Not implemented."
+        end
+
+        # >> sort_by { |u| u.profile.name }
+        # => #chained_sort_by(:profile, :name)
+        def chained_sort_by(receiver, method)
+          raise "Not implemented."
+        end
+
+        # >> sort_by { |u| -u.profile.name }
+        # => #chained_reverse_sort_by(:profile, :name)
+        def chained_reverse_sort_by(receiver, method)
+          raise "Not implemented."
+        end
+
+        # >> sort_by(&:name)
+        # => #to_proc(:name)
+        def to_proc(symbol)
+          raise "Not implemented."
+        end
+
+        # >> sort_by { rand }
+        # => #rand
+        def rand
+          raise "Not implemented."
+        end
+      end
+    end
+  end
+end

data/app_generators/ambition_adapter/templates/lib/init.rb.erb

@@ -0,0 +1,22 @@
+require 'ambition'
+require '<%= adapter_name %>'
+require 'ambition/adapters/<%= adapter_name %>/base'
+require 'ambition/adapters/<%= adapter_name %>/query'
+require 'ambition/adapters/<%= adapter_name %>/select'
+require 'ambition/adapters/<%= adapter_name %>/sort'
+require 'ambition/adapters/<%= adapter_name %>/slice'
+
+##
+# This is where you inject Ambition into your target.
+#
+# Use `extend' if you are injecting a class, `include' if you are
+# injecting instances of that class.
+#
+# You must also set the `ambition_adapter' class variable on your target
+# class, regardless of whether you are injecting instances or the class itself.
+#
+# You probably want something like this:
+#
+#   <%= adapter_module %>::Base.extend Ambition::API
+#   <%= adapter_module %>::Base.ambition_adapter = Ambition::Adapters::<%= adapter_module %>
+#

data/app_generators/ambition_adapter/templates/test/helper.rb.erb

@@ -0,0 +1,9 @@
+%w( rubygems test/spec mocha English ).each { |f| require f }
+
+begin
+  require 'redgreen'
+rescue LoadError
+end
+
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+require 'ambition/adapters/<%= adapter_name %>'