core.memoize is a Clojure contrib library providing the following features:
An underlying PluggableMemoization
protocol that allows the use of customizable and swappable memoization caches that adhere to the synchronous CacheProtocol
found in core.cache
Memoization builders for implementations of common caching strategies, including:
clojure.core.memoize/fifo
)clojure.core.memoize/lru
)clojure.core.memoize/lu
)clojure.core.memoize/ttl
)memo
) that duplicates the functionality of Clojure's memoize
function but, unlike the built-in memoize
function, ensures that in the case of concurrent calls with the same arguments, the memoized function is only invoked once; in addition memo
can use metadata from the memoized function to ignore certain arguments for the purpose of creating the cache key, e.g., allowing you to memoize clojure.java.jdbc
functions where the first argument includes a (mutable) JDBC Connection
object by specifying :clojure.core.memoize/args-fn rest
in the metadataFunctions for manipulating the memoization cache of core.memoize
backed functions
This project follows the version scheme MAJOR.MINOR.COMMITS where MAJOR and MINOR provide some relative indication of the size of the change, but do not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names). COMMITS is an ever-increasing counter of commits since the beginning of this repository.
Latest stable release: 1.0.257
CLI/deps.edn
dependency information:
org.clojure/core.memoize {:mvn/version "1.0.257"}
Leiningen dependency information:
[org.clojure/core.memoize "1.0.257"]
Maven dependency information:
<dependency>
<groupId>org.clojure</groupId>
<artifactId>core.memoize</artifactId>
<version>1.0.257</version>
</dependency>
(ns my.cool.lib
(:require clojure.core.memoize))
(def id (clojure.core.memoize/lu
#(do (Thread/sleep 5000) (identity %))
:lu/threshold 3))
(id 42)
; ... waits 5 seconds
;=> 42
(id 42)
; instantly
;=> 42
Refer to docstrings in the clojure.core.memoize
namespace for more information.
ttl
docstring (j-mckitrick).IPending
for RetryingDelay
for folks trying to do low-level availability tests on long-running memoized functions.core.cache
to 1.0.225clojure.core/memoize
and clojure.core.memoize/memo
functions CMEMOIZE-25.core.cache
to 1.0.217.core.cache
dependency version from 0.8.2 to 1.0.207.memo-reset!
and deprecates 2-arity version of memo-swap!
; adds 3+-arity version of memo-swap!
to behave more like a swap!
operation on the underlying cachecore.cache
dependency version from 0.7.2 to 0.8.2.memoizer
as a more convenient way to build custom cached functions that may provide a seed hash map of arguments to return values. build-memoizer
should be considered deprecated at this point.seed
function on PluggableMemoization
now makes elements derefable (this case was missed when CMEMOIZE-18 was fixed)memo-swap!
(discovered by Teemu Kaukoranta):clojure.core.memoize/args-fn
metadata support for memoizing functions which have one or more arguments that should not contribute to the cache key for callslazy-snapshot
functionderef
-able to match documentation and comply with core.memoize's world viewmemo-clear!
.memo-*
APIs(cache-type function <base><:cache-type/threshold int>)
Copyright (c) Rich Hickey and Michael Fogus, 2023. All rights reserved. The use and distribution terms for this software are covered by the Eclipse Public License 1.0 (https://opensource.org/licenses/eclipse-1.0.php) which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound bythe terms of this license. You must not remove this notice, or any other, from this software.
Can you improve this documentation? These fine people already did:
Sean Corfield, fogus, Alex Miller, Fogus, Nicola Mometto & Max PenetEdit on GitHub
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close