simple_query 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8295c4f43760f52dd7097852465c6d5ba007fb98789c233c25e88132113fccf
-  data.tar.gz: 45ced1eee79912b86eddaa4bf13ad7d56b4609ee8e68ce02390d027600d78509
+  metadata.gz: fa6c4c630a5cd486970ce4ca43b444f082050924305cb20e835a861b32676275
+  data.tar.gz: de8f1cc3758f4a65edbc4a1d4bbe1c5edde866d6016332d5b415c35d97423e7e
 SHA512:
-  metadata.gz: 745e1f6bd0b85d12a5cab8e21d4839950bd98948914a54fae2ac77c47e7fe5861625081396ff4437684a1e2ade5441514c597e9c4d61577d51e580b628751f69
-  data.tar.gz: 1b034d21747e3740e2e390d428856a67b112e7c179d7704457bddc4983723f752f6aef87b76b3b2dd8d0c1857a6d55a834055f6749e85e7def1b005574c38cb5
+  metadata.gz: c9fb69f0d5505926239e5dcc396dedb098f974b38a0a1d135ddeb50927de9b88b8dc0f0fb850a2ab2fe6b9e7ba9a4955738c36d4a1c0f974e507740fa00edb15
+  data.tar.gz: e8acc149f25a8b898a04ec7ca5203f98898d88bff334700ff5e4b6e0bb538b56fb47edd0b92cb66fbd86ac89c3f98d7c48930f25e9870bb34208b0bbd2735c4f

data/README.md

@@ -82,6 +82,27 @@ User.simple_query
     .lazy_execute
 ```
 
+Placeholder-Based Conditions
+
+SimpleQuery now supports **ActiveRecord-style placeholders**, letting you pass arrays with `?` or `:named` placeholders to your `.where` clauses:
+
+```ruby
+# Positional placeholders:
+User.simple_query
+    .where(["name LIKE ?", "%Alice%"])
+    .execute
+
+# Named placeholders:
+User.simple_query
+    .where(["email = :email", { email: "alice@example.com" }])
+    .execute
+
+# Multiple placeholders in one condition:
+User.simple_query
+    .where(["age >= :min_age AND age <= :max_age", { min_age: 18, max_age: 35 }])
+    .execute
+```
+
 ## Custom Read Models
 By default, SimpleQuery returns results as `Struct` objects for maximum speed. However, you can also define a lightweight model class for more explicit attribute handling or custom logic.
 
@@ -108,6 +129,48 @@ end
 ```
 This custom read model approach provides more clarity or domain-specific logic while still being faster than typical ActiveRecord instantiation.
 
+## Named Scopes
+SimpleQuery now supports named scopes, allowing you to reuse common query logic in a style similar to ActiveRecord’s built-in scopes. To define a scope, use the simple_scope class method in your model:
+```ruby
+class User < ActiveRecord::Base
+  include SimpleQuery
+
+  simple_scope :active do
+    where(active: true)
+  end
+
+  simple_scope :admins do
+    where(admin: true)
+  end
+
+  simple_scope :by_name do |name|
+    where(name: name)
+  end
+end
+```
+You can then chain these scopes seamlessly with the normal SimpleQuery DSL:
+
+```ruby
+# Parameterless scopes
+results = User.simple_query.active.admins.execute
+
+# Parameterized scope
+results = User.simple_query.by_name("Jane Doe").execute
+
+# Mixing scopes with other DSL calls
+results = User.simple_query
+              .by_name("John")
+              .active
+              .select(:id, :name)
+              .order(name: :asc)
+              .execute
+```
+### How It Works
+
+Each scope block (e.g. by_name) is evaluated in the context of the SimpleQuery builder, so you can call any DSL method (where, order, etc.) inside it.
+Parameterized scopes accept arguments — passed directly to the block (e.g. |name| above).
+Scopes return self, so you can chain multiple scopes or mix them with standard query methods.
+
 ## Features
 
 - Efficient query building
@@ -120,6 +183,7 @@ This custom read model approach provides more clarity or domain-specific logic w
 - Having and Grouping
 - Subqueries
 - Custom Read models
+- Named Scopes
 
 ## Performance
 

data/lib/simple_query/builder.rb

@@ -220,5 +220,24 @@ module SimpleQuery
         raise ArgumentError, "Unsupported select field type: #{field.class}"
       end
     end
+
+    def method_missing(method_name, *args, &block)
+      if (scope_block = find_scope(method_name))
+        instance_exec(*args, &scope_block)
+        self
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      !!find_scope(method_name) || super
+    end
+
+    def find_scope(method_name)
+      return unless model.respond_to?(:_simple_scopes)
+
+      model._simple_scopes[method_name.to_sym]
+    end
   end
 end

data/lib/simple_query/clauses/where_clause.rb

@@ -30,6 +30,9 @@ module SimpleQuery
         condition.map { |field, value| @table[field].eq(value) }
       when Arel::Nodes::Node
         [condition]
+      when Array
+        sanitized_sql = ActiveRecord::Base.send(:sanitize_sql_array, condition)
+        [Arel.sql(sanitized_sql)]
       else
         [Arel.sql(condition.to_s)]
       end

data/lib/simple_query/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimpleQuery
-  VERSION = "0.2.0"
+  VERSION = "0.3.1"
 end

data/lib/simple_query.rb

@@ -36,6 +36,27 @@ module SimpleQuery
     ActiveRecord::Base.include(SimpleQuery)
   end
 
+  class_methods do
+    def _simple_scopes
+      @_simple_scopes ||= {}
+    end
+
+    # A reusable scope that can be applied to a SimpleQuery::Builder instance
+    # Example:
+    #   simple_scope :active do
+    #     where(active: true)
+    #   end
+    #
+    # Parameterized scope:
+    #   simple_scope :by_name do |name|
+    #     where(name: name)
+    #   end
+    #
+    def simple_scope(name, &block)
+      _simple_scopes[name.to_sym] = block
+    end
+  end
+
   included do
     def self.simple_query
       Builder.new(self)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: simple_query
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Alex Kholodniak
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-22 00:00:00.000000000 Z
+date: 2025-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -108,13 +108,13 @@ files:
 - lib/simple_query/clauses/where_clause.rb
 - lib/simple_query/read_model.rb
 - lib/simple_query/version.rb
-homepage: https://oneruby.dev
+homepage: https://github.com/kholdrex/simple_query
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://oneruby.dev
+  homepage_uri: https://github.com/kholdrex/simple_query
   source_code_uri: https://github.com/kholdrex/simple_query
-  changelog_uri: https://github.com/kholdrex/simple_query/blob/main/CHANGELOG.md
+  changelog_uri: https://github.com/kholdrex/simple_query/blob/master/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: