Skip to content

Types and Enums

Core enums and type aliases used across the library.

Bases: str, Enum

序列化模式枚举

定义缓存值的序列化方式： - JSON: JSON 序列化，跨语言兼容，但类型支持有限 - PICKLE: Python 原生序列化，支持所有 Python 对象 - MSGPACK: MessagePack 序列化，紧凑高效

Source code in src/symphra_cache/types.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
class SerializationMode(str, Enum):
    """
    序列化模式枚举

    定义缓存值的序列化方式：
    - JSON: JSON 序列化，跨语言兼容，但类型支持有限
    - PICKLE: Python 原生序列化，支持所有 Python 对象
    - MSGPACK: MessagePack 序列化，紧凑高效
    """

    JSON = "json"  # JSON 序列化
    PICKLE = "pickle"  # Pickle 序列化
    MSGPACK = "msgpack"  # MessagePack 序列化

Bases: str, Enum

缓存淘汰策略枚举

定义缓存满时的淘汰规则： - LRU: Least Recently Used（最近最少使用），淘汰最久未访问的项 - LFU: Least Frequently Used（最不经常使用），淘汰访问次数最少的项 - FIFO: First In First Out（先进先出），淘汰最早插入的项

Source code in src/symphra_cache/types.py 
70
71
72
73
74
75
76
77
78
79
80
81
82
class EvictionPolicy(str, Enum):
    """
    缓存淘汰策略枚举

    定义缓存满时的淘汰规则：
    - LRU: Least Recently Used（最近最少使用），淘汰最久未访问的项
    - LFU: Least Frequently Used（最不经常使用），淘汰访问次数最少的项
    - FIFO: First In First Out（先进先出），淘汰最早插入的项
    """

    LRU = "lru"  # 最近最少使用
    LFU = "lfu"  # 最不经常使用
    FIFO = "fifo"  # 先进先出

Bases: str, Enum

后端类型枚举

定义支持的缓存后端类型： - MEMORY: 内存后端，高性能，进程重启数据丢失 - FILE: 文件后端，持久化，支持热重载 - REDIS: Redis 后端，分布式，高可用

Source code in src/symphra_cache/types.py 
85
86
87
88
89
90
91
92
93
94
95
96
97
class BackendType(str, Enum):
    """
    后端类型枚举

    定义支持的缓存后端类型：
    - MEMORY: 内存后端，高性能，进程重启数据丢失
    - FILE: 文件后端，持久化，支持热重载
    - REDIS: Redis 后端，分布式，高可用
    """

    MEMORY = "memory"  # 内存后端
    FILE = "file"  # 文件后端
    REDIS = "redis"  # Redis 后端