arel 7.1.4 → 9.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d1986f950d2ecce6990d5a420c7963c874bcf22b
-  data.tar.gz: e21fbc532cdf9feceed6883a9ed1a151c0c1ebb3
+  metadata.gz: dc3719172683caa3fb2bd15ce6ef3ed477a8b2ef
+  data.tar.gz: 74b4f1d7d44871db56c62907ed1c4ba51040bf6e
 SHA512:
-  metadata.gz: c0c67c17600ee4a7ce861bc688abf8d409d8b8c1c65969f26a9cfe8d7263eacd3c50f3e9548b80f1e071cd14e176e765addba6ec84de579c4797a123c960e2b1
-  data.tar.gz: a9f11f32f1868a9df3b27c88828513bf4106fcce946defc2d383488ab9fe9cb814408c51071ce6bbfe5aa8777d1a1fba7afd4fea89d4931282a2d7447343588e
+  metadata.gz: bedb8b1701ee99fca067c4a52f92d096648d25d67d4809408ede3eeb40298b3fc83a9fdccf1f4195c32f871ee430eba29f11dedd19b12032639a8b03bc7ec54c
+  data.tar.gz: 97a3b3155db8b0c57ca4616598d45d8aad7592c56a6882e0e7f5369eeac221802cae5cd60b4d72a92d755eb13be4b39aedc9ea967e1c6faac28953a3414d1f39

data/History.txt

@@ -1,29 +1,21 @@
-=== 7.1.4 / 2016-10-10
+=== 9.0.0 / 2017-11-14
 
-* bug fixes
-
-  * Remove deprecated usage inside arel.
-
-=== 7.1.3 / 2016-10-07
-
-* bug fixes
-
-  * Remove union mapping as :binary node when performing DepthFirst enumeration
-  * Fix invalid BindParam output in Dot visitor
-  * Add Arel::Nodes::Casted to dot visitor
-  * Use Arel::Nodes::BindParam in Oracle visitor for queries using both LIMIT and OFFSET
+* Enhancements
+  * `InsertManager#insert` is now chainable
+  * Support multiple inserts
 
-=== 7.1.2 / 2016-09-13
+=== 8.0.0 / 2017-02-21
 
-* bug fixes
+* Enhancements
 
-  * Don't store all aliases to a table
+  * Remove deprecated type casting support in Arel
+  * Frozen all string literals in Arel
 
 === 7.1.1 / 2016-07-27
 
-* bug fixes
+* Bug Fixes
 
-  * fix warning in `casted#hash`
+  * Fix warning in `Casted#hash`
 
 === 7.1.0 / 2016-07-19
 

data/README.md

@@ -1,6 +1,7 @@
 # Arel
 
 * http://github.com/rails/arel
+* [API Documentation](http://www.rubydoc.info/github/rails/arel)
 
 ## DESCRIPTION
 
@@ -97,7 +98,7 @@ users.where((users[:bitmap] >> 1).gt(0)).project(Arel.sql('*'))
 # => SELECT * FROM "users"  WHERE ("users"."bitmap" >> 1) > 0
 
 users.where((~ users[:bitmap]).gt(0)).project(Arel.sql('*'))
-# => SELECT FROM "users" WHERE  ~ "users"."bitmap" > 0
+# => SELECT * FROM "users" WHERE  ~ "users"."bitmap" > 0
 ```
 
 Joins resemble SQL strongly:
@@ -149,7 +150,14 @@ The `OR` operator works like this:
 users.where(users[:name].eq('bob').or(users[:age].lt(25)))
 ```
 
-The `AND` operator behaves similarly.
+The `AND` operator behaves similarly. Here is an example of the `DISTINCT` operator:
+
+```ruby
+posts = Arel::Table.new(:posts)
+posts.project(posts[:title])
+posts.distinct
+posts.to_sql # => 'SELECT DISTINCT "posts"."title" FROM "posts"'
+```
 
 Aggregate functions `AVG`, `SUM`, `COUNT`, `MIN`, `MAX`, `HAVING`:
 
@@ -180,7 +188,7 @@ users.project(users[:age].average.as("mean_age"))
 # => SELECT AVG(users.age) AS mean_age FROM users
 ```
 
-### The Crazy Features
+### The Advanced 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).
 
@@ -207,6 +215,7 @@ products.
 
 #### Complex Joins
 
+##### Alias
 Where Arel really shines is 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:
 
 ```ruby
@@ -232,6 +241,7 @@ comments_with_replies = \
 
 This will return the reply for the first comment.
 
+##### CTE
 [Common Table Expressions (CTE)](https://en.wikipedia.org/wiki/Common_table_expressions#Common_table_expression) support via:
 
 Create a `CTE`
@@ -254,6 +264,7 @@ users.
 #    FROM users INNER JOIN cte_table ON users.id = cte_table.user_id
 ```
 
+#### Write SQL strings
 When your query is too complex for `Arel`, you can use `Arel::SqlLiteral`:
 
 ```ruby

data/lib/arel/alias_predication.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module AliasPredication
     def as other

data/lib/arel/attributes/attribute.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Attributes
     class Attribute < Struct.new :relation, :name

data/lib/arel/attributes.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'arel/attributes/attribute'
 
 module Arel

data/lib/arel/collectors/bind.rb

@@ -1,35 +1,23 @@
+# frozen_string_literal: true
+
 module Arel
   module Collectors
     class Bind
       def initialize
-        @parts = []
+        @binds = []
       end
 
       def << str
-        @parts << str
         self
       end
 
       def add_bind bind
-        @parts << bind
+        @binds << bind
         self
       end
 
-      def value; @parts; end
-
-      def substitute_binds bvs
-        bvs = bvs.dup
-        @parts.map do |val|
-          if Arel::Nodes::BindParam === val
-            bvs.shift
-          else
-            val
-          end
-        end
-      end
-
-      def compile bvs
-        substitute_binds(bvs).join
+      def value
+        @binds
       end
     end
   end

data/lib/arel/collectors/composite.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Arel
+  module Collectors
+    class Composite
+      def initialize(left, right)
+        @left = left
+        @right = right
+      end
+
+      def << str
+        left << str
+        right << str
+        self
+      end
+
+      def add_bind bind, &block
+        left.add_bind bind, &block
+        right.add_bind bind, &block
+        self
+      end
+
+      def value
+        [left.value, right.value]
+      end
+
+      protected
+
+      attr_reader :left, :right
+    end
+  end
+end

data/lib/arel/collectors/plain_string.rb

@@ -1,8 +1,9 @@
+# frozen_string_literal: true
 module Arel
   module Collectors
     class PlainString
       def initialize
-        @str = ''
+        @str = ''.dup
       end
 
       def value

data/lib/arel/collectors/sql_string.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 require 'arel/collectors/plain_string'
 

data/lib/arel/collectors/substitute_binds.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+module Arel
+  module Collectors
+    class SubstituteBinds
+      def initialize(quoter, delegate_collector)
+        @quoter = quoter
+        @delegate = delegate_collector
+      end
+
+      def << str
+        delegate << str
+        self
+      end
+
+      def add_bind bind
+        self << quoter.quote(bind)
+      end
+
+      def value
+        delegate.value
+      end
+
+      protected
+
+      attr_reader :quoter, :delegate
+    end
+  end
+end

data/lib/arel/compatibility/wheres.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Compatibility # :nodoc:
     class Wheres # :nodoc:

data/lib/arel/crud.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   ###
   # FIXME hopefully we can remove this

data/lib/arel/delete_manager.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   class DeleteManager < Arel::TreeManager
     def initialize

data/lib/arel/errors.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+module Arel
+  class ArelError < StandardError
+  end
+
+  class EmptyJoinError < ArelError
+  end
+end

data/lib/arel/expressions.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Expressions
     def count distinct = false

data/lib/arel/factory_methods.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   ###
   # Methods for creating various nodes

data/lib/arel/insert_manager.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   class InsertManager < Arel::TreeManager
     def initialize
@@ -33,10 +34,15 @@ module Arel
         end
         @ast.values = create_values values, @ast.columns
       end
+      self
     end
 
     def create_values values, columns
       Nodes::Values.new values, columns
     end
+
+    def create_values_list(rows)
+      Nodes::ValuesList.new(rows)
+    end
   end
 end

data/lib/arel/math.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Math
     def *(other)

data/lib/arel/nodes/and.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class And < Arel::Nodes::Node

data/lib/arel/nodes/ascending.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Ascending < Ordering

data/lib/arel/nodes/binary.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Binary < Arel::Nodes::Node

data/lib/arel/nodes/bind_param.rb

@@ -1,8 +1,26 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class BindParam < Node
-      def ==(other)
-        other.is_a?(BindParam)
+      attr_accessor :value
+
+      def initialize(value)
+        @value = value
+        super()
+      end
+
+      def hash
+        [self.class, self.value].hash
+      end
+
+      def eql?(other)
+        other.is_a?(BindParam) &&
+          value == other.value
+      end
+      alias :== :eql?
+
+      def nil?
+        value.nil?
       end
     end
   end

data/lib/arel/nodes/case.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Case < Arel::Nodes::Node

data/lib/arel/nodes/casted.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Casted < Arel::Nodes::Node # :nodoc:
@@ -29,7 +30,7 @@ module Arel
 
     def self.build_quoted other, attribute = nil
       case other
-        when Arel::Nodes::Node, Arel::Attributes::Attribute, Arel::Table, Arel::Nodes::BindParam, Arel::SelectManager, Arel::Nodes::Quoted
+        when Arel::Nodes::Node, Arel::Attributes::Attribute, Arel::Table, Arel::Nodes::BindParam, Arel::SelectManager, Arel::Nodes::Quoted, Arel::Nodes::SqlLiteral
           other
         else
           case attribute

data/lib/arel/nodes/count.rb

@@ -1,6 +1,9 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Count < Arel::Nodes::Function
+      include Math
+
       def initialize expr, distinct = false, aliaz = nil
         super(expr, aliaz)
         @distinct = distinct

data/lib/arel/nodes/delete_statement.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class DeleteStatement < Arel::Nodes::Binary

data/lib/arel/nodes/descending.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Descending < Ordering

data/lib/arel/nodes/equality.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Equality < Arel::Nodes::Binary

data/lib/arel/nodes/extract.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Extract < Arel::Nodes::Unary

data/lib/arel/nodes/false.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class False < Arel::Nodes::Node
@@ -8,6 +9,7 @@ module Arel
       def eql? other
         self.class == other.class
       end
+      alias :== :eql?
     end
   end
 end

data/lib/arel/nodes/full_outer_join.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class FullOuterJoin < Arel::Nodes::Join

data/lib/arel/nodes/function.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Function < Arel::Nodes::Node
@@ -28,6 +29,8 @@ module Arel
           self.alias == other.alias &&
           self.distinct == other.distinct
       end
+      alias :== :eql?
+
     end
 
     %w{

data/lib/arel/nodes/grouping.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Grouping < Unary

data/lib/arel/nodes/in.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class In < Equality

data/lib/arel/nodes/infix_operation.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
 

data/lib/arel/nodes/inner_join.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class InnerJoin < Arel::Nodes::Join

data/lib/arel/nodes/insert_statement.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class InsertStatement < Arel::Nodes::Node

data/lib/arel/nodes/join_source.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     ###

data/lib/arel/nodes/matches.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Matches < Binary

data/lib/arel/nodes/named_function.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class NamedFunction < Arel::Nodes::Function

data/lib/arel/nodes/node.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'arel/collectors/sql_string'
 
 module Arel

data/lib/arel/nodes/outer_join.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class OuterJoin < Arel::Nodes::Join

data/lib/arel/nodes/over.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
 

data/lib/arel/nodes/regexp.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Regexp < Binary

data/lib/arel/nodes/right_outer_join.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class RightOuterJoin < Arel::Nodes::Join

data/lib/arel/nodes/select_core.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class SelectCore < Arel::Nodes::Node

data/lib/arel/nodes/select_statement.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class SelectStatement < Arel::Nodes::Node

data/lib/arel/nodes/sql_literal.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class SqlLiteral < String

data/lib/arel/nodes/string_join.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class StringJoin < Arel::Nodes::Join

data/lib/arel/nodes/table_alias.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class TableAlias < Arel::Nodes::Binary

data/lib/arel/nodes/terminal.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Distinct < Arel::Nodes::Node
@@ -8,6 +9,7 @@ module Arel
       def eql? other
         self.class == other.class
       end
+      alias :== :eql?
     end
   end
 end

data/lib/arel/nodes/true.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class True < Arel::Nodes::Node
@@ -8,6 +9,7 @@ module Arel
       def eql? other
         self.class == other.class
       end
+      alias :== :eql?
     end
   end
 end

data/lib/arel/nodes/unary.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Unary < Arel::Nodes::Node

data/lib/arel/nodes/unary_operation.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
 

data/lib/arel/nodes/unqualified_column.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class UnqualifiedColumn < Arel::Nodes::Unary

data/lib/arel/nodes/update_statement.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class UpdateStatement < Arel::Nodes::Node

data/lib/arel/nodes/values.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Arel
   module Nodes
     class Values < Arel::Nodes::Binary

data/lib/arel/nodes/values_list.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+module Arel
+  module Nodes
+    class ValuesList < Node
+      attr_reader :rows
+
+      def initialize(rows)
+        @rows = rows
+        super()
+      end
+
+      def hash
+        @rows.hash
+      end
+
+      def eql? other
+        self.class == other.class &&
+          self.rows == other.rows
+      end
+      alias :== :eql?
+    end
+  end
+end