openfeature-sdk-sorbet 0.2.1 → 0.3.0

data/lib/open_feature/hooks.rb

@@ -0,0 +1,22 @@
+# typed: strict
+# frozen_string_literal: true
+
+module OpenFeature
+  # Represents full set of hooks with helper methods for filtering and sequencing each subtype
+  class Hooks < T::Struct
+    extend T::Generic
+    extend T::Sig
+    const :global, T::Array[Hook], default: []
+    const :provider, T::Array[Hook], default: []
+    const :client, T::Array[Hook], default: []
+    const :invocation, T::Array[Hook], default: []
+
+    # See Requirement 4.4.2
+    # TODO: when there is >1 subtype of hook will need to filter and not simply re-cast
+    #   ACHTUNG! T.cast is safe for now but will need to be updated after ^
+    sig { returns(T::Array[Hook::BeforeHook]) }
+    def before
+      T.cast(global + client + invocation + provider, T::Array[Hook::BeforeHook])
+    end
+  end
+end

data/lib/open_feature/multiple_source_provider.rb

@@ -7,19 +7,18 @@ module OpenFeature
   # The providers will be evaluated in that order and the first
   # non-error result will be used. If all sources return an error
   # then the default value is used.
-  class MultipleSourceProvider
+  class MultipleSourceProvider < Provider
     extend T::Sig
 
-    include Provider
-
     sig { params(providers: T::Array[Provider]).void }
     def initialize(providers:)
       @providers = providers
+      super(ProviderStatus::NotReady)
     end
 
     sig { override.returns(ProviderMetadata) }
     def metadata
-      ProviderMetadata.new(name: "Multiple Sources: #{providers.map(&:metadata).map(&:name).join(", ")}")
+      ProviderMetadata.new(name: "Multiple Sources: #{providers.map { |provider| provider.metadata.name }.join(", ")}")
     end
 
     sig { override.returns(T::Array[Hook]) }
@@ -27,6 +26,23 @@ module OpenFeature
       providers.flat_map(&:hooks)
     end
 
+    sig { override.params(context: EvaluationContext).void }
+    def init(context:)
+      providers.each { |provider| provider.init(context:) }
+      @status = if providers.all? { |provider| provider.status == ProviderStatus::Ready }
+                  ProviderStatus::Ready
+                else
+                  ProviderStatus::Error
+                end
+    rescue StandardError
+      @status = ProviderStatus::Error
+    end
+
+    sig { override.void }
+    def shutdown
+      providers.each(&:shutdown)
+    end
+
     sig do
       override
         .params(
@@ -37,8 +53,8 @@ module OpenFeature
         .returns(ResolutionDetails[T::Boolean])
     end
     def resolve_boolean_value(flag_key:, default_value:, context: nil)
-      resolve_from_sources(default_value: default_value) do |provider|
-        provider.resolve_boolean_value(flag_key: flag_key, default_value: default_value, context: context)
+      resolve_from_sources(default_value:) do |provider|
+        provider.resolve_boolean_value(flag_key:, default_value:)
       end
     end
 
@@ -52,8 +68,8 @@ module OpenFeature
         .returns(ResolutionDetails[Numeric])
     end
     def resolve_number_value(flag_key:, default_value:, context: nil)
-      resolve_from_sources(default_value: default_value) do |provider|
-        provider.resolve_number_value(flag_key: flag_key, default_value: default_value, context: context)
+      resolve_from_sources(default_value:) do |provider|
+        provider.resolve_number_value(flag_key:, default_value:)
       end
     end
 
@@ -67,8 +83,8 @@ module OpenFeature
         .returns(ResolutionDetails[Structure])
     end
     def resolve_structure_value(flag_key:, default_value:, context: nil)
-      resolve_from_sources(default_value: default_value) do |provider|
-        provider.resolve_structure_value(flag_key: flag_key, default_value: default_value, context: context)
+      resolve_from_sources(default_value:) do |provider|
+        provider.resolve_structure_value(flag_key:, default_value:)
       end
     end
 
@@ -82,8 +98,8 @@ module OpenFeature
         .returns(ResolutionDetails[String])
     end
     def resolve_string_value(flag_key:, default_value:, context: nil)
-      resolve_from_sources(default_value: default_value) do |provider|
-        provider.resolve_string_value(flag_key: flag_key, default_value: default_value, context: context)
+      resolve_from_sources(default_value:) do |provider|
+        provider.resolve_string_value(flag_key:, default_value:)
       end
     end
 

data/lib/open_feature/no_op_provider.rb

@@ -5,11 +5,9 @@ module OpenFeature
   # Default provider when initializing OpenFeature.
   # Always returns the default value given.
   # This will result in a TypeError if the given default value does not have the correct type.
-  class NoOpProvider
+  class NoOpProvider < Provider
     extend T::Sig
 
-    include Provider
-
     sig { override.returns(ProviderMetadata) }
     attr_reader :metadata
 
@@ -20,6 +18,7 @@ module OpenFeature
     def initialize
       @metadata = T.let(ProviderMetadata.new(name: "No Op Provider"), ProviderMetadata)
       @hooks = T.let([], T::Array[Hook])
+      super()
     end
 
     sig do

data/lib/open_feature/provider.rb

@@ -3,10 +3,21 @@
 
 module OpenFeature
   # Interface that providers must implement.
-  module Provider
+  class Provider
     extend T::Sig
     extend T::Helpers
-    interface!
+    abstract!
+
+    sig { returns(ProviderStatus) }
+    attr_reader :status
+
+    sig { params(status: ProviderStatus).void }
+    def initialize(status = ProviderStatus::Ready)
+      @status = status
+    end
+
+    sig { overridable.params(context: EvaluationContext).void }
+    def init(context:); end
 
     sig { abstract.returns(ProviderMetadata) }
     def metadata; end
@@ -14,6 +25,9 @@ module OpenFeature
     sig { abstract.returns(T::Array[Hook]) }
     def hooks; end
 
+    sig { overridable.void }
+    def shutdown; end
+
     sig do
       abstract
         .params(

data/lib/open_feature/provider_status.rb

@@ -0,0 +1,13 @@
+# typed: strict
+# frozen_string_literal: true
+
+module OpenFeature
+  # Indicates what state a provider is in
+  class ProviderStatus < T::Enum
+    enums do
+      NotReady = new
+      Ready = new
+      Error = new
+    end
+  end
+end

data/lib/open_feature.rb

@@ -19,6 +19,8 @@ module OpenFeature
 
     sig { params(provider: Provider).void }
     def set_provider(provider) # rubocop:disable Naming/AccessorMethodName
+      configuration.provider.shutdown
+      provider.init(context: configuration.evaluation_context || EvaluationContext.new)
       configuration.provider = provider
     end
 
@@ -42,12 +44,17 @@ module OpenFeature
     def create_client(name: nil, evaluation_context: nil, hooks: nil)
       Client.new(
         provider: configuration.provider,
-        name: name,
-        evaluation_context: evaluation_context,
+        name:,
+        evaluation_context:,
         hooks: Array(hooks)
       )
     end
 
+    sig { void }
+    def shutdown
+      configuration.provider.shutdown
+    end
+
     sig { returns(Configuration) }
     def configuration
       Configuration.instance

data/sorbet/rbi/gems/.gitattributes

@@ -0,0 +1 @@
+**/*.rbi linguist-generated=true

data/sorbet/rbi/gems/{json@2.6.3.rbi → json@2.7.1.rbi}

@@ -1,4 +1,4 @@
-# typed: true
+# typed: false
 
 # DO NOT EDIT MANUALLY
 # This is an autogenerated file for types exported from the `json` gem.
@@ -13,7 +13,7 @@ class Class < ::Module
   #
   # @return [Boolean]
   #
-  # source://json//json/common.rb#700
+  # source://json//json/common.rb#694
   def json_creatable?; end
 end
 
@@ -300,6 +300,15 @@ end
 #   # Raises JSON::NestingError (nesting of 2 is too deep):
 #   JSON.generate(obj, max_nesting: 2)
 #
+# ====== Escaping Options
+#
+# Options +script_safe+ (boolean) specifies wether <tt>'\u2028'</tt>, <tt>'\u2029'</tt>
+# and <tt>'/'</tt> should be escaped as to make the JSON object safe to interpolate in script
+# tags.
+#
+# Options +ascii_only+ (boolean) specifies wether all characters outside the ASCII range
+# should be escaped.
+#
 # ====== Output Options
 #
 # The default formatting options generate the most compact
@@ -617,8 +626,8 @@ module JSON
   # Output:
   #   {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
   #
-  # source://json//json/common.rb#631
-  def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil)); end
+  # source://json//json/common.rb#614
+  def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
   # :call-seq:
   #   JSON.fast_generate(obj, opts) -> new_string
@@ -634,13 +643,13 @@ module JSON
   #   # Raises SystemStackError (stack level too deep):
   #   JSON.fast_generate(a)
   #
-  # source://json//json/common.rb#335
+  # source://json//json/common.rb#328
   def fast_generate(obj, opts = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and later delete them.
   #
-  # source://json//json/common.rb#335
+  # source://json//json/common.rb#328
   def fast_unparse(obj, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -679,7 +688,7 @@ module JSON
   #   # Raises JSON::NestingError (nesting of 100 is too deep):
   #   JSON.generate(a)
   #
-  # source://json//json/common.rb#296
+  # source://json//json/common.rb#299
   def generate(obj, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -810,7 +819,7 @@ module JSON
   #      #<Admin:0x00000000064c41f8
   #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
   #
-  # source://json//json/common.rb#557
+  # source://json//json/common.rb#540
   def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :call-seq:
@@ -821,7 +830,7 @@ module JSON
   #
   # See method #parse.
   #
-  # source://json//json/common.rb#245
+  # source://json//json/common.rb#248
   def load_file(filespec, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -832,9 +841,12 @@ module JSON
   #
   # See method #parse!
   #
-  # source://json//json/common.rb#256
+  # source://json//json/common.rb#259
   def load_file!(filespec, opts = T.unsafe(nil)); end
 
+  # source://json//json/common.rb#642
+  def merge_dump_options(opts, strict: T.unsafe(nil)); end
+
   # :call-seq:
   #   JSON.parse(source, opts) -> object
   #
@@ -883,7 +895,7 @@ module JSON
   #   # Raises JSON::ParserError (783: unexpected token at ''):
   #   JSON.parse('')
   #
-  # source://json//json/common.rb#215
+  # source://json//json/common.rb#218
   def parse(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -898,7 +910,7 @@ module JSON
   #   which disables checking for nesting depth.
   # - Option +allow_nan+, if not provided, defaults to +true+.
   #
-  # source://json//json/common.rb#230
+  # source://json//json/common.rb#233
   def parse!(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -931,28 +943,28 @@ module JSON
   #     }
   #   }
   #
-  # source://json//json/common.rb#390
+  # source://json//json/common.rb#373
   def pretty_generate(obj, opts = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and later delete them.
   #
-  # source://json//json/common.rb#390
+  # source://json//json/common.rb#373
   def pretty_unparse(obj, opts = T.unsafe(nil)); end
 
   # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
   #
-  # source://json//json/common.rb#575
+  # source://json//json/common.rb#558
   def recurse_proc(result, &proc); end
 
-  # source://json//json/common.rb#557
+  # source://json//json/common.rb#540
   def restore(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and
   # later delete them.
   #
-  # source://json//json/common.rb#296
+  # source://json//json/common.rb#299
   def unparse(obj, opts = T.unsafe(nil)); end
 
   class << self
@@ -968,26 +980,26 @@ module JSON
     #   ruby = [0, 1, nil]
     #   JSON[ruby] # => '[0,1,null]'
     #
-    # source://json//json/common.rb#18
+    # source://json//json/common.rb#21
     def [](object, opts = T.unsafe(nil)); end
 
-    # source://json//json/common.rb#81
+    # source://json//json/common.rb#84
     def create_fast_state; end
 
     # Returns the current create identifier.
     # See also JSON.create_id=.
     #
-    # source://json//json/common.rb#126
+    # source://json//json/common.rb#129
     def create_id; end
 
     # Sets create identifier, which is used to decide if the _json_create_
     # hook of a class should be called; initial value is +json_class+:
     #   JSON.create_id # => 'json_class'
     #
-    # source://json//json/common.rb#120
+    # source://json//json/common.rb#123
     def create_id=(new_value); end
 
-    # source://json//json/common.rb#91
+    # source://json//json/common.rb#94
     def create_pretty_state; end
 
     # Return the constant located at _path_. The format of _path_ has to be
@@ -995,7 +1007,7 @@ module JSON
     # level (absolute namespace path?). If there doesn't exist a constant at
     # the given path, an ArgumentError is raised.
     #
-    # source://json//json/common.rb#42
+    # source://json//json/common.rb#45
     def deep_const_get(path); end
 
     # :call-seq:
@@ -1026,23 +1038,23 @@ module JSON
     # Output:
     #   {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
     #
-    # source://json//json/common.rb#631
-    def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil)); end
+    # source://json//json/common.rb#614
+    def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
     # Sets or returns the default options for the JSON.dump method.
     # Initially:
     #   opts = JSON.dump_default_options
-    #   opts # => {:max_nesting=>false, :allow_nan=>true, :escape_slash=>false}
+    #   opts # => {:max_nesting=>false, :allow_nan=>true, :script_safe=>false}
     #
-    # source://json//json/common.rb#596
+    # source://json//json/common.rb#579
     def dump_default_options; end
 
     # Sets or returns the default options for the JSON.dump method.
     # Initially:
     #   opts = JSON.dump_default_options
-    #   opts # => {:max_nesting=>false, :allow_nan=>true, :escape_slash=>false}
+    #   opts # => {:max_nesting=>false, :allow_nan=>true, :script_safe=>false}
     #
-    # source://json//json/common.rb#596
+    # source://json//json/common.rb#579
     def dump_default_options=(_arg0); end
 
     # :call-seq:
@@ -1059,13 +1071,13 @@ module JSON
     #   # Raises SystemStackError (stack level too deep):
     #   JSON.fast_generate(a)
     #
-    # source://json//json/common.rb#335
+    # source://json//json/common.rb#328
     def fast_generate(obj, opts = T.unsafe(nil)); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and later delete them.
     #
-    # source://json//json/common.rb#335
+    # source://json//json/common.rb#328
     def fast_unparse(obj, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1104,24 +1116,24 @@ module JSON
     #   # Raises JSON::NestingError (nesting of 100 is too deep):
     #   JSON.generate(a)
     #
-    # source://json//json/common.rb#296
+    # source://json//json/common.rb#299
     def generate(obj, opts = T.unsafe(nil)); end
 
     # Returns the JSON generator module that is used by JSON. This is
     # either JSON::Ext::Generator or JSON::Pure::Generator:
     #   JSON.generator # => JSON::Ext::Generator
     #
-    # source://json//json/common.rb#103
+    # source://json//json/common.rb#106
     def generator; end
 
     # Set the module _generator_ to be used by JSON.
     #
-    # source://json//json/common.rb#58
+    # source://json//json/common.rb#61
     def generator=(generator); end
 
     # Encodes string using String.encode.
     #
-    # source://json//json/common.rb#653
+    # source://json//json/common.rb#638
     def iconv(to, from, string); end
 
     # :call-seq:
@@ -1252,7 +1264,7 @@ module JSON
     #      #<Admin:0x00000000064c41f8
     #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
     #
-    # source://json//json/common.rb#557
+    # source://json//json/common.rb#540
     def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
     # Sets or returns default options for the JSON.load method.
@@ -1260,7 +1272,7 @@ module JSON
     #   opts = JSON.load_default_options
     #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
     #
-    # source://json//json/common.rb#420
+    # source://json//json/common.rb#403
     def load_default_options; end
 
     # Sets or returns default options for the JSON.load method.
@@ -1268,7 +1280,7 @@ module JSON
     #   opts = JSON.load_default_options
     #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
     #
-    # source://json//json/common.rb#420
+    # source://json//json/common.rb#403
     def load_default_options=(_arg0); end
 
     # :call-seq:
@@ -1279,7 +1291,7 @@ module JSON
     #
     # See method #parse.
     #
-    # source://json//json/common.rb#245
+    # source://json//json/common.rb#248
     def load_file(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1290,7 +1302,7 @@ module JSON
     #
     # See method #parse!
     #
-    # source://json//json/common.rb#256
+    # source://json//json/common.rb#259
     def load_file!(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1341,7 +1353,7 @@ module JSON
     #   # Raises JSON::ParserError (783: unexpected token at ''):
     #   JSON.parse('')
     #
-    # source://json//json/common.rb#215
+    # source://json//json/common.rb#218
     def parse(source, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1356,19 +1368,19 @@ module JSON
     #   which disables checking for nesting depth.
     # - Option +allow_nan+, if not provided, defaults to +true+.
     #
-    # source://json//json/common.rb#230
+    # source://json//json/common.rb#233
     def parse!(source, opts = T.unsafe(nil)); end
 
     # Returns the JSON parser class that is used by JSON. This is either
     # JSON::Ext::Parser or JSON::Pure::Parser:
     #   JSON.parser # => JSON::Ext::Parser
     #
-    # source://json//json/common.rb#29
+    # source://json//json/common.rb#32
     def parser; end
 
     # Set the JSON parser class _parser_ to be used by JSON.
     #
-    # source://json//json/common.rb#32
+    # source://json//json/common.rb#35
     def parser=(parser); end
 
     # :call-seq:
@@ -1401,50 +1413,55 @@ module JSON
     #     }
     #   }
     #
-    # source://json//json/common.rb#390
+    # source://json//json/common.rb#373
     def pretty_generate(obj, opts = T.unsafe(nil)); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and later delete them.
     #
-    # source://json//json/common.rb#390
+    # source://json//json/common.rb#373
     def pretty_unparse(obj, opts = T.unsafe(nil)); end
 
     # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
     #
-    # source://json//json/common.rb#575
+    # source://json//json/common.rb#558
     def recurse_proc(result, &proc); end
 
-    # source://json//json/common.rb#557
+    # source://json//json/common.rb#540
     def restore(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
     # Sets or Returns the JSON generator state class that is used by JSON. This is
     # either JSON::Ext::Generator::State or JSON::Pure::Generator::State:
     #   JSON.state # => JSON::Ext::Generator::State
     #
-    # source://json//json/common.rb#108
+    # source://json//json/common.rb#111
     def state; end
 
     # Sets or Returns the JSON generator state class that is used by JSON. This is
     # either JSON::Ext::Generator::State or JSON::Pure::Generator::State:
     #   JSON.state # => JSON::Ext::Generator::State
     #
-    # source://json//json/common.rb#108
+    # source://json//json/common.rb#111
     def state=(_arg0); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and
     # later delete them.
     #
-    # source://json//json/common.rb#296
+    # source://json//json/common.rb#299
     def unparse(obj, opts = T.unsafe(nil)); end
+
+    private
+
+    # source://json//json/common.rb#642
+    def merge_dump_options(opts, strict: T.unsafe(nil)); end
   end
 end
 
-# source://json//json/common.rb#114
+# source://json//json/common.rb#117
 JSON::CREATE_ID_TLS_KEY = T.let(T.unsafe(nil), String)
 
-# source://json//json/common.rb#111
+# source://json//json/common.rb#114
 JSON::DEFAULT_CREATE_ID = T.let(T.unsafe(nil), String)
 
 class JSON::GenericObject < ::OpenStruct
@@ -1490,20 +1507,23 @@ end
 # The base exception for JSON errors.
 class JSON::JSONError < ::StandardError
   class << self
-    # source://json//json/common.rb#138
+    # source://json//json/common.rb#141
     def wrap(exception); end
   end
 end
 
-# source://json//json/common.rb#35
+# source://json//json/common.rb#6
+JSON::NOT_SET = T.let(T.unsafe(nil), Object)
+
+# source://json//json/common.rb#38
 JSON::Parser = JSON::Ext::Parser
 
-# source://json//json/common.rb#73
+# source://json//json/common.rb#76
 JSON::State = JSON::Ext::Generator::State
 
 # For backwards compatibility
 #
-# source://json//json/common.rb#159
+# source://json//json/common.rb#162
 JSON::UnparserError = JSON::GeneratorError
 
 module Kernel
@@ -1516,18 +1536,18 @@ module Kernel
   # The _opts_ argument is passed through to generate/parse respectively. See
   # generate and parse for their documentation.
   #
-  # source://json//json/common.rb#685
+  # source://json//json/common.rb#679
   def JSON(object, *args); end
 
   # Outputs _objs_ to STDOUT as JSON strings in the shortest form, that is in
   # one line.
   #
-  # source://json//json/common.rb#663
+  # source://json//json/common.rb#657
   def j(*objs); end
 
   # Outputs _objs_ to STDOUT as JSON strings in a pretty format, with
   # indentation and over many lines.
   #
-  # source://json//json/common.rb#672
+  # source://json//json/common.rb#666
   def jj(*objs); end
 end