GoToSocial/vendor/codeberg.org/gruf/go-cache/v3
kim 7ec1e1332e
[performance] overhaul struct (+ result) caching library for simplicity, performance and multiple-result lookups (#2535)
* rewrite cache library as codeberg.org/gruf/go-structr, implement in gotosocial

* use actual go-structr release version (not just commit hash)

* revert go toolchain changes (damn you go for auto changing this)

* fix go mod woes

* ensure %w is used in calls to errs.Appendf()

* fix error checking

* fix possible panic

* remove unnecessary start/stop functions, move to main Cache{} struct, add note regarding which caches require start/stop

* fix copy-paste artifact... 😇

* fix all comment copy-paste artifacts

* remove dropID() function, now we can just use slices.DeleteFunc()

* use util.Deduplicate() instead of collate(), move collate to util

* move orderByIDs() to util package and "generify"

* add a util.DeleteIf() function, use this to delete entries on failed population

* use slices.DeleteFunc() instead of util.DeleteIf() (i had the logic mixed up in my head somehow lol)

* add note about how collate differs from deduplicate
2024-01-19 12:57:29 +00:00
..
simple [performance] add caching of status fave, boost of, in reply to ID lists (#2060) 2023-08-04 12:28:33 +01:00
ttl [feature] simpler cache size configuration (#2051) 2023-08-03 11:34:35 +02:00
LICENSE [feature] simpler cache size configuration (#2051) 2023-08-03 11:34:35 +02:00
README.md [feature] simpler cache size configuration (#2051) 2023-08-03 11:34:35 +02:00
cache.go [feature] simpler cache size configuration (#2051) 2023-08-03 11:34:35 +02:00

README.md

go-cache

Provides access to simple, yet flexible, and performant caches (with TTL if required) via the cache.Cache{} and cache.TTLCache{} interfaces.

simple

A cache.Cache{} implementation with much more of the inner workings exposed. Designed to be used as a base for your own customizations, or used as-is.

ttl

A cache.TTLCache{} implementation with much more of the inner workings exposed. Designed to be used as a base for your own customizations, or used as-is.

result

result.Cache is an example of a more complex cache implementation using ttl.Cache{} as its underpinning.

It provides caching specifically of loadable struct types, with automatic keying by multiple different field members and caching of negative (error) values. All useful when wrapping, for example, a database.