ToggleCraft Ruby SDK

gem 'togglecraft'

require 'togglecraft'

# Initialize client
client = ToggleCraft::Client.new(sdk_key: 'your-sdk-key')

# Connect and wait for flags
client.connect
client.wait_for_ready

# Use your flags
if client.enabled?('new-feature', user: { id: current_user.id })
  # Feature is enabled
end

# config/initializers/togglecraft.rb
Rails.application.config.togglecraft = ToggleCraft::Client.new(
  sdk_key: ENV['TOGGLECRAFT_SDK_KEY'],
  cache_adapter: :memory,
  logger: Rails.logger,
  debug: Rails.env.development?
)

Rails.application.config.togglecraft.connect

at_exit do
  Rails.application.config.togglecraft.destroy
end

class DashboardController < ApplicationController
  def index
    if togglecraft.enabled?('premium-dashboard', user: { id: current_user.id })
      render :premium
    else
      render :standard
    end
  end

  private

  def togglecraft
    Rails.application.config.togglecraft
  end
end

if client.enabled?('dark-mode', user: { id: '123' })
  enable_dark_mode
end

variant = client.variant('checkout-flow', user: { id: '123' })

case variant
when 'one-page'
  render_one_page_checkout
when 'multi-step'
  render_multi_step_checkout
else
  render_default_checkout
end

if client.in_percentage?('new-algorithm', user: { id: '123' })
  use_new_algorithm
else
  use_legacy_algorithm
end

client = ToggleCraft::Client.new(
  # Required
  sdk_key: 'your-sdk-key',              # Get from ToggleCraft dashboard

  # Optional - Common settings
  enable_cache: true,                   # Enable caching (default: true)
  cache_adapter: :memory,               # :memory or :redis (default: :memory)
  cache_ttl: 300,                       # Cache TTL in seconds (default: 5 minutes)
  debug: false                          # Enable debug logging (default: false)
)

context = {
  user: {
    id: 'user-123',                     # Required for consistent evaluation
    email: 'user@example.com',
    plan: 'premium',
    # Add any custom attributes you need
    role: 'admin',
    company_id: 'acme-corp'
  },
  request: {
    ip: '192.168.1.1',
    country: 'US'
  },
  device: {
    type: 'mobile',
    os: 'iOS'
  }
}

client.enabled?('premium-feature', context)

# config/initializers/togglecraft.rb
Rails.application.config.togglecraft = ToggleCraft::Client.new(
  sdk_key: ENV['TOGGLECRAFT_SDK_KEY'],
  cache_adapter: :memory,
  logger: Rails.logger
)

class FeatureWorker
  include Sidekiq::Worker

  def togglecraft
    @togglecraft ||= ToggleCraft::Client.new(
      sdk_key: ENV['TOGGLECRAFT_SDK_KEY'],
      share_connection: true  # Share connection with other workers
    )
  end

  def perform(user_id)
    togglecraft.connect unless togglecraft.connected?

    if togglecraft.enabled?('batch-processing', user: { id: user_id })
      # Use new batch processing
    end
  end
end

# Flags are ready
client.on(:ready) do
  puts 'Client ready!'
end

# Flags updated in real-time
client.on(:flags_updated) do |flags|
  puts "Flags updated: #{flags.keys.join(', ')}"
end

# Connection lost
client.on(:disconnected) do
  puts 'Disconnected - using cached flags'
end

# Error occurred
client.on(:error) do |error|
  logger.error "ToggleCraft error: #{error}"
end

# Safe evaluation with defaults
is_enabled = client.enabled?('feature', context, default: false)
# Returns false if flag doesn't exist or on error

# Handle connection errors
begin
  client.connect
rescue StandardError => e
  logger.error "Failed to connect: #{e}"
  # App still works with cached values or defaults
end

# On application shutdown
at_exit do
  client.destroy
end