optify-config 1.3.1-x86_64-linux → 1.4.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f1dc7c9ef84b4fe1e0f9e97e5903aaa1cf1c8a44f526e754368de722210bdc7
-  data.tar.gz: 7ba2ce83316437cf46beb1bbebb7ce3bdf822c0c076d8be4fe9fa581fdd6b8ba
+  metadata.gz: 34d4942fdd16516b838755a6588d185813b39895287972000ea72919249c8349
+  data.tar.gz: aa1a4f179fe266262a52d60b5805d825b377b512bfd74d9f0647601bcff1049b
 SHA512:
-  metadata.gz: 92016a7ad735204fe73d56e2a53c2028afd5d159d9f7a5c5d0b888f3abac2a2272beb70de977496f3b277c42295ddae914553bbc64f429763575cc6a5ede3a31
-  data.tar.gz: ff6fe6b43d700d400d225a46cb7ffad49687a7daba2949497daf2923a12420ec93a7bfe1961c390e0967dc2252d5244cf3359c0d0bf956bbfb1c79312ee065d0
+  metadata.gz: 01ee18fceeaff83882ceb2d14eb77da5e2804355cd47c4c138789806cc34e707472d03ff5c594b29d063f0509f3ed4fdab684b270be30733f7d9e1691917e777
+  data.tar.gz: d5546a15c032e7149646aedbc52449c73858e253c6c7d754b1df96ea2489ea18fb4253ba1e4880c3fb0da5dc5fc7b2080ccd14df42a8a0d61119491089ab8656

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: x86_64-linux
 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.so
 - lib/optify_ruby/3.4/optify_ruby.so
 - 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