configcat-openfeature-provider 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bed72c8e9d480f7f261be86b760a6328c2d30a37debbf2835f6f55e8eca8a6b7
+  data.tar.gz: 0af26ce4ad07589802f0dde75aa4f9be8b23d0345c4d84e60e608b23bf75bc41
+SHA512:
+  metadata.gz: 2a4c439d0849b523ddbd08228cde46f5e92747ea0936ad56d53598de61d352ccb5807a5cff04312b2f29c5aa92f6a367a3f32f7a8242bf55db267fcd385b5af5
+  data.tar.gz: d76022f65cbfd1f220ae452c0b1ffd48891a0be017d90f9ac9443f8c1ed5789483b5f3fdc6457767ec8ca97c53facf11c60983ff8903b15bcbbf1f284b2dc796

data/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @configcat/developers

data/.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+enable-beta-ecosystems: true
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

data/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [ '*' ]
+    paths-ignore:
+      - '**.md'
+  pull_request:
+    paths-ignore:
+      - '**.md'
+
+jobs:
+  standard:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+      - run: bundle install
+      - run: bundle exec rake standard
+
+  test:
+    runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      matrix:
+        ruby:
+          - "3.3"
+          - "3.2"
+          - "3.1"
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - run: bundle install
+      - run: bundle exec rspec

data/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish
+on:
+  push:
+    tags: [ 'v[0-9]+.[0-9]+.[0-9]+' ]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.2
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{ secrets.GEM_API_KEY }}"

data/.github/workflows/stale.yml

@@ -0,0 +1,12 @@
+name: Mark stale issues
+
+on:
+  schedule:
+  - cron: '0 1 * * *'
+
+  workflow_dispatch:
+
+jobs:
+  stale:
+    uses: configcat/.github/.github/workflows/stale.yml@master
+    secrets: inherit

data/.gitignore

@@ -0,0 +1,60 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*
+
+.idea
+
+.rspec_status

data/.rspec

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

data/.standard.yml

@@ -0,0 +1,5 @@
+parallel: true
+format: progress
+ruby_version: 3.1
+plugins:
+  - standard-performance

data/CHANGELOG.md

@@ -0,0 +1 @@
+Please check the [Github Releases](https://github.com/configcat/openfeature-ruby/releases) page for the changelog of the ConfigCat OpenFeature Provider for Ruby.

data/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing to the ConfigCat OpenFeature Provider for Ruby
+
+ConfigCat SDK is an open source project. Feedback and contribution are welcome. Contributions are made to this repo via Issues and Pull Requests.
+
+## Submitting bug reports and feature requests
+
+The ConfigCat SDK team monitors the [issue tracker](https://github.com/configcat/openfeature-ruby/issues) in the Provider repository. Bug reports and feature requests specific to this SDK should be filed in this issue tracker. The team will respond to all newly filed issues.
+
+## Submitting pull requests
+
+We encourage pull requests and other contributions from the community. 
+- Before submitting pull requests, ensure that all temporary or unintended code is removed.
+- Be accompanied by a complete Pull Request template (loaded automatically when a PR is created).
+- Add unit or integration tests for fixed or changed functionality.
+
+When you submit a pull request or otherwise seek to include your change in the repository, you waive all your intellectual property rights, including your copyright and patent claims for the submission. For more details please read the [contribution agreement](https://github.com/configcat/legal/blob/main/contribution-agreement.md).
+
+In general, we follow the ["fork-and-pull" Git workflow](https://github.com/susam/gitpr)
+
+1. Fork the repository to your own GitHub account
+2. Clone the project to your machine
+3. Create a branch locally with a succinct but descriptive name
+4. Commit changes to the branch
+5. Following any formatting and testing guidelines specific to this repo
+6. Push changes to your fork
+7. Open a PR in our repository and follow the PR template so that we can efficiently review the changes.
+
+## Build instructions
+
+This provider is built with [Bundler](https://bundler.io). To install Bundler, run `gem install bundler`.
+
+To install dependencies:
+
+```bash
+bundle install
+```
+
+## Running tests
+
+```bash
+bundle exec rspec spec
+```

data/Gemfile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+gemspec

data/Gemfile.lock

@@ -0,0 +1,90 @@
+PATH
+  remote: .
+  specs:
+    configcat-openfeature-provider (0.1.0)
+      configcat (~> 8.0.1)
+      openfeature-sdk (~> 0.4.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    concurrent-ruby (1.3.5)
+    configcat (8.0.1)
+      concurrent-ruby (~> 1.1)
+      semantic (~> 1.6)
+    diff-lcs (1.6.2)
+    json (2.12.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    openfeature-sdk (0.4.0)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    regexp_parser (2.10.0)
+    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.75.7)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.44.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    semantic (1.6.1)
+    standard (1.50.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.75.5)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.8.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.25.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  x64-mingw-ucrt
+
+DEPENDENCIES
+  configcat-openfeature-provider!
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  standard
+  standard-performance
+
+BUNDLED WITH
+   2.6.9

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ConfigCat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,60 @@
+# ConfigCat OpenFeature Provider for Ruby
+
+[![Build Status](https://github.com/configcat/openfeature-ruby/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/configcat/openfeature-ruby/actions/workflows/ci.yml)
+[![Gem version](https://badge.fury.io/rb/configcat-openfeature-provider.svg)](https://rubygems.org/gems/configcat-openfeature-provider)
+
+This repository contains an OpenFeature provider that allows [ConfigCat](https://configcat.com) to be used with the [OpenFeature Ruby SDK](https://github.com/open-feature/ruby-sdk).
+
+## Requirements
+- Ruby >= 3.1
+
+## Installation
+
+```sh
+gem install configcat-openfeature-provider
+```
+
+## Usage
+
+The initializer of `ConfigCat::OpenFeature::Provider` takes the SDK key and an optional `ConfigCat::ConfigCatOptions` argument containing the additional configuration options for the [ConfigCat Ruby SDK](https://github.com/configcat/ruby-sdk):
+
+```ruby
+require "configcat-openfeature-provider"
+
+# Configure the OpenFeature API with the ConfigCat provider.
+OpenFeature::SDK.configure do |config|
+  config.set_provider(ConfigCat::OpenFeature::Provider.new(
+    sdk_key: "<YOUR-CONFIGCAT-SDK-KEY>",
+    # Build options for the ConfigCat SDK.
+    options: ConfigCat::ConfigCatOptions.new(
+      polling_mode: ConfigCat::PollingMode.auto_poll,
+      offline: false
+    )))
+end
+
+# Create a client.
+client = OpenFeature::SDK.build_client
+
+# Evaluate feature flag.
+flag_value = client.fetch_boolean_value(
+  flag_key: "isMyAwesomeFeatureEnabled",
+  default_value: false
+)
+```
+
+For more information about all the configuration options, see the [Ruby SDK documentation](https://configcat.com/docs/sdk-reference/ruby/#creating-the-configcat-client).
+
+## Need help?
+https://configcat.com/support
+
+## Contributing
+Contributions are welcome. For more info please read the [Contribution Guideline](CONTRIBUTING.md).
+
+## About ConfigCat
+ConfigCat is a feature flag and configuration management service that lets you separate releases from deployments. You can turn your features ON/OFF using <a href="https://app.configcat.com" target="_blank">ConfigCat Dashboard</a> even after they are deployed. ConfigCat lets you target specific groups of users based on region, email or any other custom user attribute.
+
+ConfigCat is a <a href="https://configcat.com" target="_blank">hosted feature flag service</a>. Manage feature toggles across frontend, backend, mobile, desktop apps. <a href="https://configcat.com" target="_blank">Alternative to LaunchDarkly</a>. Management app + feature flag SDKs.
+
+- [Official ConfigCat SDKs for other platforms](https://github.com/configcat)
+- [Documentation](https://configcat.com/docs)
+- [Blog](https://configcat.com/blog)

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/configcat-openfeature-provider.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/configcat-openfeature-provider/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "configcat-openfeature-provider"
+  spec.version = ConfigCat::OpenFeature::VERSION
+  spec.authors = ["ConfigCat"]
+  spec.email = ["developer@configcat.com"]
+  spec.licenses = ["MIT"]
+
+  spec.summary = "ConfigCat OpenFeature Provider for Ruby."
+  spec.description = "OpenFeature Provider that allows ConfigCat to be used with the OpenFeature Ruby SDK."
+
+  spec.homepage = "https://configcat.com"
+
+  spec.required_ruby_version = ">= 3.1"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/configcat/openfeature-ruby"
+  spec.metadata["changelog_uri"] = "https://github.com/configcat/openfeature-ruby/blob/main/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/configcat/openfeature-ruby/issues"
+  spec.metadata["documentation_uri"] = "https://configcat.com/docs/sdk-reference/openfeature/ruby"
+
+  # 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_dependency "configcat", "~> 8.0.1"
+  spec.add_dependency "openfeature-sdk", "~> 0.4.0"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "standard"
+  spec.add_development_dependency "standard-performance"
+end

data/lib/configcat-openfeature-provider/provider.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+require "open_feature/sdk"
+require "configcat"
+
+module ConfigCat
+  module OpenFeature
+    class Provider
+      PROVIDER_NAME = "ConfigCatProvider"
+      attr_reader :metadata
+
+      def initialize(sdk_key:, options: ConfigCatOptions.new)
+        @metadata = ::OpenFeature::SDK::Provider::ProviderMetadata.new(name: PROVIDER_NAME)
+        @client = ConfigCatClient.get(sdk_key, options)
+      end
+
+      def fetch_boolean_value(flag_key:, default_value:, evaluation_context: nil)
+        user = ctx_to_user(evaluation_context)
+        evaluation_detail = @client.get_value_details(flag_key, default_value, user)
+
+        unless [true, false].include?(evaluation_detail.value)
+          return type_mismatch(default_value)
+        end
+
+        produce_result(evaluation_detail, default_value)
+      end
+
+      def fetch_string_value(flag_key:, default_value:, evaluation_context: nil)
+        user = ctx_to_user(evaluation_context)
+        evaluation_detail = @client.get_value_details(flag_key, default_value, user)
+
+        unless evaluation_detail.value.is_a?(String)
+          return type_mismatch(default_value)
+        end
+
+        produce_result(evaluation_detail, default_value)
+      end
+
+      def fetch_number_value(flag_key:, default_value:, evaluation_context: nil)
+        user = ctx_to_user(evaluation_context)
+        evaluation_detail = @client.get_value_details(flag_key, default_value, user)
+
+        unless evaluation_detail.value.is_a?(Numeric)
+          return type_mismatch(default_value)
+        end
+
+        produce_numeric_result(evaluation_detail, default_value, Numeric)
+      end
+
+      def fetch_integer_value(flag_key:, default_value:, evaluation_context: nil)
+        user = ctx_to_user(evaluation_context)
+        evaluation_detail = @client.get_value_details(flag_key, default_value, user)
+
+        unless evaluation_detail.value.is_a?(Numeric)
+          return type_mismatch(default_value)
+        end
+
+        produce_numeric_result(evaluation_detail, default_value, Integer)
+      end
+
+      def fetch_float_value(flag_key:, default_value:, evaluation_context: nil)
+        user = ctx_to_user(evaluation_context)
+        evaluation_detail = @client.get_value_details(flag_key, default_value, user)
+
+        unless evaluation_detail.value.is_a?(Numeric)
+          return type_mismatch(default_value)
+        end
+
+        produce_numeric_result(evaluation_detail, default_value, Float)
+      end
+
+      def fetch_object_value(flag_key:, default_value:, evaluation_context: nil)
+        user = ctx_to_user(evaluation_context)
+        evaluation_detail = @client.get_value_details(flag_key, "", user)
+
+        unless evaluation_detail.value.is_a?(String)
+          return type_mismatch(default_value)
+        end
+
+        result = produce_result(evaluation_detail, default_value)
+        begin
+          result.value = JSON.parse(result.value)
+        rescue JSON::ParserError, TypeError
+          return ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            error_code: ::OpenFeature::SDK::Provider::ErrorCode::TYPE_MISMATCH,
+            error_message: "Could not parse '#{result.value}' as JSON",
+            reason: ::OpenFeature::SDK::Provider::Reason::ERROR
+          )
+        end
+        result
+      end
+
+      # @param evaluation_context [::OpenFeature::SDK::EvaluationContext, nil]
+      #
+      # @return [ConfigCat::User, nil]
+      private def ctx_to_user(evaluation_context)
+        if evaluation_context.nil? || evaluation_context.fields.nil? || evaluation_context.fields.empty?
+          return nil
+        end
+
+        email = evaluation_context.field("Email")
+        country = evaluation_context.field("Country")
+
+        ConfigCat::User.new(evaluation_context.targeting_key, email: email, country: country, custom: evaluation_context.fields)
+      end
+
+      private def type_mismatch(default_value)
+        ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+          value: default_value,
+          reason: ::OpenFeature::SDK::Provider::Reason::ERROR,
+          error_code: ::OpenFeature::SDK::Provider::ErrorCode::TYPE_MISMATCH
+        )
+      end
+
+      # @param evaluation_detail [ConfigCat::EvaluationDetails]
+      # @param default_value [any]
+      #
+      # @return [::OpenFeature::SDK::ResolutionDetails]
+      private def produce_result(evaluation_detail, default_value)
+        unless evaluation_detail.error.nil?
+          error_code = evaluation_detail.error.include?("key was not found in config JSON") ? ::OpenFeature::SDK::Provider::ErrorCode::FLAG_NOT_FOUND : ::OpenFeature::SDK::Provider::ErrorCode::GENERAL
+          return ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+            value: default_value,
+            reason: ::OpenFeature::SDK::Provider::Reason::ERROR,
+            error_code: error_code,
+            error_message: evaluation_detail.error
+          )
+        end
+
+        ::OpenFeature::SDK::Provider::ResolutionDetails.new(
+          value: evaluation_detail.value,
+          variant: evaluation_detail.variation_id,
+          reason: produce_reason(evaluation_detail)
+        )
+      end
+
+      # @param evaluation_detail [ConfigCat::EvaluationDetails]
+      # @param default_value [any]
+      #
+      # @return [::OpenFeature::SDK::ResolutionDetails]
+      private def produce_numeric_result(evaluation_detail, default_value, type)
+        result = produce_result(evaluation_detail, default_value)
+        unless result.error_code.nil?
+          return result
+        end
+
+        if type == Integer
+          result.value = result.value.to_i
+        elsif type == Float
+          result.value = result.value.to_f
+        end
+
+        result
+      end
+
+      # @param evaluation_detail [ConfigCat::EvaluationDetails]
+      #
+      # @return [String]
+      private def produce_reason(evaluation_detail)
+        unless evaluation_detail.error.nil?
+          return ::OpenFeature::SDK::Provider::Reason::ERROR
+        end
+
+        if !evaluation_detail.matched_targeting_rule.nil? || !evaluation_detail.matched_percentage_option.nil?
+          return ::OpenFeature::SDK::Provider::Reason::TARGETING_MATCH
+        end
+
+        ::OpenFeature::SDK::Provider::Reason::DEFAULT
+      end
+    end
+  end
+end

data/lib/configcat-openfeature-provider/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module ConfigCat
+  module OpenFeature
+    VERSION = "0.1.0"
+  end
+end

data/lib/configcat-openfeature-provider.rb

@@ -0,0 +1,7 @@
+require_relative "configcat-openfeature-provider/provider"
+require_relative "configcat-openfeature-provider/version"
+
+module ConfigCat
+  module OpenFeature
+  end
+end

data/samples/provider-sample/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem "configcat-openfeature-provider", path: "../../../"

data/samples/provider-sample/Gemfile.lock

@@ -0,0 +1,25 @@
+PATH
+  remote: ../../..
+  specs:
+    configcat (8.0.1)
+      concurrent-ruby (~> 1.1)
+      semantic (~> 1.6)
+    configcat-openfeature-provider (0.1.0)
+      configcat (~> 8.0.1)
+      openfeature-sdk (~> 0.4.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    concurrent-ruby (1.3.5)
+    openfeature-sdk (0.4.0)
+    semantic (1.6.1)
+
+PLATFORMS
+  x64-mingw-ucrt
+
+DEPENDENCIES
+  configcat-openfeature-provider!
+
+BUNDLED WITH
+   2.6.9

data/samples/provider-sample/main.rb

@@ -0,0 +1,38 @@
+require "configcat-openfeature-provider"
+require "date"
+
+# Info level logging helps to inspect the feature flag evaluation process.
+# Use the default Warning level to avoid too detailed logging in your application.
+ConfigCat.logger.level = Logger::INFO
+
+# Configure the OpenFeature API with the ConfigCat provider.
+OpenFeature::SDK.configure do |config|
+  config.set_provider(ConfigCat::OpenFeature::Provider.new(
+    sdk_key: "PKDVCLf-Hq-h-kCzMp-L7Q/HhOWfwVtZ0mb30i9wi17GQ",
+    # Configure the ConfigCat SDK.
+    options: ConfigCat::ConfigCatOptions.new(
+      polling_mode: ConfigCat::PollingMode.auto_poll,
+      offline: false
+    )
+  ))
+end
+
+# Create a client.
+client = OpenFeature::SDK.build_client
+
+# Create evaluation context.
+evaluation_context = OpenFeature::SDK::EvaluationContext.new(
+  OpenFeature::SDK::EvaluationContext::TARGETING_KEY => "<SOME USERID>",
+  "Email" => "configcat@example.com",
+  "Country" => "CountryID",
+  "Version" => "1.0.0"
+)
+
+# Evaluate feature flag.
+flag_details = client.fetch_boolean_details(
+  flag_key: "isPOCFeatureEnabled",
+  default_value: false,
+  evaluation_context: evaluation_context
+)
+
+puts(JSON.dump(flag_details))

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: configcat-openfeature-provider
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ConfigCat
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: configcat
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.0.1
+- !ruby/object:Gem::Dependency
+  name: openfeature-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !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'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !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: standard-performance
+  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: OpenFeature Provider that allows ConfigCat to be used with the OpenFeature
+  Ruby SDK.
+email:
+- developer@configcat.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/CODEOWNERS"
+- ".github/dependabot.yml"
+- ".github/workflows/ci.yml"
+- ".github/workflows/publish.yml"
+- ".github/workflows/stale.yml"
+- ".gitignore"
+- ".rspec"
+- ".standard.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- configcat-openfeature-provider.gemspec
+- lib/configcat-openfeature-provider.rb
+- lib/configcat-openfeature-provider/provider.rb
+- lib/configcat-openfeature-provider/version.rb
+- samples/provider-sample/Gemfile
+- samples/provider-sample/Gemfile.lock
+- samples/provider-sample/main.rb
+homepage: https://configcat.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://configcat.com
+  source_code_uri: https://github.com/configcat/openfeature-ruby
+  changelog_uri: https://github.com/configcat/openfeature-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/configcat/openfeature-ruby/issues
+  documentation_uri: https://configcat.com/docs/sdk-reference/openfeature/ruby
+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.4.19
+signing_key:
+specification_version: 4
+summary: ConfigCat OpenFeature Provider for Ruby.
+test_files: []