0.4.6

View Source

0.4.5

  • chore: fix dialyzer

0.4.4

Bug Fixes

  • refactor(counter): restrict get/2 to integer keys only and add bounds checking

0.4.3

Features

  • feat(counter): add direct integer key indexing for deterministic slot access

0.4.2

Refactors

  • refactor(counter): replace dynamic index map with deterministic hash-based indexing

0.4.1

New Adapters

  • Cache.PersistentTerm — new adapter backed by Erlang's :persistent_term for extremely fast reads on rarely-written data such as configuration values. TTL is not supported; values persist until explicitly deleted.
  • Cache.Counter — new atomic integer counter adapter backed by Erlang's :counters module. Provides lock-free increment/decrement operations via put/4 (values 1 or -1) and injects increment/1,2 and decrement/1,2 into consumer modules through use Cache. Counter references and index maps are stored in :persistent_term for zero-latency access from any process.

Strategy Adapters

  • Cache.Strategy — new behaviour for strategy-based adapters. Strategies compose over existing cache adapters and receive the underlying adapter module and its resolved opts so they can delegate operations appropriately. Adapter tuple format: adapter: {StrategyModule, UnderlyingAdapterOrConfig}.
  • Cache.HashRing — consistent hash ring strategy using libring. Distributes keys across Erlang cluster nodes, forwarding operations to the owning node via :erpc (or a configurable rpc_module). The ring tracks node membership automatically via HashRing.Managed with monitor_nodes: true. Includes read-repair: on a miss, previous ring snapshots (maintained by Cache.HashRing.RingMonitor) are consulted to lazily migrate keys after rebalancing. Configurable options: ring_opts, node_weight, rpc_module, ring_history_size.
  • Cache.MultiLayer — cascades reads and writes through multiple cache layers (e.g. ETS → Redis). Reads walk fastest → slowest with automatic backfill on a slower-layer hit. Writes go slowest → fastest to ensure durability. Supports an optional on_fetch callback on total miss and a backfill_ttl for backfilled entries.
  • Cache.RefreshAhead — proactively refreshes hot keys in the background before their TTL expires. On get, if the value is within the refresh_before window, the current value is returned immediately and an async Task refreshes it. Uses a per-cache ETS deduplication table and :global distributed locking to prevent redundant refreshes across nodes. Requires a refresh_before (ms) opt and a refresh/1 callback or on_refresh opt.

Test Utilities

  • Cache.CaseTemplate — new ExUnit case template for applications with many test files. Define a CacheCase module once with default_caches or supervisors, then use MyApp.CacheCase in any test file to get automatic sandboxed cache setup. Supports per-file additional caches via :caches and detects duplicate cache registrations at setup time.

Bug Fixes

  • fix(ets): suppress no_warn_undefined for OTP 26+ ETS functions on older OTP versions.

0.4.0

feat: add all ets/dets functions and ability for ets to rehydrate fix(con cache): allow concache to accept ets options

0.3.13

  • fix: allow Cache.ConCache to accept ets_options (strict NimbleOptions validation + normalization)
  • feat: allow Cache.ETS write_concurrency: :auto (OTP 25+)

0.3.12

  • chore: fix warnings

0.3.11

  • fix: redis

0.3.10

  • fix: sandbox fix for smembers & sadd

0.3.9

  • chore: add docs
  • fix: set fix

0.3.8

  • feat: add functions for ets & dets caches

0.3.7

  • feat: add metrics module

0.3.6

  • chore: fix child_spec type

0.3.5

  • fix: Cache child spec for starting under a supervisor

0.3.4

  • add get_or_create(key, (() -> {:ok, value} | {:error, reson})) to allow for create or updates

0.3.3

  • use adapter options to allow for runtime options
  • update sandbox hash_set_many behaviour to be consistent
  • ensure dets does a mkdir_p at startup incase directory doesn't exist

0.3.2

  • Update nimble options to 1.x

0.3.1

  • add some more json sandboxing
  • update redis to remove uri from command options

0.3.0

  • add con_cache
  • add ets cache
  • fix hash opts for redis

0.2.1

  • Adds support for application configuration and runtime options

0.2.0

  • Stop redis connection errors from crashing the app
  • Fix hash functions for Cache.Redis
  • Support runtime cache config
  • Support redis JSON
  • Add strategy option to Cache.Redis for poolboy

0.1.1

  • Expose pipeline and command functions on redis adapters

0.1.0

  • Initial Release