toggly 0.1.0

data/lib/toggly.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require_relative "toggly/version"
+require_relative "toggly/config"
+require_relative "toggly/context"
+require_relative "toggly/errors"
+require_relative "toggly/feature_definition"
+require_relative "toggly/evaluators/base"
+require_relative "toggly/evaluators/always_on"
+require_relative "toggly/evaluators/always_off"
+require_relative "toggly/evaluators/percentage"
+require_relative "toggly/evaluators/targeting"
+require_relative "toggly/evaluators/time_window"
+require_relative "toggly/evaluators/contextual_targeting"
+require_relative "toggly/registry"
+require_relative "toggly/evaluation_engine"
+require_relative "toggly/snapshot_providers/base"
+require_relative "toggly/snapshot_providers/memory"
+require_relative "toggly/snapshot_providers/file"
+require_relative "toggly/definitions_provider"
+require_relative "toggly/client"
+
+# Toggly - Feature Flag Management SDK for Ruby
+#
+# @example Basic usage
+#   client = Toggly::Client.new(
+#     app_key: "your-app-key",
+#     environment: "Production"
+#   )
+#
+#   if client.enabled?("my-feature")
+#     # Feature is enabled
+#   end
+#
+# @example With user context
+#   context = Toggly::Context.new(
+#     identity: "user-123",
+#     groups: ["beta-testers"],
+#     traits: { country: "US" }
+#   )
+#
+#   if client.enabled?("premium-feature", context: context)
+#     # Feature is enabled for this user
+#   end
+#
+# @example Offline mode with defaults
+#   client = Toggly::Client.new(
+#     defaults: {
+#       "feature-a" => true,
+#       "feature-b" => false
+#     }
+#   )
+module Toggly
+  class << self
+    # Global client instance
+    attr_accessor :client
+
+    # Configure and initialize the global client
+    #
+    # @yield [config] Configuration block
+    # @return [Client] The configured client
+    def configure
+      config = Config.new
+      yield(config) if block_given?
+      @client = Client.new(config)
+    end
+
+    # Check if a feature is enabled using the global client
+    #
+    # @param feature_key [String, Symbol] The feature key
+    # @param context [Context, nil] Optional evaluation context
+    # @return [Boolean]
+    def enabled?(feature_key, context: nil)
+      raise Error, "Toggly not configured. Call Toggly.configure first." unless @client
+
+      @client.enabled?(feature_key, context: context)
+    end
+
+    # Check if a feature is disabled using the global client
+    #
+    # @param feature_key [String, Symbol] The feature key
+    # @param context [Context, nil] Optional evaluation context
+    # @return [Boolean]
+    def disabled?(feature_key, context: nil)
+      !enabled?(feature_key, context: context)
+    end
+
+    # Reset the global client (mainly for testing)
+    def reset!
+      @client&.close
+      @client = nil
+    end
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: toggly
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ops.ai
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-03 00:00:00.000000000 Z
+dependencies: []
+description: High-performance Ruby SDK for Toggly feature flag management. Works with
+  or without Toggly.io.
+email:
+- support@ops.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/toggly.rb
+- lib/toggly/client.rb
+- lib/toggly/config.rb
+- lib/toggly/context.rb
+- lib/toggly/definitions_provider.rb
+- lib/toggly/errors.rb
+- lib/toggly/evaluation_engine.rb
+- lib/toggly/evaluators/always_off.rb
+- lib/toggly/evaluators/always_on.rb
+- lib/toggly/evaluators/base.rb
+- lib/toggly/evaluators/contextual_targeting.rb
+- lib/toggly/evaluators/percentage.rb
+- lib/toggly/evaluators/targeting.rb
+- lib/toggly/evaluators/time_window.rb
+- lib/toggly/feature_definition.rb
+- lib/toggly/registry.rb
+- lib/toggly/snapshot_providers/base.rb
+- lib/toggly/snapshot_providers/file.rb
+- lib/toggly/snapshot_providers/memory.rb
+- lib/toggly/version.rb
+homepage: https://toggly.io
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://toggly.io
+  source_code_uri: https://github.com/ops-ai/toggly-ruby
+  changelog_uri: https://github.com/ops-ai/toggly-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://docs.toggly.io/sdks/ruby
+  rubygems_mfa_required: 'true'
+  optional_dependencies: websocket-client-simple
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby SDK for Toggly feature flags
+test_files: []