toggly-cache 0.1.0

Caching providers for Toggly feature flag management (Redis, Memcached)

Toggly Cache

Caching providers for Toggly feature flag management. This package provides Redis and Memcached snapshot providers for distributed caching of feature flag definitions.

Installation

# Install with Redis support
pip install toggly-cache[redis]

# Install with Memcached support
pip install toggly-cache[memcached]

# Install with both
pip install toggly-cache[all]

Quick Start

Redis Provider

from toggly import TogglyClient, TogglyConfig
from toggly_cache import RedisSnapshotProvider

# Create a Redis snapshot provider
provider = RedisSnapshotProvider(
    host="localhost",
    port=6379,
    db=0,
    prefix="toggly:",
    ttl=3600,  # Cache for 1 hour
)

# Use with TogglyClient
config = TogglyConfig(
    app_key="your-app-key",
    environment="production",
    snapshot_provider=provider,
)

client = TogglyClient(config)

Memcached Provider

from toggly import TogglyClient, TogglyConfig
from toggly_cache import MemcachedSnapshotProvider

# Create a Memcached snapshot provider
provider = MemcachedSnapshotProvider(
    servers=[("localhost", 11211)],
    prefix="toggly:",
    ttl=3600,  # Cache for 1 hour
)

# Use with TogglyClient
config = TogglyConfig(
    app_key="your-app-key",
    environment="production",
    snapshot_provider=provider,
)

client = TogglyClient(config)

Configuration

Redis Provider Options

Option	Type	Default	Description
client	Redis	None	Existing Redis client instance
host	str	"localhost"	Redis host
port	int	6379	Redis port
db	int	0	Redis database number
password	str	None	Redis password
prefix	str	"toggly:"	Key prefix for Redis keys
ttl	int	None	TTL in seconds (None = no expiry)

Memcached Provider Options

Option	Type	Default	Description
client	Client	None	Existing pymemcache client
servers	list[tuple]	None	List of (host, port) tuples
prefix	str	"toggly:"	Key prefix for Memcached keys
ttl	int	0	TTL in seconds (0 = no expiry)

Using Existing Clients

You can pass an existing Redis or Memcached client:

# Redis
import redis
redis_client = redis.Redis(host="localhost", port=6379)
provider = RedisSnapshotProvider(client=redis_client)

# Memcached
from pymemcache.client.base import Client
memcached_client = Client(("localhost", 11211))
provider = MemcachedSnapshotProvider(client=memcached_client)

Cluster Support

Redis Cluster

from redis.cluster import RedisCluster
from toggly_cache import RedisSnapshotProvider

cluster = RedisCluster(
    host="cluster-node-1",
    port=6379,
)
provider = RedisSnapshotProvider(client=cluster)

Memcached with Multiple Servers

from toggly_cache import MemcachedSnapshotProvider

# Automatically uses HashClient for consistent hashing
provider = MemcachedSnapshotProvider(
    servers=[
        ("memcached-1", 11211),
        ("memcached-2", 11211),
        ("memcached-3", 11211),
    ],
)

How It Works

Cache providers implement the SnapshotProvider interface from the core toggly package. When the TogglyClient loads feature definitions:

1. It first tries to load from the snapshot provider (cache)
2. If not found, it fetches from the Toggly API
3. After fetching, it saves the definitions to the snapshot provider

This enables:

• Faster startup: Cached definitions are loaded immediately
• Offline resilience: App works even if Toggly API is temporarily unavailable
• Reduced API calls: Definitions are cached between restarts
• Distributed caching: Multiple app instances share the same cache

Requirements

• Python 3.8+
• toggly>=0.1.0
• redis>=4.0.0 (for Redis provider)
• pymemcache>=4.0.0 (for Memcached provider)

License

MIT License - see LICENSE for details.

Links

• Toggly Documentation
• GitHub Repository
• PyPI Package