Categorygithub.com/die-net/lrucache
modulepackage
0.0.0-20240714232319-26322ba4bc23
Repository: https://github.com/die-net/lrucache.git
Documentation: pkg.go.dev
Overview
Versions
1
Dependencies
3
Dependents
21
Files
118 SLOC

# README

LruCache Build Status Coverage Status Go Report Card

This project is now archived, since httpcache.Cache is itself archived, and I haven't used this in years.

LruCache is a thread-safe, in-memory httpcache.Cache implementation that evicts the least recently used entries when a byte size limit or optional max age would be exceeded.

Using the included TwoTier wrapper, it could also be used as a small and fast cache for popular objects, falling back to a larger and slower cache (such as s3cache) for less popular ones.

Also see the godoc API documentation for LruCache or TwoTier.

Included are a test suite with close to 100% test coverage and a parallel benchmark suite that shows individual Set, Get, and Delete operations take under 400ns to complete.

License

Copyright 2016 Aaron Hopkins and contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

# Packages

Package twotier provides a wrapper for two httpcache.Cache instances, allowing you to use both a small and fast cache for popular objects and fall back to a larger and slower cache for less popular ones.

# Functions

New creates an LruCache that will restrict itself to maxSize bytes of memory.

# Structs

LruCache is a thread-safe, in-memory httpcache.Cache that evicts the least recently used entries from memory when either MaxSize (in bytes) limit would be exceeded or (if set) the entries are older than MaxAge (in seconds).