quo 0.5.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3c2546945f1bfdd80965174357d5f2246e82a0e5dc7158f2d60944e980899fe
-  data.tar.gz: ac40d8dd995273b4de27102a021741416d9501d5ff1bb6070f917bcac35bf164
+  metadata.gz: 3d20b292ae3178fa1ce96705049b215f37d4966a44ee9d05b4fafda3a664a9f5
+  data.tar.gz: a151bfb1c35dcfea765d3aac5b1bf501c842288e99529523dadf410c0243fe04
 SHA512:
-  metadata.gz: 825a13e681e234d7679452d837d27e627cf66f1877ae846cb224ad5b83db04714a4a4c15b3ce37de01f733c996226844d892a4975884c4e3926b6f4acf8e23ee
-  data.tar.gz: a2bde21de2adf4e548502c5daed323e043d8fbf7a5d7f07956234bf01c3223b888a5fce77f0a54c6943bb25035aae866d4ed2c10148759ee14384e4e717f8fcc
+  metadata.gz: bd0e575917052a3171dd45eada04a0ad0e0c670154294507a76808e5bc508d21d8aa53bdad3deebdea11f57a91193c1ae4132589dc330a273b3dda588f635d2f
+  data.tar.gz: 3faaa3f25cb76d44b70c28425f42f582ed58a7b83c573d976019caef302e4bceeedb8f93912250de7e80b3a906042820eb9884049891c75f5971e3a143361006

data/Gemfile

@@ -17,4 +17,7 @@ group :development, :test do
   gem "standard", "~> 1.3"
 
   gem "steep", "~> 1.2"
+
+  gem "typed_operation", github: "stevegeek/typed_operation", branch: "main"
+  gem "literal", github: "joeldrapper/literal", branch: "main"
 end

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/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

data/lib/quo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Quo
-  VERSION = "0.5.1"
+  VERSION = "0.5.2"
 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.2
 platform: ruby
 authors:
 - Stephen Ierodiaconou
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-11 00:00:00.000000000 Z
+date: 2023-09-09 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.4.19
 signing_key:
 specification_version: 4
 summary: Quo is a query object gem for Rails