Why

core.memoize is great but sometimes a little sugar is nice.

Install

[org.clojars.rutledgepaulv/defcash "0.1.0"]

Usage

(require [defcash.core :as $])

($/defn$ ^{:ttl/threshold 60000} slow-made-fast [a b]
  (Thread/sleep 5000)
  (+ a b))

(slow-made-fast 1 2) ; takes 5 seconds
(slow-made-fast 1 2) ; returns immediately
(slow-made-fast 1 2) ; returns immediately
(Thread/sleep 61000)
(slow-made-fast 1 2) ; takes 5 seconds
(slow-made-fast 1 2) ; returns immediately
($/memo-clear! slow-made-fast) ; manual eviction
(slow-made-fast 1 2) ; takes 5 seconds
(slow-made-fast 1 2) ; returns immediately


;;; all of the cache strategies provided by core.memoize are supported.
;;; just specify values for these keywords to toggle the strategies on.
;;; you can specify more than one and the strategies will be composed

^{:ttl/threshold 500} will cache values for 5 seconds.
^{:fifo/threshold 500} will do a sliding window of the 500 most recent invocations.
^{:lu/threshold 500} will keep 500 items and then remove items that are accessed the least.
^{:lru/threshold 500} will keep 500 items and then remove the items that were least recently used.


;;; you can also specify a :seed which is a map of arg vector to value
;;; seed data is exempt from all natural and explicit evictions

^{:seed {[1 2] 3 [4 5] 9}}

License

This project is licensed under MIT license.