optify-config 1.3.1-arm64-darwin → 1.4.0-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 047de527f317e146c8c1a1e0a55fb064fdfbb1deba7244ff1918f7711bc37f58
-  data.tar.gz: e311875d61d5f4eba2b6e94aff241dae276846d981974d872da9d3b60bf4f1fa
+  metadata.gz: 8018ef50ae10f20a6697b078f476cab8cbc3b16e732c835ef0d61977758bbcfd
+  data.tar.gz: d7c3016a5391eb23f9b268d39ddc3672594d0bb9b92df41c4107151c3ef03289
 SHA512:
-  metadata.gz: 2c02a632370d7412f22b2167d9ed854abd39cfee9ece700fa40e425b14869dcd5abcf4e23bfc5e623d3e1586bc56c0387ad452d23c8f12b2b7bbf02957188788
-  data.tar.gz: 6c94214d6397e1003f4ebb800a72ceecae16c9e3da5d0422413d734c08853fe23102bb6c55be889a783eafb969c19ad56bd58f789703cde394df921f5956450f
+  metadata.gz: 25a57e9395f136e20ecded59060653511a622264e49234b6b977368508e6edd7614b3b18cff85c070912b6c1f4867ccc8af2de6b1a9a7feed72a0dcb1709916d
+  data.tar.gz: fd5503dcd1cada4c68bb9263c7214793f58364b6509a0fac8416ca86dc58845e105c2f5ececd14029436607a4feb1bdf8022795ee3c602e60c41adad16ae9ee9

data/lib/optify.rb

@@ -2,6 +2,7 @@
 # typed: strict
 
 # The implementation to use directly Ruby and with types declared.
+require_relative 'optify_ruby/get_options_preferences'
 require_relative 'optify_ruby/implementation'
 require_relative 'optify_ruby/watcher_implementation'
 

data/lib/optify_ruby/get_options_preferences.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Optify
+  # Preferences for `get_options`.
+  class GetOptionsPreferences
+    # @param overrides [Hash]
+    #: (Hash[untyped, untyped] overrides) -> void
+    def overrides=(overrides)
+      self.overrides_json = overrides.to_json
+    end
+  end
+end

data/lib/optify_ruby/provider_module.rb

@@ -87,6 +87,11 @@ module Optify
       # Cache directly in Ruby instead of Rust because:
       # * Avoid any possible conversion overhead.
       # * Memory management: probably better to do it in Ruby for a Ruby app and avoid memory in Rust.
+      if preferences&.overrides?
+        Kernel.raise ArgumentError,
+                     'Caching when overrides are given is not supported. Do not pass cache options when using overrides in preferences.'
+      end
+
       init unless @cache
       unless preferences&.skip_feature_name_conversion
         # When there are just a few names, then it can be faster to convert them one by one in a loop to avoid working with an array in Rust.
@@ -98,6 +103,7 @@ module Optify
       result = @cache&.fetch(cache_key, NOT_FOUND_IN_CACHE_SENTINEL)
       return result unless result.equal?(NOT_FOUND_IN_CACHE_SENTINEL)
 
+      # TODO: Copy the preferences to avoid mutating the original object.
       preferences ||= GetOptionsPreferences.new
       preferences.skip_feature_name_conversion = true
       result = get_options(key, feature_names, config_class, nil, preferences)

data/rbi/optify.rbi

@@ -43,8 +43,25 @@ module Optify
 
   # Preferences when getting options.
   class GetOptionsPreferences
-    sig { params(value: T::Boolean).returns(GetOptionsPreferences) }
+    # Indicates if overrides are set.
+    sig { returns(T::Boolean) }
+    def overrides?; end
+
+    # Set overrides to apply after building the options based on the feature names.
+    # Do not provide overrides when requesting cached options.
+    # @param value The overrides to apply.
+    sig { params(value: T.nilable(T::Hash[T.untyped, T.untyped])).void }
+    def overrides=(value); end
+
+    # Set overrides to apply after building the options based on the feature names.
+    # Do not provide overrides when requesting cached options.
+    # @param value The overrides to apply as serialized JSON.
+    sig { params(value: T.nilable(String)).void }
+    def overrides_json=(value); end
+
+    sig { params(value: T::Boolean).void }
     def skip_feature_name_conversion=(value); end
+
     sig { returns(T::Boolean) }
     def skip_feature_name_conversion; end
   end

data/sig/optify.rbs

@@ -35,7 +35,20 @@ end
 
 # Preferences when getting options.
 class Optify::GetOptionsPreferences
-  def skip_feature_name_conversion=: (bool value) -> GetOptionsPreferences
+  # Indicates if overrides are set.
+  def overrides?: () -> bool
+
+  # Set overrides to apply after building the options based on the feature names.
+  # Do not provide overrides when requesting cached options.
+  # @param value The overrides to apply.
+  def overrides=: (::Hash[untyped, untyped]? value) -> void
+
+  # Set overrides to apply after building the options based on the feature names.
+  # Do not provide overrides when requesting cached options.
+  # @param value The overrides to apply as serialized JSON.
+  def overrides_json=: (String? value) -> void
+
+  def skip_feature_name_conversion=: (bool value) -> void
 
   def skip_feature_name_conversion: () -> bool
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: optify-config
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: arm64-darwin
 authors:
 - Justin D. Harris
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-05-08 00:00:00.000000000 Z
+date: 2025-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime
@@ -106,6 +106,7 @@ files:
 - lib/optify_ruby/3.2/optify_ruby.bundle
 - lib/optify_ruby/3.4/optify_ruby.bundle
 - lib/optify_ruby/base_config.rb
+- lib/optify_ruby/get_options_preferences.rb
 - lib/optify_ruby/implementation.rb
 - lib/optify_ruby/options_metadata.rb
 - lib/optify_ruby/provider_module.rb