yiffspace-arel 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 16066f1acde1ce2560d9957292423d90f5cfdc7a43acc694d59aaae0fa32fa68
+  data.tar.gz: b5437db5c64f23237b9724ef001775ed66f1ff125b78081c5fb3be9425318910
+SHA512:
+  metadata.gz: 80e0c8b8c9d8a949927261258344ce20109a76c6d266fddabdce1f12be7d0e3c9958c8cd975b1b1f0eeef72b2f8274ff5773a9236ac7651d4703a21e779744fd
+  data.tar.gz: 6ab2c75ed8af7f6931b1566e651c222ae7133d5770bf7a5c45c7a1fabfc57a62396c2ea112867f4e1caa34cc28ad816ed293ac0598c5c1504b11025eb24a3769

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## 0.0.1
+
+- Initial release, extracted from the `yiffspace` gem's
+  `YiffSpace::Extensions::ActiveRecord`/`YiffSpace::Extensions::Arel`
+  lateral-join/unnest extensions and their `core_ext` global aliases.

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright Donovan_DMC
+
+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/README.md

@@ -0,0 +1,38 @@
+# YiffSpace::Arel
+
+Postgres lateral-join/unnest ActiveRecord & Arel extensions
+(`cross_join_lateral`, `left_join_lateral`, `unnest`, `cross_unnest`,
+`left_unnest`), for https://yiff.space and related projects. No dependency
+on `yiffspace` itself - pure additive ActiveRecord/Arel monkeypatches.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "yiffspace-arel"
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+## Usage
+
+```ruby
+Post.joins_lateral_unnest # etc - see YiffSpace::Extensions::ActiveRecord::*
+```
+
+The old global monkeypatch style (`core_ext/**`) is still available via
+`require("yiffspace/core_ext/active_record/all")`, aliasing the same
+behavior onto `ActiveRecord::Relation`/`Arel` directly.
+
+## Contributing
+
+Go away
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require("bundler/gem_tasks")

data/lib/yiffspace/arel/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Arel
+    VERSION = "0.0.1"
+  end
+end

data/lib/yiffspace/arel.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require("zeitwerk")
+
+module YiffSpace
+  module Arel
+  end
+end
+
+loader = Zeitwerk::Loader.for_gem_extension(YiffSpace)
+loader.inflector.inflect({ "postgresql" => "PostgreSQL" })
+loader.ignore("#{__dir__}/core_ext")
+loader.setup

data/lib/yiffspace/core_ext/active_record/all.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative("cross_join_lateral")
+require_relative("cross_unnest")
+require_relative("left_join_lateral")
+require_relative("left_unnest")
+require_relative("unnest")

data/lib/yiffspace/core_ext/active_record/cross_join_lateral.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require("active_record/relation")
+require_relative("../arel/cross_join_lateral")
+require_relative("../../extensions/active_record/cross_join_lateral")
+
+ActiveRecord::Relation.include(YiffSpace::Extensions::ActiveRecord::CrossJoinLateral)

data/lib/yiffspace/core_ext/active_record/cross_unnest.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require("active_record/relation")
+require_relative("unnest")
+require_relative("../../extensions/active_record/cross_unnest")
+
+ActiveRecord::Relation.include(YiffSpace::Extensions::ActiveRecord::CrossUnnest)

data/lib/yiffspace/core_ext/active_record/left_join_lateral.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require("active_record/relation")
+require_relative("../arel/left_join_lateral")
+require_relative("../../extensions/active_record/left_join_lateral")
+
+ActiveRecord::Relation.include(YiffSpace::Extensions::ActiveRecord::LeftJoinLateral)

data/lib/yiffspace/core_ext/active_record/left_unnest.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require("active_record/relation")
+require_relative("unnest")
+require_relative("../../extensions/active_record/left_unnest")
+
+ActiveRecord::Relation.include(YiffSpace::Extensions::ActiveRecord::LeftUnnest)

data/lib/yiffspace/core_ext/active_record/unnest.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require("active_record/relation")
+require_relative("cross_join_lateral")
+require_relative("left_join_lateral")
+require_relative("../../extensions/active_record/unnest")
+
+ActiveRecord::Relation.include(YiffSpace::Extensions::ActiveRecord::Unnest)

data/lib/yiffspace/core_ext/arel/all.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative("cross_join_lateral")
+require_relative("left_join_lateral")

data/lib/yiffspace/core_ext/arel/cross_join_lateral.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative("../../extensions/arel/nodes/cross_join_lateral")
+require_relative("../../extensions/arel/visitors/postgresql/cross_join_lateral")
+require_relative("../../extensions/arel/table/cross_join_lateral")
+
+module Arel
+  module Nodes
+    CrossJoinLateral = YiffSpace::Extensions::Arel::Nodes::CrossJoinLateral
+  end
+
+  module Visitors
+    class PostgreSQL
+      include(YiffSpace::Extensions::Arel::Visitors::PostgreSQL::CrossJoinLateral)
+    end
+  end
+
+  class Table
+    include(YiffSpace::Extensions::Arel::Table::CrossJoinLateral)
+  end
+end

data/lib/yiffspace/core_ext/arel/left_join_lateral.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative("../../extensions/arel/nodes/left_join_lateral")
+require_relative("../../extensions/arel/visitors/postgresql/left_join_lateral")
+require_relative("../../extensions/arel/table/left_join_lateral")
+
+module Arel
+  module Nodes
+    LeftJoinLateral = YiffSpace::Extensions::Arel::Nodes::LeftJoinLateral
+  end
+
+  module Visitors
+    class PostgreSQL
+      include(YiffSpace::Extensions::Arel::Visitors::PostgreSQL::LeftJoinLateral)
+    end
+  end
+
+  class Table
+    include(YiffSpace::Extensions::Arel::Table::LeftJoinLateral)
+  end
+end

data/lib/yiffspace/extensions/active_record/cross_join_lateral.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module ActiveRecord
+      module CrossJoinLateral
+        def cross_join_lateral(relation)
+          raise(ArgumentError, "The method .cross_join_lateral() must contain arguments.") if relation.nil?
+
+          relation = relation.arel if relation.respond_to?(:arel)
+          spawn.cross_join_lateral!(relation)
+        end
+
+        def cross_join_lateral!(relation) # :nodoc:
+          manager = klass.arel_table.cross_join_lateral(relation)
+
+          self.joins_values |= [manager.join_sources.first]
+          self
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/active_record/cross_unnest.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module ActiveRecord
+      module CrossUnnest
+        def cross_unnest(column, as: column.singularize)
+          raise(ArgumentError, "The method .cross_unnest() must contain arguments.") if column.nil?
+
+          spawn.unnest(column, as: as, type: :cross_join_lateral)
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/active_record/left_join_lateral.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module ActiveRecord
+      module LeftJoinLateral
+        def left_join_lateral(relation, on: nil)
+          raise(ArgumentError, "The method .left_join_lateral() must contain arguments.") if relation.nil?
+
+          relation = relation.arel if relation.respond_to?(:arel)
+          spawn.left_join_lateral!(relation, on: on)
+        end
+
+        def left_join_lateral!(relation, on: nil) # :nodoc:
+          manager = klass.arel_table.left_join_lateral(relation)
+          manager.on(on) if on
+
+          self.joins_values |= [manager.join_sources.first]
+          self
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/active_record/left_unnest.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module ActiveRecord
+      module LeftUnnest
+        def left_unnest(column, as: column.singularize)
+          raise(ArgumentError, "The method .left_unnest() must contain arguments.") if column.nil?
+
+          spawn.unnest(column, as: as, type: :left_join_lateral)
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/active_record/unnest.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module ActiveRecord
+      module Unnest
+        def unnest(column, as: column.singularize, type: :left_join_lateral)
+          raise(ArgumentError, "The method .unnest() must contain arguments.") if column.nil?
+
+          spawn.unnest!(column, as, type)
+        end
+
+        def unnest!(column, name, type) # :nodoc:
+          function = ::Arel::Nodes::NamedFunction.new("unnest", [klass.arel_table[column]]).as(name)
+          spawn.send("#{type}!", function, **({ on: ::Arel.sql("TRUE") } if type == :left_join_lateral))
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/arel/nodes/cross_join_lateral.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require("arel")
+
+module YiffSpace
+  module Extensions
+    module Arel
+      module Nodes
+        class CrossJoinLateral < ::Arel::Nodes::Join
+          def initialize(left, right = nil)
+            super
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/arel/nodes/left_join_lateral.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require("arel")
+
+module YiffSpace
+  module Extensions
+    module Arel
+      module Nodes
+        class LeftJoinLateral < ::Arel::Nodes::Join
+          def initialize(left, right = nil)
+            super
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/arel/table/cross_join_lateral.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module Arel
+      module Table
+        module CrossJoinLateral
+          def cross_join_lateral(relation)
+            join(relation, ::Arel::Nodes::CrossJoinLateral)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/arel/table/left_join_lateral.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module Arel
+      module Table
+        module LeftJoinLateral
+          def left_join_lateral(relation)
+            join(relation, ::Arel::Nodes::LeftJoinLateral)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/arel/visitors/postgresql/cross_join_lateral.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module Arel
+      module Visitors
+        module PostgreSQL
+          module CrossJoinLateral
+            # noinspection RubyInstanceMethodNamingConvention
+            def visit_YiffSpace_Extensions_Arel_Nodes_CrossJoinLateral(o, collector)
+              collector << "CROSS JOIN LATERAL "
+              visit(o.left, collector)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yiffspace/extensions/arel/visitors/postgresql/left_join_lateral.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module YiffSpace
+  module Extensions
+    module Arel
+      module Visitors
+        module PostgreSQL
+          module LeftJoinLateral
+            # noinspection RubyInstanceMethodNamingConvention
+            def visit_YiffSpace_Extensions_Arel_Nodes_LeftJoinLateral(o, collector)
+              collector << "LEFT JOIN LATERAL "
+              visit(o.left, collector)
+              return unless o.right
+
+              collector << " ON "
+              visit(o.right.expr, collector)
+            end
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: yiffspace-arel
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Donovan_DMC
+bindir: bin
+cert_chain: []
+date: 2026-09-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: Postgres lateral-join/unnest ActiveRecord & Arel extensions, for https://yiff.space
+  and related projects
+email:
+- hewwo@yiff.rocks
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- lib/yiffspace/arel.rb
+- lib/yiffspace/arel/version.rb
+- lib/yiffspace/core_ext/active_record/all.rb
+- lib/yiffspace/core_ext/active_record/cross_join_lateral.rb
+- lib/yiffspace/core_ext/active_record/cross_unnest.rb
+- lib/yiffspace/core_ext/active_record/left_join_lateral.rb
+- lib/yiffspace/core_ext/active_record/left_unnest.rb
+- lib/yiffspace/core_ext/active_record/unnest.rb
+- lib/yiffspace/core_ext/arel/all.rb
+- lib/yiffspace/core_ext/arel/cross_join_lateral.rb
+- lib/yiffspace/core_ext/arel/left_join_lateral.rb
+- lib/yiffspace/extensions/active_record/cross_join_lateral.rb
+- lib/yiffspace/extensions/active_record/cross_unnest.rb
+- lib/yiffspace/extensions/active_record/left_join_lateral.rb
+- lib/yiffspace/extensions/active_record/left_unnest.rb
+- lib/yiffspace/extensions/active_record/unnest.rb
+- lib/yiffspace/extensions/arel/nodes/cross_join_lateral.rb
+- lib/yiffspace/extensions/arel/nodes/left_join_lateral.rb
+- lib/yiffspace/extensions/arel/table/cross_join_lateral.rb
+- lib/yiffspace/extensions/arel/table/left_join_lateral.rb
+- lib/yiffspace/extensions/arel/visitors/postgresql/cross_join_lateral.rb
+- lib/yiffspace/extensions/arel/visitors/postgresql/left_join_lateral.rb
+homepage: https://yiff.space
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://yiff.space
+  source_code_uri: https://github.com/YiffSpace/Gem/tree/master/yiffspace-arel
+  changelog_uri: https://github.com/YiffSpace/Gem/blob/master/yiffspace-arel/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Postgres lateral-join/unnest ActiveRecord & Arel extensions, for https://yiff.space
+  and related projects
+test_files: []