Skip to content

Callback Hooks

Ngan Pham edited this page Feb 24, 2026 · 1 revision

Callback Hooks

FixtureKit supports four callback events around cache save and cache mount.

Registering Callbacks

FixtureKit.configure do |config|
  config.on_cache_save do |identifier|
    Rails.logger.info("saving #{identifier}")
  end

  config.on_cache_saved do |identifier, duration|
    Rails.logger.info("saved #{identifier} in #{duration.round(3)}s")
  end

  config.on_cache_mount do |identifier|
    Rails.logger.info("mounting #{identifier}")
  end

  config.on_cache_mounted do |identifier, duration|
    Rails.logger.info("mounted #{identifier} in #{duration.round(3)}s")
  end
end

Behavior

  • You can register multiple callbacks per event.
  • Callbacks execute in registration order.
  • identifier is always a String cache identifier.
  • Duration values are elapsed seconds (Float) for post events.

Event Semantics

  • on_cache_save: before cache file is generated/written.
  • on_cache_saved: after save, with duration.
  • on_cache_mount: before cache replay begins.
  • on_cache_mounted: after mount, with duration.

For canonical signatures, see docs/reference.md.

Clone this wiki locally