2025-03-29 06:33:55 +08:00
|
|
|
import redis.asyncio as redis
|
|
|
|
import os
|
|
|
|
from dotenv import load_dotenv
|
|
|
|
import asyncio
|
2025-04-02 02:49:35 +08:00
|
|
|
from utils.logger import logger
|
2025-04-25 05:15:40 +08:00
|
|
|
from typing import List, Any
|
2025-03-29 06:33:55 +08:00
|
|
|
|
|
|
|
# Redis client
|
|
|
|
client = None
|
|
|
|
_initialized = False
|
|
|
|
_init_lock = asyncio.Lock()
|
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
# Constants
|
|
|
|
REDIS_KEY_TTL = 3600 * 24 # 24 hour TTL as safety mechanism
|
2025-04-04 23:06:49 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
def initialize():
|
2025-04-25 05:15:40 +08:00
|
|
|
"""Initialize Redis connection using environment variables."""
|
2025-03-29 06:33:55 +08:00
|
|
|
global client
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
# Load environment variables if not already loaded
|
|
|
|
load_dotenv()
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
# Get Redis configuration
|
|
|
|
redis_host = os.getenv('REDIS_HOST', 'redis')
|
|
|
|
redis_port = int(os.getenv('REDIS_PORT', 6379))
|
|
|
|
redis_password = os.getenv('REDIS_PASSWORD', '')
|
2025-04-26 18:13:14 +08:00
|
|
|
# Convert string 'True'/'False' to boolean
|
|
|
|
redis_ssl_str = os.getenv('REDIS_SSL', 'False')
|
|
|
|
redis_ssl = redis_ssl_str.lower() == 'true'
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
logger.info(f"Initializing Redis connection to {redis_host}:{redis_port}")
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
# Create Redis client with basic configuration
|
2025-03-29 06:33:55 +08:00
|
|
|
client = redis.Redis(
|
2025-04-25 05:15:40 +08:00
|
|
|
host=redis_host,
|
|
|
|
port=redis_port,
|
|
|
|
password=redis_password,
|
2025-04-26 14:11:25 +08:00
|
|
|
ssl=redis_ssl,
|
2025-04-04 23:06:49 +08:00
|
|
|
decode_responses=True,
|
2025-04-25 05:15:40 +08:00
|
|
|
socket_timeout=5.0,
|
|
|
|
socket_connect_timeout=5.0,
|
|
|
|
retry_on_timeout=True,
|
|
|
|
health_check_interval=30
|
2025-03-29 06:33:55 +08:00
|
|
|
)
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
return client
|
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def initialize_async():
|
2025-03-29 06:33:55 +08:00
|
|
|
"""Initialize Redis connection asynchronously."""
|
|
|
|
global client, _initialized
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
async with _init_lock:
|
|
|
|
if not _initialized:
|
2025-04-01 10:36:26 +08:00
|
|
|
logger.info("Initializing Redis connection")
|
2025-03-29 06:33:55 +08:00
|
|
|
initialize()
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
try:
|
|
|
|
await client.ping()
|
|
|
|
logger.info("Successfully connected to Redis")
|
|
|
|
_initialized = True
|
|
|
|
except Exception as e:
|
|
|
|
logger.error(f"Failed to connect to Redis: {e}")
|
|
|
|
client = None
|
|
|
|
raise
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
return client
|
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
async def close():
|
|
|
|
"""Close Redis connection."""
|
|
|
|
global client, _initialized
|
|
|
|
if client:
|
2025-04-01 10:36:26 +08:00
|
|
|
logger.info("Closing Redis connection")
|
2025-03-29 06:33:55 +08:00
|
|
|
await client.aclose()
|
|
|
|
client = None
|
|
|
|
_initialized = False
|
2025-04-01 10:36:26 +08:00
|
|
|
logger.info("Redis connection closed")
|
2025-03-29 06:33:55 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-03-29 06:33:55 +08:00
|
|
|
async def get_client():
|
|
|
|
"""Get the Redis client, initializing if necessary."""
|
|
|
|
global client, _initialized
|
|
|
|
if client is None or not _initialized:
|
2025-04-25 05:15:40 +08:00
|
|
|
await initialize_async()
|
2025-04-04 23:06:49 +08:00
|
|
|
return client
|
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
# Basic Redis operations
|
|
|
|
async def set(key: str, value: str, ex: int = None):
|
|
|
|
"""Set a Redis key."""
|
2025-04-04 23:06:49 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.set(key, value, ex=ex)
|
2025-04-04 23:06:49 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def get(key: str, default: str = None):
|
|
|
|
"""Get a Redis key."""
|
2025-04-04 23:06:49 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
result = await redis_client.get(key)
|
2025-04-04 23:06:49 +08:00
|
|
|
return result if result is not None else default
|
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def delete(key: str):
|
|
|
|
"""Delete a Redis key."""
|
2025-04-04 23:06:49 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.delete(key)
|
2025-04-04 23:06:49 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def publish(channel: str, message: str):
|
|
|
|
"""Publish a message to a Redis channel."""
|
2025-04-04 23:06:49 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.publish(channel, message)
|
2025-04-04 23:06:49 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def create_pubsub():
|
|
|
|
"""Create a Redis pubsub object."""
|
2025-04-04 23:06:49 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return redis_client.pubsub()
|
2025-04-04 23:06:49 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
# List operations
|
|
|
|
async def rpush(key: str, *values: Any):
|
|
|
|
"""Append one or more values to a list."""
|
2025-04-24 08:37:14 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.rpush(key, *values)
|
2025-04-24 08:37:14 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def lrange(key: str, start: int, end: int) -> List[str]:
|
|
|
|
"""Get a range of elements from a list."""
|
2025-04-24 08:37:14 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.lrange(key, start, end)
|
2025-04-24 08:37:14 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def llen(key: str) -> int:
|
|
|
|
"""Get the length of a list."""
|
2025-04-24 08:37:14 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.llen(key)
|
2025-04-24 08:37:14 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
# Key management
|
|
|
|
async def expire(key: str, time: int):
|
|
|
|
"""Set a key's time to live in seconds."""
|
2025-04-24 08:37:14 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-25 05:15:40 +08:00
|
|
|
return await redis_client.expire(key, time)
|
2025-04-24 08:37:14 +08:00
|
|
|
|
2025-04-26 14:11:25 +08:00
|
|
|
|
2025-04-25 05:15:40 +08:00
|
|
|
async def keys(pattern: str) -> List[str]:
|
|
|
|
"""Get keys matching a pattern."""
|
2025-04-04 23:06:49 +08:00
|
|
|
redis_client = await get_client()
|
2025-04-26 18:13:14 +08:00
|
|
|
return await redis_client.keys(pattern)
|