simple_query 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8295c4f43760f52dd7097852465c6d5ba007fb98789c233c25e88132113fccf
-  data.tar.gz: 45ced1eee79912b86eddaa4bf13ad7d56b4609ee8e68ce02390d027600d78509
+  metadata.gz: f15e71d4ac10ed8d359f177e46f36f12b9721da6f9f51c75d8a0571cf245aac0
+  data.tar.gz: 8090bd8f93899061f15a048a7c57a73e48e8805e7fee3807bb39ba91e0012b1f
 SHA512:
-  metadata.gz: 745e1f6bd0b85d12a5cab8e21d4839950bd98948914a54fae2ac77c47e7fe5861625081396ff4437684a1e2ade5441514c597e9c4d61577d51e580b628751f69
-  data.tar.gz: 1b034d21747e3740e2e390d428856a67b112e7c179d7704457bddc4983723f752f6aef87b76b3b2dd8d0c1857a6d55a834055f6749e85e7def1b005574c38cb5
+  metadata.gz: 903a9d4754ed89bf718918de17d94bf09969dc5a725d933b68c101a71737d397e90a89ac3ab141b4e18f855b39a81d62a27982c207dca20e7df7f0c6d8571746
+  data.tar.gz: 2965ff1462a4036112ba0bfe974087c72ba5e8f9b8db15d39a5f5879394dbe074cf9942682f9b50732c61f0d25749c514d38f1e11e2c8e0414308ee676f14ba1

data/README.md

@@ -108,6 +108,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 +162,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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimpleQuery
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 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.0
 platform: ruby
 authors:
 - Alex Kholodniak
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-22 00:00:00.000000000 Z
+date: 2025-02-26 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: