rls_multi_tenant 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e6d7f69028c0e956fc4d5caf7651dd885c4a9da43bed16a2d32e90c8177c7c9
-  data.tar.gz: 5c8d3042cf29d8a21aad002e16db1193d2d0e8b7fea7246e4766116e81d301f9
+  metadata.gz: 9380863d6f5f1f68de3a4beaa1569cd6ad94bb5536604e0a444822628b946feb
+  data.tar.gz: eecebe1cecb827ed406b161f566de19d3effb7e8a96d73ebd497209b158e1c8b
 SHA512:
-  metadata.gz: c35648de09e3f93962337d09fa699edc696a822924e19b046c1a2d6ae47663f4759f8e4c0541f1001c71f11f3b975827a7048e685082838f184c6f2becd33d9c
-  data.tar.gz: f7148ffd7576d6cc20ca513cfa92c6d21c9890dbbcacd9fcd9c42b755deba2ee584d0de8c88e644d019370944451d4797e2cba72e1c09e89866b3b33a779ff6d
+  metadata.gz: faeb27cf2559a330bf13294cea3b114d017cb77d9c6e9af95acba26572bbf2016f6ffe2f8fb0dc67b1e731205f34f4ff0c69a4a592a91d6ec5d8b2c68127a211
+  data.tar.gz: 3fb38ae302313ed9845e86f3120c267ae88ad3e8eea793355f36db359ad316f6eaaac11805d21696a0b940ce54ba755cf5b4c5fdb7741066f1bd5b60fc236726

data/.rubocop.yml

@@ -37,6 +37,7 @@ Metrics/MethodLength:
   Max: 25
 
 Metrics/ModuleLength:
+  Max: 120
   Exclude:
     - 'spec/**/*'
 

data/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-06-04
+
+### Added
+
+- **Apartment-style switching by a unique field.** `Tenant.switch_by(value)`
+  resolves the tenant by a unique column (defaulting to the configured
+  `subdomain_field`) and switches context for the block; pass `attribute:` to
+  use another column (e.g. `switch_by('acme', attribute: :slug)`). A permanent
+  `switch_by!` variant is also available. Both raise `RlsMultiTenant::Error`
+  when no tenant matches. Instance-level delegators are provided too.
+
 ## [0.3.1] - 2026-06-04
 
 Corrects two bugs in the 0.3.0 security work, both uncovered by a new

data/README.md

@@ -152,6 +152,29 @@ Tenant.reset! # Reset context
 current_tenant = Tenant.current
 ```
 
+#### Switching by a unique field (Apartment-style)
+
+Instead of a tenant object or id, switch by any unique column. The attribute
+defaults to the configured `subdomain_field`:
+
+```ruby
+# Switch by subdomain (default field) for a block
+Tenant.switch_by("company-a") do
+  User.create!(name: "User from Company A")
+end
+
+# Switch by another unique column
+Tenant.switch_by("acme-inc", attribute: :slug) do
+  # ...
+end
+
+# Permanent variant (until reset!)
+Tenant.switch_by!("company-a")
+Tenant.reset!
+```
+
+`switch_by` raises `RlsMultiTenant::Error` when no tenant matches the value.
+
 ### Automatic Subdomain-Based Tenant Switching
 
 The gem includes middleware that automatically switches tenants based on the request subdomain. This is enabled by default and works seamlessly with your tenant model.

data/lib/rls_multi_tenant/concerns/tenant_context.rb

@@ -60,6 +60,20 @@ module RlsMultiTenant
           apply_tenant_context(tenant_id, local: false)
         end
 
+        # Switch tenant context for a block, identifying the tenant by a unique
+        # field (Apartment-style). Defaults to the configured subdomain field.
+        #
+        #   Tenant.switch_by('acme') { ... }              # by subdomain
+        #   Tenant.switch_by('acme', attribute: :slug) { } # by another column
+        def switch_by(value, attribute: RlsMultiTenant.subdomain_field, &block)
+          switch(find_tenant_by!(attribute, value), &block)
+        end
+
+        # Permanent variant of switch_by (until reset). Same caveats as switch!.
+        def switch_by!(value, attribute: RlsMultiTenant.subdomain_field)
+          switch!(find_tenant_by!(attribute, value))
+        end
+
         # Reset tenant context
         def reset!
           connection.execute format(RESET_TENANT_ID_SQL, tenant_session_var)
@@ -81,6 +95,15 @@ module RlsMultiTenant
 
         private
 
+        # Look up a tenant by a unique attribute, raising if none matches.
+        def find_tenant_by!(attribute, value)
+          tenant = RlsMultiTenant.tenant_class.find_by(attribute => value)
+          return tenant if tenant
+
+          raise RlsMultiTenant::Error,
+                "#{RlsMultiTenant.tenant_class_name} with #{attribute}=#{value.inspect} not found"
+        end
+
         # Restore the previous context on the way out of a `switch` block.
         # If the block aborted the transaction (e.g. a policy violation), any
         # further statement raises until rollback; that rollback will clear the
@@ -142,8 +165,14 @@ module RlsMultiTenant
         self.class.switch(tenant_or_id, &block)
       end
 
+      def switch_by(value, attribute: RlsMultiTenant.subdomain_field, &block)
+        self.class.switch_by(value, attribute: attribute, &block)
+      end
+
       delegate :switch!, to: :class
 
+      delegate :switch_by!, to: :class
+
       delegate :reset!, to: :class
     end
   end

data/lib/rls_multi_tenant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RlsMultiTenant
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rls_multi_tenant
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Coding Ways