AtomicFlags

Copy Markdown

An Elixir library which introduces enums and integer flags on top of :atomics erlang module with minimal runtime overhead possible.

Features

  • Set, get, swap, cycle values.
  • Values can be any term.
  • Optimized for zero runtime dispatch when arguments are provided as literals.

Example

defmodule FeatureFlags do
  use AtomicFlags, schema: [
    feature_enabled: [false, true]
  ]
end

iex> flags = FeatureFlags.new()
iex> FeatureFlags.set(flags, :feature_enabled, true)
iex> FeatureFlags.get(flags, :feature_enabled)
true

Or with global: true

defmodule GlobalFeatureFlags do
  use AtomicFlags,
    global: true,
    schema: [
      feature: [:disabled, :for_preview, :enabled]
    ]
end

iex> FeatureFlags.new_global()
iex> FeatureFlags.set(:feature, :for_preview)
iex> FeatureFlags.get(:feature)
:for_preview

Installation

def deps do
  [
    {:atomic_flags, "~> 1.0"}
  ]
end