click_house-client 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cccbd9106d3d83f03a0dba17c0e3c43fc58f93dfd5ed75baaa86cbdd1f3628b0
-  data.tar.gz: 876218b5e4601d897b0c83b607ec83a23c10e6d927347ac2ac03bf34309d7b55
+  metadata.gz: bef646c7c07c30559265378e9fec3f14f5e41aeadd86058120a31d532d77d10a
+  data.tar.gz: e969763ad335eda82d36f3d949207cfcb95ab238646ff0b3e4ec18e5a17bd445
 SHA512:
-  metadata.gz: 65bfaba824f239654390d509efcaf9dd03486fee4db020916c53cad306cd0abdf8d93fa1ea091da0a55123bef2512947f10df572d181f387eac8ee5d34b8488f
-  data.tar.gz: 428207f4a11fa7ec577e5316130d053f59c3d88544e3f0f77da8f33ab0f2f60efaa6646ca8cf523e20ef474a13acbdfc8b44f7dde19347c28a861c3816c16a27
+  metadata.gz: 9f7883a21fba0ab5534c85ca43686a3490234252c2277e200a244a3bead56fa3a31d7597c8b23deecb0086b5ad3a90dde67c8425f8ce257c289cb29abb8b29ad
+  data.tar.gz: 175aaeaefe0f02f0ba1cd9e3828d9d4bb876c450f626765b78568297c0d35d7e2eb7de00f900ea88db84f7240fbb32790fededbd258dcad4afb4d9291bb16f7c

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    click_house-client (0.9.0)
+    click_house-client (0.10.0)
       activerecord (>= 7.0, < 9.0)
       activesupport (>= 7.0, < 9.0)
       addressable (~> 2.8)
@@ -136,7 +136,7 @@ CHECKSUMS
   benchmark (0.4.1) sha256=d4ef40037bba27f03b28013e219b950b82bace296549ec15a78016552f8d2cce
   bigdecimal (3.2.2) sha256=39085f76b495eb39a79ce07af716f3a6829bc35eb44f2195e2753749f2fa5adc
   byebug (12.0.0) sha256=d4a150d291cca40b66ec9ca31f754e93fed8aa266a17335f71bb0afa7fca1a1e
-  click_house-client (0.9.0)
+  click_house-client (0.10.0)
   concurrent-ruby (1.3.5) sha256=813b3e37aca6df2a21a3b9f1d497f8cbab24a2b94cab325bffe65ee0f6cbebc6
   connection_pool (2.5.3) sha256=cfd74a82b9b094d1ce30c4f1a346da23ee19dc8a062a16a85f58eab1ced4305b
   diff-lcs (1.5.0) sha256=49b934001c8c6aedb37ba19daec5c634da27b318a7a3c654ae979d6ba1929b67

data/README.md

@@ -200,7 +200,10 @@ query.final.where(active: true).to_sql
 
 ### Working with JOINs
 
-When using JOINs, you can apply conditions to joined tables: _(Supports only `INNER JOIN`)_
+`#joins` supports `INNER JOIN` (default) and `LEFT OUTER JOIN` via
+`type: :outer`. The join source can be a table name, an `Arel::Table`, or a
+pre-aliased subquery (`QueryBuilder.new(sub, 'alias').table` or
+`sub.to_arel.as('alias')`).
 
 ```ruby
 # Join with conditions on joined table
@@ -217,6 +220,17 @@ query
   .having(orders: { total: [100, 200, 300] })
   .to_sql
 # => "SELECT * FROM `users` INNER JOIN `orders` ON `users`.`id` = `orders`.`user_id` GROUP BY `users`.`department` HAVING `orders`.`total` IN (100, 200, 300)"
+
+# LEFT OUTER JOIN against a pre-aliased subquery
+orders_sub = ClickHouse::Client::QueryBuilder.new(
+  ClickHouse::Client::QueryBuilder.new('orders').select(:id, :user_id),
+  'o'
+)
+
+query
+  .joins(orders_sub.table, { id: :user_id }, type: :outer)
+  .to_sql
+# => "SELECT * FROM `users` LEFT OUTER JOIN (SELECT `orders`.`id`, `orders`.`user_id` FROM `orders`) `o` ON `users`.`id` = `o`.`user_id`"
 ```
 
 ### Complete Example

data/lib/click_house/client/query_builder.rb

@@ -198,30 +198,40 @@ module ClickHouse
         end
       end
 
-      def joins(table_name, constraint = nil)
+      # Adds a JOIN clause. Pass `type: :outer` for `LEFT OUTER JOIN`.
+      # To join a subquery, pre-alias it via `QueryBuilder.new(sub, 'x').table`
+      # or `sub.to_arel.as('x')` and pass that.
+      # @return [ClickHouse::Client::QueryBuilder] New instance of query builder.
+      def joins(source, constraint = nil, type: :inner)
+        validate_join_type!(type)
+
         clone.tap do |new_instance|
-          join_table = table_name.is_a?(Arel::Table) ? table_name : Arel::Table.new(table_name)
+          join_target = case source
+                        when Arel::Table, Arel::Nodes::TableAlias then source
+                        else Arel::Table.new(source)
+                        end
+          join_class = type == :outer ? Arel::Nodes::OuterJoin : Arel::Nodes::InnerJoin
 
           join_condition = case constraint
                            when Hash
                              # Handle hash based constraints like { table1.id: table2.ref_id } or {id: :ref_id}
                              constraint_conditions = constraint.map do |left, right|
                                left_field = left.is_a?(Arel::Attributes::Attribute) ? left : new_instance.table[left]
-                               right_field = right.is_a?(Arel::Attributes::Attribute) ? right : join_table[right]
+                               right_field = right.is_a?(Arel::Attributes::Attribute) ? right : join_target[right]
                                left_field.eq(right_field)
                              end
 
                              constraint_conditions.reduce(&:and)
                            when Proc
-                             constraint.call(new_instance.table, join_table)
-                           when Arel::Nodes::Node
+                             constraint.call(new_instance.table, join_target)
+                           when Arel::Nodes::Node, Arel::Nodes::SqlLiteral
                              constraint
                            end
 
           if join_condition
-            new_instance.manager.join(join_table).on(join_condition)
+            new_instance.manager.join(join_target, join_class).on(join_condition)
           else
-            new_instance.manager.join(join_table)
+            new_instance.manager.join(join_target, join_class)
           end
         end
       end
@@ -448,6 +458,12 @@ module ClickHouse
 
         raise ArgumentError, "Invalid order direction '#{direction}'. Must be :asc or :desc"
       end
+
+      def validate_join_type!(type)
+        return if %i[inner outer].include?(type)
+
+        raise ArgumentError, "Invalid join type '#{type}'. Must be :inner or :outer"
+      end
     end
   end
 end

data/lib/click_house/client/version.rb

@@ -2,6 +2,6 @@
 
 module ClickHouse
   module Client
-    VERSION = "0.9.0"
+    VERSION = "0.10.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: click_house-client
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - group::optimize
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-28 00:00:00.000000000 Z
+date: 2026-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord