Skip to content

v0.3.0

Choose a tag to compare

@Ch4s3 Ch4s3 released this 24 May 03:14
· 5 commits to main since this release

Added

  • Multivariate flags: Bandera.variant/2 and put_variants/3 for stable per-actor N-way allocation. Bucketing uses a weighted SHA-256 hash — the same actor always sees the same variant across nodes and restarts.
  • Ecto schema v2: a nullable value column stores variant gate payloads. Bandera.Ecto.Migrations.upgrade_v2/0 migrates an existing table; new installs get the column automatically via up/0.
  • Context-based targeting rules: enable(flag, when: constraints) and a :context map on enabled?/2. Supported operators: :eq, :neq, :in, :not_in, :contains, :gt, :gte, :lt, :lte, :matches (regex).
  • Reusable segments: put_segment/2 stores a named constraint set; enable(flag, for_segment: name) references it. Segment rules are expanded at evaluation time so changing a segment immediately affects every flag that uses it.
  • Flag prerequisites: enable(flag, requires: other_flag) requires another flag to be enabled (or disabled with {:flag, false}) before the dependent flag can turn on. Dependency cycles and missing parents fail closed.
  • Scheduled activation: enable(flag, schedule: {start, stop}) enables a flag only inside an ISO-8601 UTC time window. Either bound may be nil for an open-ended start or end. Malformed windows fail closed.
  • Audit log: Bandera.Audit.attach/2 and detach/1 register callbacks that receive a %Bandera.Audit.Event{} on every write. Pass :by to enable/2, disable/2, and clear/2 to record who made the change.
  • Stale flag tracking: start Bandera.Usage in your supervision tree and call attach/0 at boot; then use Bandera.stale_flags/1 or mix bandera.flags --stale [--older-than N] to find flags not evaluated in the last N days (default 30).
  • Dashboard: inline editors for variant, rule-constraint, segment, prerequisite, and schedule gates in the expanded flag row.
  • Dashboard: per-gate-type summaries shown in collapsed flag rows.
  • enabled?/2 :default option: pass default: true to fail open when the store is unreachable (the default behaviour remains fail closed).
  • Symmetric clear/2 options for variant, rule, segment, prerequisite, and schedule gates — matching the corresponding enable/2 options.

Changed

  • Re-added jason as a direct dependency (required for variant gate JSON serialization in Ecto and Redis stores). It was dropped in 0.2.0 in favour of Elixir's built-in JSON module, but structured gate payloads need encoder options not available in the standard library.

Fixed

  • stale_flags/1: negative window values are clamped to zero.
  • Telemetry: audit and usage handlers that raise are caught; they no longer crash the telemetry pipeline.
  • Stores: JSON deserialization of unknown gate types now fails softly instead of crashing; prerequisite flag names are bound as atoms at load time.
  • Prerequisites: resolution is memoized per enabled? call; cycles and unknown parents fail closed rather than looping.
  • Targeting: empty rule sets now fail closed instead of granting access to all callers.
  • Variant weights: negative and non-numeric weight values are rejected at write time.
  • Constraint evaluation: comparisons are numeric-aware when both sides are numbers; compiled regexes are cached per constraint.

Full changelog: v0.2.0...v0.3.0