arbor-lru-cache: LRU cache based on STM

[ concurrency, data, library, mit ] [ Propose Tags ] [ Report a vulnerability ]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.1.0, 0.1.1.1
Change log ChangeLog.md
Dependencies base (>=4.7 && <5), containers (>=0.5 && <0.7), stm (>=2.5 && <3) [details]
Tested with ghc ==8.8.1, ghc ==8.6.5, ghc ==8.4.4, ghc ==8.2.2
License MIT
Copyright 2018-2019 Arbor Networks
Author Arbor Networks
Maintainer mayhem@arbor.net
Category Data, Concurrency
Home page https://github.com/arbor/arbor-lru-cache#readme
Bug tracker https://github.com/arbor/arbor-lru-cache/issues
Source repo head: git clone https://github.com/arbor/arbor-lru-cache
Uploaded by arbornetworks at 2019-10-03T05:45:33Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 1632 total (5 in the last 30 days)
Rating 1.25 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2019-10-03 [all 1 reports]

Readme for arbor-lru-cache-0.1.1.1

[back to package description]

arbor-lru-cache

A thread-safe LRU cache library.

Example

To use the cache:

main :: IO main = do -- Provide a configuration that includes how many simultaneous in -- flight requests are allowed and now many entries the cache can store let config = A.CacheConfig { A.maxRequestsInFlight = 1 , A.maxOccupancy = 1 } -- Create a cache providing the config and functions that handle retrieval -- and eviction. cache <- A.makeCache config retrieve evict -- Perform your lookups _ <- A.lookup 1 cache _ <- A.lookup 2 cache _ <- A.lookup 3 cache return () -- Implement value retrieval function. If the same key is looked up multiple -- times, the cache guarantees that the retrieve function is called only once -- for that key up until it is evicted. retrieve :: Int -> IO String retrieve mk = ... -- Perform any cleanup that should occur when an entry is evicted -- Please be aware that if your code is concurrent, the eviction function may -- be called whilst the you code is concurrently using a value it has looked up. -- Your code is wholly responsible for ensuring this case still works. evict :: Int -> String -> IO () evict mk mv = ...