square-arel 2.0.9.20110222133018

data/.autotest

@@ -0,0 +1,26 @@
+# -*- ruby -*-
+
+# require 'autotest/restart'
+
+ENV['GEM_PATH'] = "tmp/isolate/ruby-1.8"
+
+module Autotest::Restart
+  Autotest.add_hook :updated do |at, *args|
+    if args.flatten.include? ".autotest" then
+      warn "Detected change to .autotest, restarting"
+      cmd = %w(autotest)
+      cmd << " -v" if $v
+      cmd += ARGV
+
+      exec(*cmd)
+    end
+  end
+end
+
+Autotest.add_hook :initialize do |at|
+  at.add_exception 'tmp'
+  at.testlib = "minitest/autorun"
+
+  at.find_directories = ARGV unless ARGV.empty?
+end
+

data/History.txt

@@ -0,0 +1,105 @@
+== 2.0.9  / 2010/02/25
+
+* Bug Fixes
+
+  * Custom LOCK strings are allowed. Fixes LH # 6399
+    https://rails.lighthouseapp.com/projects/8994/tickets/6399-allow-database-specific-locking-clauses-to-be-used
+
+  * Strings passed to StringManager#on will be automatically tagged as SQL
+    literals. Fixes Rails LH #6384
+    https://rails.lighthouseapp.com/projects/8994/tickets/6384-activerecord-303-and-3-0-stable-generate-invalid-sql-for-has_many-through-association-with-conditions
+
+== 2.0.8  / 2010/02/08
+
+* Bug Fixes
+
+  * Added set operation support
+  * Fixed problems with *_any / *_all methods.
+
+== 2.0.7
+
+* Bug Fixes
+
+  * Limit members are visited
+  * Fixing MSSQL TOP support
+
+== 2.0.6 12/01/2010
+
+* Bug Fixes
+
+  * Rails 3.0.x does not like that Node is Enumerable, so removing for now.
+
+== 2.0.5 11/30/2010
+
+* Enhancements
+
+  * Arel::Visitors::DepthFirst can walk your AST depth first
+  * Arel::Nodes::Node is enumerable, depth first
+
+* Bug fixes
+
+  * #lock will lock SELECT statements "FOR UPDATE" on mysql
+  * Nodes::Node#not factory method added for creating Nodes::Not nodes
+  * Added an As node
+
+* Deprecations
+
+  * Support for Subclasses of core classes will be removed in ARel version
+    2.2.0
+
+== 2.0.4
+
+* Bug fixes
+
+  * Speed improvements for Range queries.  Thanks Rolf Timmermans!
+
+== 2.0.3
+
+* Bug fixes
+
+  * Fixing Oracle support
+  * Added a visitor for "Class" objects
+
+== 2.0.2
+
+* Bug fixes
+
+  * MySQL selects from DUAL on empty FROM
+  * Visitor translates nil to NULL
+  * Visitor translates Bignum properly
+
+== 2.0.1
+
+* Bug fixes
+
+== 2.0.0 / 2010-08-01
+* Enhancements
+  
+  * Recreate library using the Visitor pattern.
+    http://en.wikipedia.org/wiki/Visitor_pattern
+
+== 0.3.0 / 2010-03-10
+
+* Enhancements
+
+  * Introduced "SQL compilers" for query generation.
+  * Added support for Oracle (Raimonds Simanovskis) and IBM/DB (Praveen Devarao).
+  * Improvements to give better support to ActiveRecord.
+
+== 0.2.1 / 2010-02-05
+
+* Enhancements
+
+  * Bump dependency version of activesupport to 3.0.0.beta
+
+== 0.2.0 / 2010-01-31
+
+  * Ruby 1.9 compatibility
+  * Many improvements to support the Arel integration into ActiveRecord (see `git log v0.1.0..v0.2.0`)
+  * Thanks to Emilio Tagua and Pratik Naik for many significant contributions!
+
+== 0.1.0 / 2009-08-06
+
+* 1 major enhancement
+
+  * Birthday!

data/MIT-LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2007-2010 Nick Kallen, Bryan Helmkamp, Emilio Tagua, Aaron Patterson
+
+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.txt

@@ -0,0 +1,124 @@
+.autotest
+History.txt
+MIT-LICENSE.txt
+Manifest.txt
+README.markdown
+Rakefile
+arel.gemspec
+lib/arel.rb
+lib/arel/attributes.rb
+lib/arel/attributes/attribute.rb
+lib/arel/compatibility/wheres.rb
+lib/arel/crud.rb
+lib/arel/delete_manager.rb
+lib/arel/deprecated.rb
+lib/arel/expression.rb
+lib/arel/expressions.rb
+lib/arel/insert_manager.rb
+lib/arel/nodes.rb
+lib/arel/nodes/and.rb
+lib/arel/nodes/as.rb
+lib/arel/nodes/assignment.rb
+lib/arel/nodes/avg.rb
+lib/arel/nodes/between.rb
+lib/arel/nodes/binary.rb
+lib/arel/nodes/count.rb
+lib/arel/nodes/delete_statement.rb
+lib/arel/nodes/does_not_match.rb
+lib/arel/nodes/equality.rb
+lib/arel/nodes/except.rb
+lib/arel/nodes/exists.rb
+lib/arel/nodes/function.rb
+lib/arel/nodes/greater_than.rb
+lib/arel/nodes/greater_than_or_equal.rb
+lib/arel/nodes/group.rb
+lib/arel/nodes/grouping.rb
+lib/arel/nodes/having.rb
+lib/arel/nodes/in.rb
+lib/arel/nodes/inner_join.rb
+lib/arel/nodes/insert_statement.rb
+lib/arel/nodes/intersect.rb
+lib/arel/nodes/join.rb
+lib/arel/nodes/less_than.rb
+lib/arel/nodes/less_than_or_equal.rb
+lib/arel/nodes/limit.rb
+lib/arel/nodes/lock.rb
+lib/arel/nodes/matches.rb
+lib/arel/nodes/max.rb
+lib/arel/nodes/min.rb
+lib/arel/nodes/node.rb
+lib/arel/nodes/not.rb
+lib/arel/nodes/not_equal.rb
+lib/arel/nodes/not_in.rb
+lib/arel/nodes/offset.rb
+lib/arel/nodes/on.rb
+lib/arel/nodes/or.rb
+lib/arel/nodes/ordering.rb
+lib/arel/nodes/outer_join.rb
+lib/arel/nodes/select_core.rb
+lib/arel/nodes/select_statement.rb
+lib/arel/nodes/sql_literal.rb
+lib/arel/nodes/string_join.rb
+lib/arel/nodes/sum.rb
+lib/arel/nodes/table_alias.rb
+lib/arel/nodes/top.rb
+lib/arel/nodes/unary.rb
+lib/arel/nodes/union.rb
+lib/arel/nodes/union_all.rb
+lib/arel/nodes/unqualified_column.rb
+lib/arel/nodes/update_statement.rb
+lib/arel/nodes/values.rb
+lib/arel/predications.rb
+lib/arel/relation.rb
+lib/arel/select_manager.rb
+lib/arel/sql/engine.rb
+lib/arel/sql_literal.rb
+lib/arel/table.rb
+lib/arel/tree_manager.rb
+lib/arel/update_manager.rb
+lib/arel/visitors.rb
+lib/arel/visitors/depth_first.rb
+lib/arel/visitors/dot.rb
+lib/arel/visitors/join_sql.rb
+lib/arel/visitors/mssql.rb
+lib/arel/visitors/mysql.rb
+lib/arel/visitors/oracle.rb
+lib/arel/visitors/order_clauses.rb
+lib/arel/visitors/postgresql.rb
+lib/arel/visitors/sqlite.rb
+lib/arel/visitors/to_sql.rb
+lib/arel/visitors/visitor.rb
+lib/arel/visitors/where_sql.rb
+test/attributes/test_attribute.rb
+test/helper.rb
+test/nodes/test_as.rb
+test/nodes/test_count.rb
+test/nodes/test_delete_statement.rb
+test/nodes/test_equality.rb
+test/nodes/test_insert_statement.rb
+test/nodes/test_node.rb
+test/nodes/test_not.rb
+test/nodes/test_or.rb
+test/nodes/test_select_core.rb
+test/nodes/test_select_statement.rb
+test/nodes/test_sql_literal.rb
+test/nodes/test_sum.rb
+test/nodes/test_update_statement.rb
+test/support/fake_record.rb
+test/test_activerecord_compat.rb
+test/test_attributes.rb
+test/test_crud.rb
+test/test_delete_manager.rb
+test/test_insert_manager.rb
+test/test_select_manager.rb
+test/test_table.rb
+test/test_update_manager.rb
+test/visitors/test_depth_first.rb
+test/visitors/test_dot.rb
+test/visitors/test_join_sql.rb
+test/visitors/test_mssql.rb
+test/visitors/test_mysql.rb
+test/visitors/test_oracle.rb
+test/visitors/test_postgres.rb
+test/visitors/test_sqlite.rb
+test/visitors/test_to_sql.rb

data/README.markdown

@@ -0,0 +1,94 @@
+# ARel
+
+* http://github.com/rails/arel
+
+## DESCRIPTION
+
+Arel is a Relational Algebra for Ruby. It 1) simplifies the generation complex of SQL queries and it 2) adapts to various RDBMS systems. It is intended to be a framework framework; that is, you can build your own ORM with it, focusing on innovative object and collection modeling as opposed to database compatibility and query generation.
+
+## Status
+
+For the moment, Arel uses ActiveRecord's connection adapters to connect to the various engines, connection pooling, perform quoting, and do type conversion.
+
+## A Gentle Introduction
+
+Generating a query with ARel is simple. For example, in order to produce
+
+    SELECT * FROM users
+
+you construct a table relation and convert it to sql:
+
+    users = Arel::Table.new(:users)
+    users.project(Arel.sql('*'))
+    users.to_sql
+
+### More Sophisticated Queries
+
+Here is a whirlwind tour through the most common relational operators. These will probably cover 80% of all interaction with the database.
+
+First is the 'restriction' operator, `where`:
+
+    users.where(users[:name].eq('amy'))
+    # => SELECT * FROM users WHERE users.name = 'amy'
+
+What would, in SQL, be part of the `SELECT` clause is called in Arel a `projection`:
+
+    users.project(users[:id]) # => SELECT users.id FROM users
+
+Joins resemble SQL strongly:
+
+    users.join(photos).on(users[:id].eq(photos[:user_id]))
+    # => SELECT * FROM users INNER JOIN photos ON users.id = photos.user_id
+
+What are called `LIMIT` and `OFFSET` in SQL are called `take` and `skip` in Arel:
+
+    users.take(5) # => SELECT * FROM users LIMIT 5
+    users.skip(4) # => SELECT * FROM users OFFSET 4
+
+`GROUP BY` is called `group`:
+
+    users.group(users[:name]) # => SELECT * FROM users GROUP BY name
+
+The best property of the Relational Algebra is its "composability", or closure under all operations. For example, to restrict AND project, just "chain" the method invocations:
+
+    users                                 \
+      .where(users[:name].eq('amy'))      \
+      .project(users[:id])                \
+    # => SELECT users.id FROM users WHERE users.name = 'amy'
+
+All operators are chainable in this way, and they are chainable any number of times, in any order.
+
+    users.where(users[:name].eq('bob')).where(users[:age].lt(25))
+
+Of course, many of the operators take multiple arguments, so the last example can be written more tersely:
+
+    users.where(users[:name].eq('bob'), users[:age].lt(25))
+
+The `OR` operator works like this:
+
+    users.where(users[:name].eq('bob').or(users[:age].lt(25)))
+
+The `AND` operator behaves similarly.
+
+### The Crazy Features
+
+The examples above are fairly simple and other libraries match or come close to matching the expressiveness of Arel (e.g., `Sequel` in Ruby).
+
+#### Complex Joins
+
+Where Arel really shines in its ability to handle complex joins and aggregations. As a first example, let's consider an "adjacency list", a tree represented in a table. Suppose we have a table `comments`, representing a threaded discussion:
+
+    comments = Arel::Table.new(:comments)
+
+And this table has the following attributes:
+
+    comments.columns # => [comments[:id], comments[:body], comments[:parent_id]]
+
+The `parent_id` column is a foreign key from the `comments` table to itself. Now, joining a table to itself requires aliasing in SQL. In fact, you may alias in Arel as well:
+
+    replies = comments.alias
+    comments_with_replies = \
+      comments.join(replies).on(replies[:parent_id].eq(comments[:id]))
+    # => SELECT * FROM comments INNER JOIN comments AS comments_2 WHERE comments_2.parent_id = comments.id
+
+This will return the first comment's reply's body.

data/Rakefile

@@ -0,0 +1,20 @@
+require "rubygems"
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+
+Hoe.plugins.delete :rubyforge
+Hoe.plugin :minitest
+Hoe.plugin :gemspec # `gem install hoe-gemspec`
+Hoe.plugin :git     # `gem install hoe-git`
+
+Hoe.spec 'arel' do
+  developer('Aaron Patterson', 'aaron@tenderlovemaking.com')
+  developer('Bryan Halmkamp', 'bryan@brynary.com')
+  developer('Emilio Tagua', 'miloops@gmail.com')
+  developer('Nick Kallen', 'nick@example.org') # FIXME: need Nick's email
+
+  self.readme_file      = 'README.markdown'
+  self.extra_rdoc_files = FileList['README.markdown']
+  self.extra_dev_deps << [ 'hoe', '>= 2.1.0' ]
+  self.extra_dev_deps << [ 'minitest', '>= 1.6.0' ]
+end

data/lib/arel.rb

@@ -0,0 +1,39 @@
+require 'arel/crud'
+
+require 'arel/expressions'
+require 'arel/predications'
+require 'arel/table'
+require 'arel/attributes'
+require 'arel/compatibility/wheres'
+
+#### these are deprecated
+# The Arel::Relation constant is referenced in Rails
+require 'arel/relation'
+require 'arel/expression'
+####
+
+require 'arel/visitors'
+
+require 'arel/tree_manager'
+require 'arel/insert_manager'
+require 'arel/select_manager'
+require 'arel/update_manager'
+require 'arel/delete_manager'
+require 'arel/nodes'
+
+
+#### these are deprecated
+require 'arel/deprecated'
+require 'arel/sql/engine'
+require 'arel/sql_literal'
+####
+
+module Arel
+  VERSION = '2.0.9'
+
+  def self.sql raw_sql
+    Arel::Nodes::SqlLiteral.new raw_sql
+  end
+  ## Convenience Alias
+  Node = Arel::Nodes::Node
+end

data/lib/arel/attributes.rb

@@ -0,0 +1,20 @@
+require 'arel/attributes/attribute'
+
+module Arel
+  module Attributes
+    ###
+    # Factory method to wrap a raw database +column+ to an Arel Attribute.
+    def self.for column
+      case column.type
+      when :string, :text, :binary             then String
+      when :integer                            then Integer
+      when :float                              then Float
+      when :decimal                            then Decimal
+      when :date, :datetime, :timestamp, :time then Time
+      when :boolean                            then Boolean
+      else
+        Undefined
+      end
+    end
+  end
+end