nova-api 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa39e814bbceecbe8191606e74224febce92a84c0f1104f3c9c4d4df02b6f2e9
-  data.tar.gz: 86907f861fe768cf51f646dfca498f19a30d1dc0c8514f9d4434ae7f8b89a4c2
+  metadata.gz: c0fbc5096804dd54c1d97774f9635c99a0bfa43f91327817d345c10443861eda
+  data.tar.gz: 1d571800c7d52f1ccc9a05c5b33fd6d5765292d1fa71b854208f4a4ba9ae20ac
 SHA512:
-  metadata.gz: '0391d5f88122b8e7dfabc1386939f40c7b57c5d9928626a5db73da4080018b4cb339df0ac21c885a35002253fafdd6ebcb5e23e6df12e16fae0dbce0570d6e64'
-  data.tar.gz: 62f754ce3115dc2d1b90cd7a9d9ab47cd0f4c443f1100e548b3fcab345f97558045d873c2ffaebb7277fa152c66157182b33feddaabc739127a60115da9746a1
+  metadata.gz: 9354aea92ede4f23fe371f1dccfc67041e75015160141d0cc8e3b223b4a289480654bb15d4fb049bdb0298b8dd7395d030b4735961b53fcabddc8a77ab26e157
+  data.tar.gz: 472d308fbb65a803f6be0b0989d8c79f57887b1d2a8636731443eefc40637848e69890b5376b084ac60c8c800fa9c47641e474441861898ede7516d23db4b1aa

data/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.10.0] - 2026-11-09
+
+### Added
+
+- `Nova::API.with_configuration`, which overrides configuration attributes for the current thread during a block
+
+### Changed
+
+- `Nova::API.configure` called outside the main thread now changes a copy private to that thread, instead of the configuration shared by the whole process
+
+### Fixed
+
+- `NameError` for `Forwardable` when requiring the gem in an environment that had not loaded it yet
+
 ## [1.9.0] - 2026-11-09
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nova-api (1.9.0)
+    nova-api (1.10.0)
       dry-struct (~> 1.6)
       dry-types (~> 1.7)
       httparty (~> 0.1)

data/README.md

@@ -36,6 +36,16 @@ Nova::API.configure do |config|
 end
 ```
 
+Calling ```configure``` on the main thread, as an initializer does at boot, sets the configuration for the whole process. Calling it on any other thread, such as a Puma request thread, only affects that thread.
+
+Web servers reuse their threads, so anything set with ```configure``` during a request is still there for the next request served by that thread. For multi-tenant applications, prefer ```with_configuration```, which only applies during the block:
+
+```ruby
+around_action do |_controller, action|
+  Nova::API.with_configuration(subdomain: current_tenant.subdomain, api_key: current_tenant.api_key) { action.call }
+end
+```
+
 After that you can start using the resources either by:
 
 - Instantiating a new ```Nova::API::Client``` object;

data/lib/nova/api/utils/base_struct.rb

@@ -1,5 +1,6 @@
 require 'dry-struct'
 require 'dry-types'
+require 'forwardable'
 
 module Nova
   module API

data/lib/nova/api/version.rb

@@ -2,6 +2,6 @@
 
 module Nova
   module API
-    VERSION = '1.9.0'
+    VERSION = '1.10.0'
   end
 end

data/lib/nova/api.rb

@@ -49,13 +49,51 @@ module Nova
     class MissingIdError < Error; end
     class EndpointNotConfiguredError < Error; end
 
+    THREAD_CONFIGURATION_KEY = :nova_api_configuration
+    private_constant :THREAD_CONFIGURATION_KEY
+
+    @configuration = Configuration.new
+
     class << self
+      # The configuration in effect for the current thread: its own, when it has
+      # one, or else the one shared by the whole process.
       def configuration
-        @configuration ||= Configuration.new
+        thread_configuration || @configuration
       end
 
+      # On the main thread (application boot) this changes the configuration
+      # shared by the whole process. On any other thread (a Puma request, for
+      # instance) it changes a copy private to that thread.
       def configure
-        yield(configuration)
+        yield(Thread.current == Thread.main ? configuration : own_thread_configuration)
+      end
+
+      # Runs the block with the given attributes overridden for the current
+      # thread only, restoring the previous configuration afterwards. Prefer this
+      # for per-request configuration, since nothing is left on the pooled thread.
+      def with_configuration(**overrides)
+        previous = thread_configuration
+        scoped = configuration.dup
+        overrides.each { |attribute, value| scoped.public_send("#{attribute}=", value) }
+        self.thread_configuration = scoped
+
+        yield
+      ensure
+        self.thread_configuration = previous
+      end
+
+      private
+
+      def own_thread_configuration
+        thread_configuration || (self.thread_configuration = @configuration.dup)
+      end
+
+      def thread_configuration
+        Thread.current.thread_variable_get(THREAD_CONFIGURATION_KEY)
+      end
+
+      def thread_configuration=(value)
+        Thread.current.thread_variable_set(THREAD_CONFIGURATION_KEY, value)
       end
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nova-api
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Coyô Software