openfeature-sdk 0.0.3 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa5a6e99d67eb65e8880d796b8785091679e353eabe7f619282d0aa30a14541d
-  data.tar.gz: 1e56499af1beac4c98245c40fcd840aad5a6327dc010320b76320f5f29065026
+  metadata.gz: 6286e12fce6a89a9b310e838fd456bfb6dd0fa35ea7d1bd99745beca5781fbd8
+  data.tar.gz: ed73a6433ca51fa55403f0893097f102e8816ca93c3b4ec5a21c26b019055461
 SHA512:
-  metadata.gz: 7e93027418e168d45dfdb874e9eafd9e8d94c479d0e31f4db09fad10ce6b454b0beb01e5fd42217d4f68ab0ecfb1be2402f673b02bc0399ff0469258a4b82558
-  data.tar.gz: 4ee653114169ef9ee3af004b65ca6fca4df1674f07cdb1493e28737667fa4d30f2ab1e7245de0b11627c9ae43fcfe175b4e24d6b5b40e0534b38a6bfabb0878a
+  metadata.gz: d81f9a31e72afb82edae5cb499d7cec3955199f9b5c795b7f477be314b1de5e5bc26cf9db292b1333b4da5a41ed3f068cab55494a10c1d355a3b641aa3560e4e
+  data.tar.gz: 7aff559376dd006308d92806521731aa0b95ddc098f2455bfdb8aa5d7ca4bb8dc57ac7f8ae5939bef9c66672c032d65548c09d704a74df51f2fdd5cad0aa6c28

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.0.3"
+  ".": "0.1.0"
 }

data/.rspec

@@ -1,3 +1,4 @@
+-I lib
 --format documentation
 --color
 --require spec_helper

data/.rubocop.yml

@@ -12,6 +12,17 @@ Style/StringLiteralsInInterpolation:
 
 Layout/LineLength:
   Max: 120
+  Exclude:
+    - 'spec/**/*.rb'
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*.rb'
+    - 'openfeature-sdk.gemspec'
 
 Gemspec/RequireMFA:
   Enabled: false
+
+Style/DocumentDynamicEvalDefinition:
+  # TODO re-enable after figuring out what it actually wants
+  Enabled: false

data/.ruby-version

@@ -1 +1 @@
-3.1.2
+3.1.3

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.0](https://github.com/open-feature/ruby-sdk/compare/v0.0.3...v0.1.0) (2022-12-15)
+
+
+### Features
+
+* Add client object ([#34](https://github.com/open-feature/ruby-sdk/issues/34)) ([92f8d0d](https://github.com/open-feature/ruby-sdk/commit/92f8d0d4bf693bf74d0f076621f3453f11d4ca65))
+* OpenFeature::SDK.configure ([#41](https://github.com/open-feature/ruby-sdk/issues/41)) ([7587799](https://github.com/open-feature/ruby-sdk/commit/75877997dcb49aeb38a4969734df87b2845e1e6a))
+* **spec:** Add API implementation ([#32](https://github.com/open-feature/ruby-sdk/issues/32)) ([d6b0922](https://github.com/open-feature/ruby-sdk/commit/d6b0922a54e9cb714c44dfe58ddab01356f6916b))
+
 ## [0.0.3](https://github.com/open-feature/ruby-sdk/compare/v0.0.2...v0.0.3) (2022-11-11)
 
 

data/Gemfile

@@ -4,3 +4,5 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in openfeature-sdk.gemspec
 gemspec
+
+gem "concurrent-ruby", require: "concurrent"

data/Gemfile.lock

@@ -1,12 +1,13 @@
 PATH
   remote: .
   specs:
-    openfeature-sdk (0.0.3)
+    openfeature-sdk (0.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
+    concurrent-ruby (1.1.10)
     diff-lcs (1.5.0)
     json (2.6.2)
     parallel (1.22.1)
@@ -55,6 +56,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  concurrent-ruby
   openfeature-sdk!
   rake (~> 13.0)
   rspec (~> 3.12.0)

data/README.md

@@ -50,17 +50,17 @@ end
 client = OpenFeature::SDK.build_client(name: "my-app")
 
 # fetching boolean value feature flag
-bool_value = client.fetch_boolean_value(flag_key: 'boolean_flag', default_value: false);
+bool_value = client.fetch_boolean_value(flag_key: 'boolean_flag', default_value: false)
 
 # fetching string value feature flag
-string_value = client.fetch_string_value(flag_key: 'string_flag', default_value: false);
+string_value = client.fetch_string_value(flag_key: 'string_flag', default_value: false)
 
 # fetching number value feature flag
-float_value = client.fetch_number_value(flag_key: 'number_value', default_value: 1.0);
-integer_value = client.fetch_number_value(flag_key: 'number_value', default_value: 1);
+float_value = client.fetch_number_value(flag_key: 'number_value', default_value: 1.0)
+integer_value = client.fetch_number_value(flag_key: 'number_value', default_value: 1)
 
 # get an object value
-object = client.fetch_object_value('object_value', JSON.dump({ name: 'object'}));
+object = client.fetch_object_value(flag_key: 'object_value', default_value: JSON.dump({ name: 'object'}))
 ```
 
 For complete documentation, visit: https://docs.openfeature.dev/docs/category/concepts

data/Rakefile

@@ -7,6 +7,9 @@ RSpec::Core::RakeTask.new(:spec)
 
 require "rubocop/rake_task"
 
-RuboCop::RakeTask.new
+RuboCop::RakeTask.new do |task|
+  task.options = ["--parallel"]
+  task.options << "--color" if ENV["CI"] == "true"
+end
 
 task default: %i[spec rubocop]

data/lib/openfeature/sdk/api.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require "forwardable"
+require "singleton"
+
+require_relative "configuration"
+require_relative "client"
+require_relative "metadata"
+require_relative "provider/no_op_provider"
+
+module OpenFeature
+  module SDK
+    # API Initialization and Configuration
+    #
+    # Represents the entry point to the API, including configuration of <tt>Provider</tt>,<tt>Hook</tt>,
+    # and building the <tt>Client</tt>
+    #
+    # To use the SDK, you can optionally configure a <tt>Provider</tt>, with <tt>Hook</tt>
+    #
+    #   OpenFeature::SDK::API.instance.configure do |config|
+    #     config.provider = NoOpProvider.new
+    #   end
+    #
+    # If no provider is specified, the <tt>NoOpProvider</tt> is set as the default <tt>Provider</tt>.
+    # Once the SDK has been configured, a client can be built
+    #
+    #   client = OpenFeature::SDK::API.instance.build_client(name: 'my-open-feature-client')
+    class API
+      include Singleton
+      extend Forwardable
+
+      def_delegator :@configuration, :provider
+      def_delegator :@configuration, :hooks
+      def_delegator :@configuration, :context
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def configure(&block)
+        return unless block_given?
+
+        block.call(configuration)
+      end
+
+      def build_client(name: nil, version: nil)
+        client_options = Metadata.new(name: name, version: version).freeze
+        provider = Provider::NoOpProvider.new if provider.nil?
+        Client.new(provider: provider, client_options: client_options, context: context)
+      end
+    end
+  end
+end

data/lib/openfeature/sdk/client.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module OpenFeature
+  module SDK
+    # TODO: Write documentation
+    #
+    class Client
+      RESULT_TYPE = %i[boolean string number object].freeze
+      SUFFIXES = %i[value details].freeze
+
+      attr_reader :metadata
+
+      attr_accessor :hooks
+
+      def initialize(provider:, client_options: nil, context: nil)
+        @provider = provider
+        @metadata = client_options
+        @context = context
+        @hooks = []
+      end
+
+      RESULT_TYPE.each do |result_type|
+        SUFFIXES.each do |suffix|
+          class_eval <<-RUBY, __FILE__, __LINE__ + 1
+            # def fetch_boolean_details(flag_key:, default_value:, evaluation_context: nil)
+            #   result = @provider.fetch_boolean_value(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context)
+            # end
+            def fetch_#{result_type}_#{suffix}(flag_key:, default_value:, evaluation_context: nil)
+              result = @provider.fetch_#{result_type}_value(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context)
+              #{"result.value" if suffix == :value}
+            end
+          RUBY
+        end
+      end
+    end
+  end
+end

data/lib/openfeature/sdk/configuration.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "concurrent"
+
+require_relative "api"
+
+module OpenFeature
+  module SDK
+    # Represents the configuration object for the global API where <tt>Provider</tt>, <tt>Hook</tt>,
+    # and <tt>Context</tt> are configured.
+    # This class is not meant to be interacted with directly but instead through the <tt>OpenFeature::SDK.configure</tt>
+    # method
+    class Configuration
+      extend Forwardable
+
+      attr_accessor :context, :provider, :hooks
+
+      def_delegator :@provider, :metadata
+
+      def initialize
+        @hooks = Concurrent::Array.new([])
+      end
+    end
+  end
+end

data/lib/openfeature/sdk/metadata.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module OpenFeature
+  module SDK
+    # Metadata structure that defines general metadata relating to a <tt>Provider</tt> or <tt>Client</tt>
+    #
+    # Within the Metadata structure, the following attribute readers are available:
+    #
+    # * <tt>name</tt> - Defines the name of the structure
+    #
+    # * <tt>version</tt> - Allows you to specify version of the Metadata structure
+    #
+    # Usage:
+    #
+    #   metadata = Metadata.new(name: 'name-for-metadata', version: 'v1.1.3')
+    #   metadata.name # 'name-for-metadata'
+    #   metadata.version # version
+    #   metadata_two = Metadata.new(name: 'name-for-metadata')
+    #   metadata_two == metadata # true - equality based on values
+    class Metadata
+      attr_reader :name, :version
+
+      def initialize(name:, version: nil)
+        @name = name
+        @version = version
+      end
+
+      def ==(other)
+        raise ArgumentError("Expected comparison to be between Metadata object") unless other.is_a?(Metadata)
+
+        @name == other.name && @version == other.version
+      end
+    end
+  end
+end

data/lib/openfeature/sdk/provider/no_op_provider.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative "../metadata"
+
+# rubocop:disable Lint/UnusedMethodArgument
+module OpenFeature
+  module SDK
+    module Provider
+      # Defines the default provider that is set if no provider is specified.
+      #
+      # To use <tt>NoOpProvider</tt>, it can be set during the configuration of the SDK
+      #
+      #   OpenFeature::SDK.configure do |config|
+      #     config.provider = NoOpProvider.new
+      #   end
+      #
+      # Within the <tt>NoOpProvider</tt>, the following methods exist
+      #
+      # * <tt>fetch_boolean_value</tt> - Retrieve feature flag boolean value
+      #
+      # * <tt>fetch_string_value</tt> - Retrieve feature flag string value
+      #
+      # * <tt>fetch_number_value</tt> - Retrieve feature flag number value
+      #
+      # * <tt>fetch_object_value</tt> - Retrieve feature flag object value
+      #
+      class NoOpProvider
+        REASON_NO_OP = "No-op"
+        NAME = "No-op Provider"
+
+        attr_reader :metadata
+
+        ResolutionDetails = Struct.new(:value, :reason, :variant, :error_code, :error_message)
+
+        def initialize
+          @metadata = Metadata.new(name: NAME).freeze
+        end
+
+        def fetch_boolean_value(flag_key:, default_value:, evaluation_context: nil)
+          no_op(default_value)
+        end
+
+        def fetch_string_value(flag_key:, default_value:, evaluation_context: nil)
+          no_op(default_value)
+        end
+
+        def fetch_number_value(flag_key:, default_value:, evaluation_context: nil)
+          no_op(default_value)
+        end
+
+        def fetch_object_value(flag_key:, default_value:, evaluation_context: nil)
+          no_op(default_value)
+        end
+
+        private
+
+        def no_op(default_value)
+          ResolutionDetails.new(value: default_value, reason: REASON_NO_OP)
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Lint/UnusedMethodArgument

data/lib/openfeature/sdk/version.rb

@@ -2,6 +2,6 @@
 
 module OpenFeature
   module SDK
-    VERSION = "0.0.3"
+    VERSION = "0.1.0"
   end
 end

data/lib/openfeature/sdk.rb

@@ -1,10 +1,24 @@
 # frozen_string_literal: true
 
 require_relative "sdk/version"
+require_relative "sdk/api"
 
 module OpenFeature
+  # TODO: Add documentation
+  #
   module SDK
-    class Error < StandardError; end
-    # Your code goes here...
+    class << self
+      def method_missing(method_name, *args, **kwargs, &block)
+        if API.instance.respond_to?(method_name)
+          API.instance.send(method_name, *args, **kwargs, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        API.instance.respond_to?(method_name, include_private) || super
+      end
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openfeature-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.0
 platform: ruby
 authors:
 - OpenFeature Authors
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-11-11 00:00:00.000000000 Z
+date: 2022-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -72,6 +72,11 @@ files:
 - README.md
 - Rakefile
 - lib/openfeature/sdk.rb
+- lib/openfeature/sdk/api.rb
+- lib/openfeature/sdk/client.rb
+- lib/openfeature/sdk/configuration.rb
+- lib/openfeature/sdk/metadata.rb
+- lib/openfeature/sdk/provider/no_op_provider.rb
 - lib/openfeature/sdk/version.rb
 - release-please-config.json
 - renovate.json
@@ -100,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.26
 signing_key: 
 specification_version: 4
 summary: OpenFeature SDK for Ruby