gofast

gofast is a Go module that provides easy-to-use in-memory cache algorithms like LRU (Least Recently Used). It allows you to import and use these algorithms simply and directly in your Go projects.

Installation

Install gofast by simply using the go get command:

$ go get github.com/raghavgh/gofast

Usage

Importing the module

First, import gofast like this:

import "github.com/raghavgh/gofast"

Here is an example of how you can use the module:

type CacheRepo struct {
    MetaCache gofast.Cache
}

func NewCacheRepo() *CacheRepo {
    return &CacheRepo{
        // gofast.LRU is the algorithm type for LRU.
    // 1000 is limit of your cache.
        MetaCache: gofast.NewCache(1000, gofast.LRU),
    }
}

Available Functions

// Get returns the value (if any) and a boolean representing whether the value was found or not
Get(key string) (any, bool)
// Put adds a value to the cache
Put(key string, val any)
// Remove removes a value from the cache
Remove(key string)
// Len returns the number of elements of the cache
Len() int
// Clear clears the cache
Clear()
// Contains returns true if the cache contains the given key
Contains(key string) bool

**All above funtions are thread safe

Available Cache Algorithms

Currently, the following cache algorithms are available:

1. LRU (Least Recently Used)

2. LFU (Least Frequently Used)

3. LIFO (Last In, First Out)

4. FIFO (First In, First Out)

More algorithms will be available in future versions.

Supported algorithms can be specified with the following constants:

gofast.LRU   // Least Recently Used algorithm
gofast.LFU   // Least Frequently Used algorithm
gofast.FIFO  // First In, First Out algorithm
gofast.MRU   // Most Recently Used algorithm
gofast.RR    // Random Replacement algorithm
gofast.SLRU  // Segmented Least Recently Used algorithm
gofast.LIFO  // Last In, First Out algorithm

🤝 Contributions Welcome!

We’re excited to have you contribute to the gofast library! Whether you’re fixing bugs 🐛, adding new features ✨, improving documentation 📚, or enhancing test coverage 🧪—we’d love your help!

How to Get Started:

1. 🍴 Fork the repository and create your feature branch (git checkout -b feature/AmazingFeature).
2. 🛠️ Make your changes and commit them (git commit -m 'Add some AmazingFeature').
3. ⏫ Push to the branch (git push origin feature/AmazingFeature).
4. 🔍 Open a pull request, and we’ll review it as soon as possible!

Looking for Ideas?

Check out our issues page for a list of open tasks or feel free to suggest your own improvements! We’re especially interested in:

• 🧩 Implementing new cache algorithms (e.g., MRU).
• 🔍 Adding more unit tests for better coverage.
• ⚡ Improving performance with enhanced benchmarking.

We look forward to your valuable contributions and ideas 💡! Let’s make gofast even faster together! 🎉