Session Management

Session management based on Redis Hash with JSON serialization to preserve data types.

Usage

from redis_kit import SessionManager

sessions = SessionManager(conn.sync_client, prefix="session", ttl=1800)

# Create
session_id = sessions.create({"user_id": 1, "role": "admin"})

# Read — values preserve original types (int, list, dict, etc.)
data = sessions.get(session_id)
assert data["user_id"] == 1  # int, not "1"

# Update (partial update, also refreshes TTL)
sessions.update(session_id, {"last_active": "2026-04-10"})

# Refresh TTL
sessions.refresh(session_id)

# Delete
sessions.delete(session_id)

# Check existence
sessions.exists(session_id)

Custom ID Generator

sessions = SessionManager(
    conn.sync_client,
    prefix="session",
    ttl=1800,
    id_generator=lambda: my_custom_id(),
)