FeatureFlipper (feature_flipper v0.1.1)

Main interface for feature flag operations.

FeatureFlipper provides a comprehensive, easy-to-integrate feature flag system for Elixir applications with Consul integration, caching, and deadline management.

Configuration

# config/config.exs
config :feature_flipper,
  consul_kv_path: "telephony/services/routing",
  consul_client_http_addr: "http://consul.query.dev.telnyx.io:18500",
  env: System.get_env("ENV", "dev"),
  hostname: System.get_env("SERVER_HOSTNAME", "local"),
  version_suffix: "1.7.9-rc"  # Optional, for production versioning

Usage

# Define feature flippers
defmodule MyApp.FeatureFlippers do
  use FeatureFlipper.Definition

  define_flipper :use_warehouse_cache_tbs_2221?, %{
    deadline: ~D[2025-06-30],
    description: "Use warehouse cache for improved performance"
  }
end

# Use feature flippers
if MyApp.FeatureFlippers.use_warehouse_cache_tbs_2221?() do
  # Feature is enabled
end

# Or use the main interface
if FeatureFlipper.enabled?(:use_warehouse_cache_tbs_2221?) do
  # Feature is enabled
end

Summary

Functions

Check for feature flippers that are past their deadline.

Check if a feature flipper is enabled.

Get all feature flags and their current values.

Reload configuration from Consul.

Functions

check_deadlines()

@spec check_deadlines() :: [String.t()]

Check for feature flippers that are past their deadline.

Returns a list of warning messages for features that are past their deadline.

Examples

iex> FeatureFlipper.check_deadlines()
["Feature 'old_feature' is past its deadline of 2024-01-01"]

iex> FeatureFlipper.check_deadlines()
[]

enabled?(flipper_name)

@spec enabled?(atom() | String.t()) :: boolean()

Check if a feature flipper is enabled.

Parameters

  • flipper_name - The name of the feature flipper (atom or string)

Examples

iex> FeatureFlipper.enabled?(:my_feature)
true

iex> FeatureFlipper.enabled?("my_feature")
false

get_all_flags()

@spec get_all_flags() :: map()

Get all feature flags and their current values.

Examples

iex> FeatureFlipper.get_all_flags()
%{
  my_feature: true,
  another_feature: false
}

reload_configuration()

@spec reload_configuration() :: :ok | {:error, term()}

Reload configuration from Consul.

This function fetches the latest feature flipper configuration from Consul and updates the local cache.

Examples

iex> FeatureFlipper.reload_configuration()
:ok

iex> FeatureFlipper.reload_configuration()
{:error, :consul_unavailable}