quo 0.5.1 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3c2546945f1bfdd80965174357d5f2246e82a0e5dc7158f2d60944e980899fe
-  data.tar.gz: ac40d8dd995273b4de27102a021741416d9501d5ff1bb6070f917bcac35bf164
+  metadata.gz: 71564f3db9d5b4d555d2a21d01f2754ac7db5a650db760f480e6e968343b6994
+  data.tar.gz: 27ba399c9fd255fcff14ca7c2ab419d8547f6f7e2d319c2cb96aeaeed8dbc032
 SHA512:
-  metadata.gz: 825a13e681e234d7679452d837d27e627cf66f1877ae846cb224ad5b83db04714a4a4c15b3ce37de01f733c996226844d892a4975884c4e3926b6f4acf8e23ee
-  data.tar.gz: a2bde21de2adf4e548502c5daed323e043d8fbf7a5d7f07956234bf01c3223b888a5fce77f0a54c6943bb25035aae866d4ed2c10148759ee14384e4e717f8fcc
+  metadata.gz: 6f43fe074d4ddfdbe71f27a5d65600ad014e473131d91c50ed911e541d533a9a2830ebb38420e17aba090657adf2f0f44409e995c5b3fc6666226c083eb1a93f
+  data.tar.gz: 07dcc1701c60ad300e92a67aea0c9b2a61c7edda34bc99aa5a0b9faab7c77a71ace33548822c70006f2965d5cdd3140b7df819d585675d045d92e477c5909871

data/README.md

@@ -130,6 +130,38 @@ composed = query1 + query2 # or Quo::Query.compose(query1, query2) or query1.com
 composed.first
 ```
 
+```ruby
+class CompanyToBeApproved < Quo::TypedQuery
+  def query
+    Registration
+      .left_joins(:approval)
+      .where(approvals: {completed_at: nil})
+  end
+end
+
+class CompanyInUsCityAndState < Quo::TypedQuery
+  param :state, Literal::Union[String, Array[String]]
+  param :city, optional(Literal::Union[String, Array[String]])
+
+  def query
+    q = Registration
+      .joins(company: :address)
+      .where(addresses: {state: state})
+    q = q.where(addresses: {city: city}) if city
+    q
+  end
+end
+
+
+query1 = CompanyToBeApproved.new
+query_partialy_applied = CompanyInUsState.with(state: "California")
+query2 = query_partialy_applied.with(city: ["San Francisco", "Los Angeles"]).operation
+
+composed = query1 + query2
+# '+' composes the queries and returns a new prepared query
+composed.first
+```
+
 This effectively executes:
 
 ```ruby
@@ -138,6 +170,7 @@ Registration
   .joins(company: :address)
   .where(approvals: {completed_at: nil})
   .where(addresses: {state: options[:state]})
+  .limit(1)
 ```
 
 It is also possible to compose with an `ActiveRecord::Relation`. This can be useful in a Query object itself to help

data/lib/quo/merged_query.rb

@@ -17,7 +17,7 @@ module Quo
       self.class.new(query, left, right, **@options.merge(options))
     end
 
-    def to_s
+    def inspect
       "Quo::MergedQuery[#{operand_desc(left)}, #{operand_desc(right)}]"
     end
 
@@ -27,7 +27,7 @@ module Quo
 
     def operand_desc(operand)
       if operand.is_a? Quo::MergedQuery
-        operand.to_s
+        operand.inspect
       else
         operand.class.name || "(anonymous)"
       end

data/lib/quo/query.rb

@@ -148,6 +148,7 @@ module Quo
 
     # Some convenience methods for working with results
     delegate :each,
+      :find_each,
       :map,
       :flat_map,
       :reduce,

data/lib/quo/results.rb

@@ -3,9 +3,6 @@
 require "forwardable"
 require_relative "./utilities/callstack"
 
-# TODO: can the results be more like a monad, so we can provide success vs failure ... or
-# maybe it is a enumerable-like but it can also be pattern matched?
-
 module Quo
   class Results
     extend Forwardable
@@ -64,7 +61,7 @@ module Quo
     end
 
     def respond_to_missing?(name, include_private = false)
-      Enumerable.instance_methods.include?(name)
+      enumerable_methods_supported.include?(name)
     end
 
     private
@@ -80,5 +77,9 @@ module Quo
         transformer.call(results)
       end
     end
+
+    def enumerable_methods_supported
+      [:find_each] + Enumerable.instance_methods
+    end
   end
 end

data/lib/quo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Quo
-  VERSION = "0.5.1"
+  VERSION = "0.5.3"
 end

data/sig/quo/merged_query.rbs

@@ -8,7 +8,7 @@ module Quo
 
     def query: () -> relOrEnumerable
 
-    def to_s: () -> ::String
+    def inspect: () -> ::String
 
     private
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quo
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.3
 platform: ruby
 authors:
 - Stephen Ierodiaconou
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-11 00:00:00.000000000 Z
+date: 2024-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -114,7 +114,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: Quo is a query object gem for Rails