openfeature-go-feature-flag-provider 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '018d25337f3d0990a16a6cf08353de44d09e149a86ee51662849fd0ddffcf15f'
+  data.tar.gz: 4676ffdfbd26b433536effd5ac1ee9fc7de7dcd8db684354014cccbe4ce44eed
+SHA512:
+  metadata.gz: 0ad10200eaf42b42c939c7b714148612932f18ff624274b9738256ae2ca0b021c66cbe6d895ce406da6d18cd1b6da0ae975ee77a28cefff43f5e4e904b4510d1
+  data.tar.gz: d6689dbcb9d1f87201b83b261fc36ca4557977bd27005fe18b2953455717dc1b2bc5cd0f23858fad8d5e338aae417276778370abbe04af633c975ad938f79274

data/.rubocop.yml

@@ -0,0 +1,5 @@
+inherit_from: ../../shared_config/.rubocop.yml
+
+inherit_mode:
+  merge:
+    - Exclude

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [0.1.1](https://github.com/open-feature/ruby-sdk-contrib/compare/openfeature-go-feature-flag-provider-v0.1.0...openfeature-go-feature-flag-provider/v0.1.1) (2024-08-13)
+
+
+### ✨ New Features
+
+* new GO Feature Flag ruby provider ([#38](https://github.com/open-feature/ruby-sdk-contrib/issues/38)) ([a0bbf53](https://github.com/open-feature/ruby-sdk-contrib/commit/a0bbf535da324279b18577f71ffaa05d4f2fdced))

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,114 @@
+PATH
+  remote: .
+  specs:
+    openfeature-go-feature-flag-provider (0.1.1)
+      faraday (~> 2.10.1)
+      openfeature-sdk (~> 0.3.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    ast (2.4.2)
+    bigdecimal (3.1.8)
+    crack (1.0.0)
+      bigdecimal
+      rexml
+    diff-lcs (1.5.1)
+    docile (1.4.1)
+    faraday (2.10.1)
+      faraday-net_http (>= 2.0, < 3.2)
+      logger
+    faraday-net_http (3.1.1)
+      net-http
+    hashdiff (1.1.1)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    logger (1.6.0)
+    net-http (0.4.1)
+      uri
+    openfeature-sdk (0.3.1)
+    parallel (1.24.0)
+    parser (3.3.0.5)
+      ast (~> 2.4.1)
+      racc
+    public_suffix (6.0.1)
+    racc (1.7.3)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    regexp_parser (2.9.0)
+    rexml (3.3.4)
+      strscan
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.3)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.2)
+    rubocop (1.62.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.2)
+      parser (>= 3.3.0.4)
+    rubocop-performance (1.20.2)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    standard (1.35.1)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.62.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.3)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.3.1)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.20.2)
+    strscan (3.1.0)
+    unicode-display_width (2.5.0)
+    uri (0.13.0)
+    webmock (3.23.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  arm64-darwin-23
+  ruby
+
+DEPENDENCIES
+  openfeature-go-feature-flag-provider!
+  rake (~> 13.0)
+  rspec (~> 3.12.0)
+  rubocop
+  simplecov
+  standard
+  webmock
+
+BUNDLED WITH
+   2.5.11

data/README.md

@@ -0,0 +1,128 @@
+<p align="center">
+  <img width="400" src="https://raw.githubusercontent.com/thomaspoignant/go-feature-flag/main/gofeatureflag.svg" alt="go-feature-flag logo" />
+
+</p>
+
+# GO Feature Flag - OpenFeature Ruby provider
+<p align="center">
+   <a href="https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-go-feature-flag-provider"><img src="https://img.shields.io/gem/v/openfeature-go-feature-flag-provider?color=blue&style=flat-square&logo=ruby" alt="gem"></a>
+   <a href="https://gofeatureflag.org/"><img src="https://img.shields.io/badge/%F0%9F%93%92-Website-blue" alt="Documentation"></a>
+   <a href="https://github.com/thomaspoignant/go-feature-flag/issues"><img src="https://img.shields.io/badge/%E2%9C%8F%EF%B8%8F-issues-red" alt="Issues"></a>
+   <a href="https://gofeatureflag.org/slack"><img src="https://img.shields.io/badge/join-us%20on%20slack-gray.svg?longCache=true&logo=slack&colorB=green" alt="Join us on slack"></a>
+</p>
+
+This repository contains the official Ruby OpenFeature provider for accessing your feature flags with [GO Feature Flag](https://gofeatureflag.org).
+
+In conjunction with the [OpenFeature SDK](https://openfeature.dev/docs/reference/concepts/provider) you will be able
+to evaluate your feature flags in your Ruby applications.
+
+For documentation related to flags management in GO Feature Flag,
+refer to the [GO Feature Flag documentation website](https://gofeatureflag.org/docs).
+
+### Functionalities:
+- Manage the integration of the OpenFeature Ruby SDK and GO Feature Flag relay-proxy.
+
+## Dependency Setup
+
+### Gem Package Manager
+
+Add this line to your application's Gemfile:
+```
+gem 'openfeature-go-feature-flag-provider'
+```
+And then execute:
+```
+bundle install
+```
+Or install it yourself as:
+```
+gem install openfeature-go-feature-flag-provider
+```
+
+## Getting started
+
+### Initialize the provider
+
+The `OpenFeature::GoFeatureFlag::Provider` needs some options to be created and then set in the OpenFeature SDK.
+
+| **Option** | **Description**                                                                                                                             |
+|------------|---------------------------------------------------------------------------------------------------------------------------------------------|
+| `endpoint` | **(mandatory)** The URL to access to the relay-proxy.<br />*(example: `https://relay.proxy.gofeatureflag.org/`)*                            |
+| `headers`  | A `Hash` object containing the headers to send to the relay-proxy.<br/>*(example to send APIKey: `{"Authorization" => "Bearer my-api-key"}` |
+
+The only required option to create a `GoFeatureFlagProvider` is the URL _(`endpoint`)_ to your GO Feature Flag relay-proxy instance.
+
+```ruby
+options = OpenFeature::GoFeatureFlag::Options.new(endpoint: "http://localhost:1031")
+provider = OpenFeature::GoFeatureFlag::Provider.new(options:)
+
+evaluation_context = OpenFeature::SDK::EvaluationContext.new(targeting_key: "9b9450f8-ab5c-4dcf-872f-feda3f6ccb16")
+
+OpenFeature::SDK.configure do |config|
+   config.set_provider(provider)
+end
+client = OpenFeature::SDK.build_client
+
+bool_value = client.fetch_boolean_value(
+  flag_key: "my-boolean-flag",
+  default_value: false,
+  evaluation_context:
+)
+
+if bool_value 
+  puts "The flag is enabled"
+else
+  puts "The flag is disabled"
+end
+```
+
+The evaluation context is the way for the client to specify contextual data that GO Feature Flag uses to evaluate the feature flags, it allows to define rules on the flag.
+
+The `targeting_key` is mandatory for GO Feature Flag to evaluate the feature flag, it could be the id of a user, a session ID or anything you find relevant to use as identifier during the evaluation.
+
+
+### Evaluate a feature flag
+The client is used to retrieve values for the current `EvaluationContext`. 
+For example, retrieving a boolean value for the flag **"my-flag"**:
+
+```ruby
+client = OpenFeature::SDK.build_client
+
+bool_value = client.fetch_boolean_value(
+  flag_key: "my-boolean-flag",
+  default_value: false,
+  evaluation_context: evaluation_context
+)
+```
+
+GO Feature Flag supports different all OpenFeature supported types of feature flags, it means that you can use all the accessor directly
+```ruby
+# Bool
+client.fetch_boolean_value(flag_key: 'my-flag', default_value: false, evaluation_context:)
+
+# String
+client.fetch_string_value(flag_key: 'my-flag', default_value: "default", evaluation_context:)
+
+# Number
+client.fetch_number_value(flag_key: 'my-flag', default_value: 0, evaluation_context:)
+
+# Object
+client.fetch_object_value(flag_key: 'my-flag', default_value: {"default" => true}, evaluation_context:)
+```
+
+## Features status
+
+| Status | Feature         | Description                                                                |
+|--------|-----------------|----------------------------------------------------------------------------|
+| ✅      | Flag evaluation | It is possible to evaluate all the type of flags                           |
+| ❌      | Caching         | Mechanism is in place to refresh the cache in case of configuration change |
+| ❌      | Event Streaming | Not supported by the SDK                                                   |
+| ❌      | Logging         | Not supported by the SDK                                                   |
+| ✅      | Flag Metadata   | You can retrieve your flag metadata directly in the evaluation details.    |
+
+
+<sub>**Implemented**: ✅ | In-progress: ⚠️ | Not implemented yet: ❌</sub>
+
+## Contributing
+This project welcomes contributions from the community.
+If you're interested in contributing, see the [contributors' guide](https://github.com/thomaspoignant/go-feature-flag/blob/main/CONTRIBUTING.md) for some helpful tips.

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+task default: %i[standard spec]

data/bin/rake

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/lib/openfeature/go-feature-flag/error/errors.rb

@@ -0,0 +1,76 @@
+# Define a custom error class
+require "open_feature/sdk/provider/error_code"
+
+module OpenFeature
+  module GoFeatureFlag
+    class FlagNotFoundError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response, flag_key)
+        error_message = "Flag not found: #{flag_key}"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::FLAG_NOT_FOUND
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class InternalServerError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "Internal Server Error"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::GENERAL
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class InvalidOptionError < StandardError
+      attr_reader :error_code, :error_message
+
+      def initialize(error_code, error_message)
+        @error_code = error_code
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class UnauthorizedError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "unauthorized"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::GENERAL
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class ParseError < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = "Parse error"
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::PARSE_ERROR
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+
+    class RateLimited < StandardError
+      attr_reader :response, :error_code, :error_message
+
+      def initialize(response)
+        error_message = response.nil? ? "Rate limited" : "Rate limited: " + response["Retry-After"].to_s
+        @response = response
+        @error_code = SDK::Provider::ErrorCode::GENERAL
+        @error_message = error_message
+        super(error_message)
+      end
+    end
+  end
+end

data/lib/openfeature/go-feature-flag/go_feature_flag_provider.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module OpenFeature
+  module GoFeatureFlag
+    # This class is the entry point for the GoFeatureFlagProvider
+    class Provider
+      PROVIDER_NAME = "GO Feature Flag Provider"
+      attr_reader :metadata, :options
+
+      def initialize(options: Options.new)
+        @metadata = SDK::Provider::ProviderMetadata.new(name: PROVIDER_NAME)
+        @options = options
+        @goff_api = GoFeatureFlagApi.new(options: options)
+      end
+
+      def fetch_boolean_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [TrueClass, FalseClass])
+      end
+
+      def fetch_string_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [String])
+      end
+
+      def fetch_number_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [Integer, Float])
+      end
+
+      def fetch_object_value(flag_key:, default_value:, evaluation_context: nil)
+        evaluate(flag_key: flag_key, default_value: default_value, evaluation_context: evaluation_context, allowed_classes: [Array, Hash])
+      end
+
+      private
+
+      def evaluate(flag_key:, default_value:, allowed_classes:, evaluation_context: nil)
+        evaluation_context = OpenFeature::SDK::EvaluationContext.new if evaluation_context.nil?
+        validate_parameters(flag_key, evaluation_context)
+
+        # do a http call to the go feature flag server
+        parsed_response = @goff_api.evaluate_ofrep_api(flag_key: flag_key, evaluation_context: evaluation_context)
+        parsed_response = OfrepApiResponse unless parsed_response.is_a?(OfrepApiResponse)
+
+        if parsed_response.has_error?
+          return SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            error_code: parsed_response.error_code,
+            error_message: parsed_response.error_details,
+            reason: parsed_response.reason
+          )
+        end
+
+        unless allowed_classes.include?(parsed_response.value.class)
+          return SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            error_code: SDK::Provider::ErrorCode::TYPE_MISMATCH,
+            error_message: "flag type #{parsed_response.value.class} does not match allowed types #{allowed_classes}",
+            reason: SDK::Provider::Reason::ERROR
+          )
+        end
+
+        SDK::Provider::ResolutionDetails.new(
+          value: parsed_response.value,
+          reason: parsed_response.reason,
+          variant: parsed_response.variant,
+          flag_metadata: parsed_response.metadata
+        )
+      rescue UnauthorizedError,
+        InvalidOptionError,
+        FlagNotFoundError,
+        InternalServerError => e
+        SDK::Provider::ResolutionDetails.new(
+          value: default_value,
+          error_code: e.error_code,
+          error_message: e.error_message,
+          reason: SDK::Provider::Reason::ERROR
+        )
+      end
+
+      def validate_parameters(flag_key, evaluation_context)
+        if evaluation_context.nil? || evaluation_context.targeting_key.nil? || evaluation_context.targeting_key.empty?
+          raise InvalidOptionError.new(SDK::Provider::ErrorCode::INVALID_CONTEXT, "invalid evaluation context provided")
+        end
+
+        if flag_key.nil? || flag_key.empty?
+          raise InvalidOptionError.new(SDK::Provider::ErrorCode::GENERAL, "invalid flag key provided")
+        end
+      end
+    end
+  end
+end

data/lib/openfeature/go-feature-flag/goff_api.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require "open_feature/sdk"
+require "net/http"
+require "json"
+require "faraday"
+require_relative "error/errors"
+require_relative "model/ofrep_api_response"
+
+module OpenFeature
+  module GoFeatureFlag
+    # This class is the entry point for the GoFeatureFlagProvider
+    class GoFeatureFlagApi
+      attr_reader :options
+      def initialize(options: {})
+        @options = options
+        @faraday_connection = Faraday.new(
+          url: @options.endpoint,
+          headers: {"Content-Type" => "application/json"}.merge(@options.custom_headers || {})
+        )
+      end
+
+      def evaluate_ofrep_api(flag_key:, evaluation_context:)
+        unless @retry_after.nil?
+          if Time.now < @retry_after
+            raise OpenFeature::GoFeatureFlag::RateLimited.new(nil)
+          else
+            @retry_after = nil
+          end
+        end
+
+        evaluation_context = OpenFeature::SDK::EvaluationContext.new if evaluation_context.nil?
+        # replace targeting_key by targetingKey
+        evaluation_context.fields["targetingKey"] = evaluation_context.targeting_key
+        evaluation_context.fields.delete("targeting_key")
+
+        response = @faraday_connection.post("/ofrep/v1/evaluate/flags/#{flag_key}") do |req|
+          req.body = {context: evaluation_context.fields}.to_json
+        end
+
+        case response.status
+        when 200
+          parse_success_response(response)
+        when 400
+          parse_error_response(response)
+        when 401, 403
+          raise OpenFeature::GoFeatureFlag::UnauthorizedError.new(response)
+        when 404
+          raise OpenFeature::GoFeatureFlag::FlagNotFoundError.new(response, flag_key)
+        when 429
+          parse_retry_later_header(response)
+          raise OpenFeature::GoFeatureFlag::RateLimited.new(response)
+        else
+          raise OpenFeature::GoFeatureFlag::InternalServerError.new(response)
+        end
+      end
+
+      private
+
+      def parse_error_response(response)
+        required_keys = %w[key error_code]
+        parsed = JSON.parse(response.body)
+
+        missing_keys = required_keys - parsed.keys
+        unless missing_keys.empty?
+          raise OpenFeature::GoFeatureFlag::ParseError.new(response)
+        end
+
+        OpenFeature::GoFeatureFlag::OfrepApiResponse.new(
+          value: nil,
+          key: parsed["key"],
+          reason: SDK::Provider::Reason::ERROR,
+          variant: nil,
+          error_code: error_code_mapper(parsed["error_code"]),
+          error_details: parsed["error_details"],
+          metadata: nil
+        )
+      end
+
+      def parse_success_response(response)
+        required_keys = %w[key value reason variant]
+        parsed = JSON.parse(response.body)
+
+        missing_keys = required_keys - parsed.keys
+        unless missing_keys.empty?
+          raise OpenFeature::GoFeatureFlag::ParseError.new(response)
+        end
+
+        OpenFeature::GoFeatureFlag::OfrepApiResponse.new(
+          value: parsed["value"],
+          key: parsed["key"],
+          reason: reason_mapper(parsed["reason"]),
+          variant: parsed["variant"],
+          error_code: nil,
+          error_details: nil,
+          metadata: parsed["metadata"]
+        )
+      end
+
+      def reason_mapper(reason_str)
+        reason_str = reason_str.upcase
+        reason_map = {
+          "STATIC" => SDK::Provider::Reason::STATIC,
+          "DEFAULT" => SDK::Provider::Reason::DEFAULT,
+          "TARGETING_MATCH" => SDK::Provider::Reason::TARGETING_MATCH,
+          "SPLIT" => SDK::Provider::Reason::SPLIT,
+          "CACHED" => SDK::Provider::Reason::CACHED,
+          "DISABLED" => SDK::Provider::Reason::DISABLED,
+          "UNKNOWN" => SDK::Provider::Reason::UNKNOWN,
+          "STALE" => SDK::Provider::Reason::STALE,
+          "ERROR" => SDK::Provider::Reason::ERROR
+        }
+        reason_map[reason_str] || SDK::Provider::Reason::UNKNOWN
+      end
+
+      def error_code_mapper(error_code_str)
+        error_code_str = error_code_str.upcase
+        error_code_map = {
+          "PROVIDER_NOT_READY" => SDK::Provider::ErrorCode::PROVIDER_NOT_READY,
+          "FLAG_NOT_FOUND" => SDK::Provider::ErrorCode::FLAG_NOT_FOUND,
+          "PARSE_ERROR" => SDK::Provider::ErrorCode::PARSE_ERROR,
+          "TYPE_MISMATCH" => SDK::Provider::ErrorCode::TYPE_MISMATCH,
+          "TARGETING_KEY_MISSING" => SDK::Provider::ErrorCode::TARGETING_KEY_MISSING,
+          "INVALID_CONTEXT" => SDK::Provider::ErrorCode::INVALID_CONTEXT,
+          "GENERAL" => SDK::Provider::ErrorCode::GENERAL
+        }
+        error_code_map[error_code_str] || SDK::Provider::ErrorCode::GENERAL
+      end
+
+      def parse_retry_later_header(response)
+        retry_after = response["Retry-After"]
+        return nil if retry_after.nil?
+
+        begin
+          @retry_after = if /^\d+$/.match?(retry_after)
+            # Retry-After is in seconds
+            Time.now + Integer(retry_after)
+          else
+            # Retry-After is an HTTP-date
+            Time.httpdate(retry_after)
+          end
+        rescue ArgumentError
+          # ignore invalid Retry-After header
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/openfeature/go-feature-flag/model/ofrep_api_response.rb

@@ -0,0 +1,32 @@
+module OpenFeature
+  module GoFeatureFlag
+    class OfrepApiResponse
+      attr_reader :value, :key, :reason, :variant, :error_code, :error_details, :metadata
+
+      def initialize(value:, key:, reason:, variant:, error_code:, error_details:, metadata:)
+        @value = value
+        @key = key
+        @reason = reason
+        @variant = variant
+        @error_code = error_code
+        @error_details = error_details
+        @metadata = metadata
+      end
+
+      def has_error?
+        !@error_code.nil? && !@error_code.empty?
+      end
+
+      def eql?(other)
+        return false unless other.is_a?(OpenFeature::GoFeatureFlag::OfrepApiResponse)
+        key == other.key &&
+          value == other.value &&
+          reason == other.reason &&
+          variant == other.variant &&
+          error_code == other.error_code &&
+          error_details == other.error_details &&
+          metadata == other.metadata
+      end
+    end
+  end
+end

data/lib/openfeature/go-feature-flag/options.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module OpenFeature
+  module GoFeatureFlag
+    # This class is the configuration class for the GoFeatureFlagProvider
+    class Options
+      attr_accessor :endpoint, :custom_headers
+
+      def initialize(endpoint: nil, headers: {})
+        validate_endpoint(endpoint: endpoint)
+        @endpoint = endpoint
+        @custom_headers = headers
+      end
+
+      private
+
+      def validate_endpoint(endpoint: nil)
+        return if endpoint.nil?
+
+        uri = URI.parse(endpoint)
+        raise ArgumentError, "Invalid URL for endpoint: #{endpoint}" unless uri.is_a?(URI::HTTP) || uri.is_a?(URI::HTTPS)
+      rescue URI::InvalidURIError
+        raise ArgumentError, "Invalid URL for endpoint: #{endpoint}"
+      end
+    end
+  end
+end

data/lib/openfeature/go-feature-flag/version.rb

@@ -0,0 +1,5 @@
+module OpenFeature
+  module GoFeatureFlag
+    GO_FEATURE_FLAG_PROVIDER_VERSION = "0.1.1"
+  end
+end

data/openfeature-go-feature-flag-provider.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/openfeature/go-feature-flag/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "openfeature-go-feature-flag-provider"
+  spec.version = OpenFeature::GoFeatureFlag::GO_FEATURE_FLAG_PROVIDER_VERSION
+  spec.authors = ["Thomas Poignant"]
+  spec.email = ["contact@gofeatureflag.org"]
+
+  spec.summary = "The GO Feature Flag provider for the OpenFeature Ruby SDK"
+  spec.description = "The GO Feature Flag provider for the OpenFeature Ruby SDK"
+  spec.homepage = "https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-go-feature-flag-provider"
+  spec.license = "Apache-2.0"
+  spec.required_ruby_version = ">= 3.1"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-go-feature-flag-provider"
+  spec.metadata["changelog_uri"] = "https://github.com/open-feature/ruby-sdk-contrib/blob/main/providers/openfeature-go-feature-flag-provider/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/thomaspoignant/go-feature-flag/issues/new/choose"
+  spec.metadata["documentation_uri"] = "https://gofeatureflag.org/docs"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "openfeature-sdk", "~> 0.3.1"
+  spec.add_runtime_dependency "faraday", "~> 2.10.1"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.12.0"
+  spec.add_development_dependency "standard"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "webmock"
+end

metadata

@@ -0,0 +1,174 @@
+--- !ruby/object:Gem::Specification
+name: openfeature-go-feature-flag-provider
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Thomas Poignant
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2024-08-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: openfeature-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.1
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.12.0
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The GO Feature Flag provider for the OpenFeature Ruby SDK
+email:
+- contact@gofeatureflag.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/rake
+- lib/openfeature/go-feature-flag/error/errors.rb
+- lib/openfeature/go-feature-flag/go_feature_flag_provider.rb
+- lib/openfeature/go-feature-flag/goff_api.rb
+- lib/openfeature/go-feature-flag/model/ofrep_api_response.rb
+- lib/openfeature/go-feature-flag/options.rb
+- lib/openfeature/go-feature-flag/version.rb
+- openfeature-go-feature-flag-provider.gemspec
+homepage: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-go-feature-flag-provider
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-go-feature-flag-provider
+  source_code_uri: https://github.com/open-feature/ruby-sdk-contrib/tree/main/providers/openfeature-go-feature-flag-provider
+  changelog_uri: https://github.com/open-feature/ruby-sdk-contrib/blob/main/providers/openfeature-go-feature-flag-provider/CHANGELOG.md
+  bug_tracker_uri: https://github.com/thomaspoignant/go-feature-flag/issues/new/choose
+  documentation_uri: https://gofeatureflag.org/docs
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key: 
+specification_version: 4
+summary: The GO Feature Flag provider for the OpenFeature Ruby SDK
+test_files: []