quo 1.0.0.alpha1 → 1.0.0.beta1

data/sig/generated/quo/relation_backed_query.rbs

@@ -20,54 +20,17 @@ module Quo
     # @rbs return: String
     def self.sanitize_sql_parameter: (untyped value) -> String
 
-    @_rel_group: untyped?
+    @_specification: Quo::RelationBackedQuerySpecification?
 
-    @_rel_distinct: bool?
-
-    @_rel_order: untyped?
-
-    @_rel_limit: untyped?
-
-    @_rel_preload: untyped?
-
-    @_rel_includes: untyped?
-
-    @_rel_select: untyped?
-
-    # SQL 'SELECT' configuration, calls to underlying AR relation
-    # @rbs *options: untyped
-    # @rbs return: Quo::Query
-    def select: (*untyped options) -> Quo::Query
-
-    # SQL 'LIMIT' configuration, calls to underlying AR relation
-    # @rbs limit: untyped
-    # @rbs return: Quo::Query
-    def limit: (untyped limit) -> Quo::Query
-
-    # SQL 'ORDER BY' configuration, calls to underlying AR relation
-    # @rbs options: untyped
+    # Apply a query specification to this query
+    # @rbs specification: Quo::RelationBackedQuerySpecification
     # @rbs return: Quo::Query
-    def order: (untyped options) -> Quo::Query
+    def with_specification: (Quo::RelationBackedQuerySpecification specification) -> Quo::Query
 
-    # SQL 'GROUP BY' configuration, calls to underlying AR relation
-    # @rbs *options: untyped
+    # Apply query options using the specification
+    # @rbs options: Hash[Symbol, untyped]
     # @rbs return: Quo::Query
-    def group: (*untyped options) -> Quo::Query
-
-    # Configures underlying AR relation to include associations
-    # @rbs *options: untyped
-    # @rbs return: Quo::Query
-    def includes: (*untyped options) -> Quo::Query
-
-    # Configures underlying AR relation to preload associations
-    # @rbs *options: untyped
-    # @rbs return: Quo::Query
-    def preload: (*untyped options) -> Quo::Query
-
-    # Calls to underlying AR distinct method
-    # @rbs enabled: bool
-    # @rbs return: Quo::Query
-    def distinct: (?bool enabled) -> Quo::Query
+    def with: (?Hash[Symbol, untyped] options) -> Quo::Query
 
     # @rbs return: Quo::CollectionBackedQuery
     def to_collection: (?total_count: untyped) -> Quo::CollectionBackedQuery
@@ -77,6 +40,20 @@ module Quo
     # Return the SQL string for this query if its a relation type query object
     def to_sql: () -> String
 
+    # Implements a fluent API for query methods
+    # This allows methods to be chained like query.where(...).order(...).limit(...)
+    # @rbs method_name: Symbol
+    # @rbs *args: untyped
+    # @rbs **kwargs: untyped
+    # @rbs &block: untyped
+    # @rbs return: Quo::Query
+    def method_missing: (Symbol method_name, *untyped args, **untyped kwargs) ?{ (?) -> untyped } -> Quo::Query
+
+    # @rbs method_name: Symbol
+    # @rbs include_private: bool
+    # @rbs return: bool
+    def respond_to_missing?: (Symbol method_name, ?bool include_private) -> bool
+
     private
 
     def validated_query: () -> untyped

data/sig/generated/quo/relation_backed_query_specification.rbs

@@ -0,0 +1,94 @@
+# Generated from lib/quo/relation_backed_query_specification.rb with RBS::Inline
+
+module Quo
+  # RelationBackedQuerySpecification encapsulates all the options for building a SQL query
+  # This separates the storage of query options from the actual query construction
+  # and provides a cleaner interface for RelationBackedQuery
+  class RelationBackedQuerySpecification
+    # @rbs!
+    #   @options: Hash[Symbol, untyped]
+    attr_reader options: untyped
+
+    # @rbs options: Hash[Symbol, untyped]
+    def initialize: (?Hash[Symbol, untyped] options) -> untyped
+
+    # Creates a new specification with merged options
+    # @rbs new_options: Hash[Symbol, untyped]
+    # @rbs return: Quo::QuerySpecification
+    def merge: (Hash[Symbol, untyped] new_options) -> Quo::QuerySpecification
+
+    # Apply all the specification options to the given ActiveRecord relation
+    # @rbs relation: ActiveRecord::Relation
+    # @rbs return: ActiveRecord::Relation
+    def apply_to: (ActiveRecord::Relation relation) -> ActiveRecord::Relation
+
+    # @rbs *fields: untyped
+    # @rbs return: Quo::QuerySpecification
+    def select: (*untyped fields) -> Quo::QuerySpecification
+
+    # @rbs conditions: untyped
+    # @rbs return: Quo::QuerySpecification
+    def where: (untyped conditions) -> Quo::QuerySpecification
+
+    # @rbs order_clause: untyped
+    # @rbs return: Quo::QuerySpecification
+    def order: (untyped order_clause) -> Quo::QuerySpecification
+
+    # @rbs *columns: untyped
+    # @rbs return: Quo::QuerySpecification
+    def group: (*untyped columns) -> Quo::QuerySpecification
+
+    # @rbs value: Integer
+    # @rbs return: Quo::QuerySpecification
+    def limit: (Integer value) -> Quo::QuerySpecification
+
+    # @rbs value: Integer
+    # @rbs return: Quo::QuerySpecification
+    def offset: (Integer value) -> Quo::QuerySpecification
+
+    # @rbs tables: untyped
+    # @rbs return: Quo::QuerySpecification
+    def joins: (untyped tables) -> Quo::QuerySpecification
+
+    # @rbs tables: untyped
+    # @rbs return: Quo::QuerySpecification
+    def left_outer_joins: (untyped tables) -> Quo::QuerySpecification
+
+    # @rbs *associations: untyped
+    # @rbs return: Quo::QuerySpecification
+    def includes: (*untyped associations) -> Quo::QuerySpecification
+
+    # @rbs *associations: untyped
+    # @rbs return: Quo::QuerySpecification
+    def preload: (*untyped associations) -> Quo::QuerySpecification
+
+    # @rbs *associations: untyped
+    # @rbs return: Quo::QuerySpecification
+    def eager_load: (*untyped associations) -> Quo::QuerySpecification
+
+    # @rbs enabled: bool
+    # @rbs return: Quo::QuerySpecification
+    def distinct: (?bool enabled) -> Quo::QuerySpecification
+
+    # @rbs order_clause: untyped
+    # @rbs return: Quo::QuerySpecification
+    def reorder: (untyped order_clause) -> Quo::QuerySpecification
+
+    # @rbs *modules: untyped
+    # @rbs return: Quo::QuerySpecification
+    def extending: (*untyped modules) -> Quo::QuerySpecification
+
+    # @rbs *args: untyped
+    # @rbs return: Quo::QuerySpecification
+    def unscope: (*untyped args) -> Quo::QuerySpecification
+
+    # Builds a new specification from a hash of options
+    # @rbs options: Hash[Symbol, untyped]
+    # @rbs return: Quo::QuerySpecification
+    def self.build: (?Hash[Symbol, untyped] options) -> Quo::QuerySpecification
+
+    # Returns a blank specification
+    # @rbs return: Quo::QuerySpecification
+    def self.blank: () -> Quo::QuerySpecification
+  end
+end

data/sig/generated/quo/testing/collection_backed_fake.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/quo/testing/collection_backed_fake.rb with RBS::Inline
+
+module Quo
+  module Testing
+    class CollectionBackedFake
+      def collection: () -> untyped
+
+      def results: () -> untyped
+
+      def page_count: () -> untyped
+    end
+  end
+end

data/sig/generated/quo/testing/relation_backed_fake.rbs

@@ -0,0 +1,23 @@
+# Generated from lib/quo/testing/relation_backed_fake.rb with RBS::Inline
+
+module Quo
+  module Testing
+    class RelationBackedFake
+      def query: () -> untyped
+
+      def results: () -> untyped
+
+      def page_count: () -> untyped
+
+      def total_count: () -> untyped
+
+      private
+
+      def validated_query: () -> untyped
+
+      def underlying_query: () -> untyped
+
+      def configured_query: () -> untyped
+    end
+  end
+end

data/sig/literal.rbs

@@ -0,0 +1,7 @@
+module Literal
+  class Struct
+  end
+
+  module Types
+  end
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: quo
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha1
+  version: 1.0.0.beta1
 platform: ruby
 authors:
 - Stephen Ierodiaconou
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-16 00:00:00.000000000 Z
+date: 2025-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -19,7 +18,7 @@ dependencies:
         version: '7'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +28,7 @@ dependencies:
         version: '7'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -39,7 +38,7 @@ dependencies:
         version: '7'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -49,14 +48,14 @@ dependencies:
         version: '7'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: literal
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 1.6.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -66,7 +65,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 1.6.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -102,6 +101,7 @@ files:
 - gemfiles/rails_7.0.gemfile
 - gemfiles/rails_7.1.gemfile
 - gemfiles/rails_7.2.gemfile
+- gemfiles/rails_8.0.gemfile
 - lib/quo.rb
 - lib/quo/collection_backed_query.rb
 - lib/quo/collection_results.rb
@@ -111,6 +111,7 @@ files:
 - lib/quo/preloadable.rb
 - lib/quo/query.rb
 - lib/quo/relation_backed_query.rb
+- lib/quo/relation_backed_query_specification.rb
 - lib/quo/relation_results.rb
 - lib/quo/results.rb
 - lib/quo/rspec/helpers.rb
@@ -127,16 +128,19 @@ files:
 - sig/generated/quo/preloadable.rbs
 - sig/generated/quo/query.rbs
 - sig/generated/quo/relation_backed_query.rbs
+- sig/generated/quo/relation_backed_query_specification.rbs
 - sig/generated/quo/relation_results.rbs
 - sig/generated/quo/results.rbs
+- sig/generated/quo/testing/collection_backed_fake.rbs
+- sig/generated/quo/testing/relation_backed_fake.rbs
 - sig/generated/quo/version.rbs
+- sig/literal.rbs
 homepage: https://github.com/stevegeek/quo
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/stevegeek/quo
   source_code_uri: https://github.com/stevegeek/quo
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -151,8 +155,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Quo is a query object gem for Rails
 test_files: []