📦 Atikin-Cache

⚡ High-performance in-memory caching library with TTL, LRU eviction, thread-safety, and persistence. Created By: Atikin Verse.

🚀 Features

• ⏳ Time-to-live (TTL): Automatic expiration of cached items
• 🔄 LRU eviction: Least Recently Used items removed when cache is full
• 🧵 Thread-safe: Safe for multi-threaded applications
• 💾 Persistence: Save and load cache data from disk
• ⚡ High performance: O(1) read/write operations, minimal overhead

📥 Installation

pip install atikin-cache

Or install from source:

git clone https://github.com/atikinverse/atikin-cache.git
cd atikin-cache
pip install .

📖 Usage

🔹 Basic Example

from atikin_cache import AtikinCache

# Create cache with max 1000 items and 5-minute default TTL
cache = AtikinCache(maxsize=1000, default_ttl=300)

# Set a value
cache.set('user:123', {'name': 'John', 'email': 'john@example.com'})

# Get a value
user = cache.get('user:123')
print(user)  # {'name': 'John', 'email': 'john@example.com'}

# Custom TTL
cache.set('temp:data', 'temporary', ttl=10)  # 10 seconds

# Check existence
if cache.exists('user:123'):
    print("User exists in cache")

# Delete key
cache.delete('user:123')

# Clear cache
cache.clear()

🔹 Persistent Cache

# Create cache with persistence
cache = AtikinCache(persist_path='/path/to/cache.dat')

# Store data
cache.set('key', 'value')

# Save to disk
cache.save_to_disk()

# Load from disk
cache.load_from_disk()

🧪 Testing

Run the full test suite:

python -m unittest discover tests

Run the example:

python examples/basic_usage.py

⚡ Performance

• O(1) for get, set, delete operations
• Optimized for minimal locking in multi-threaded environments
• Efficient memory usage with LRU eviction

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🌐 Follow Us