Enum RiCacheEvent 

pub enum RiCacheEvent {
    Invalidate {
        key: String,
    },
    InvalidatePattern {
        pattern: String,
    },
    Clear(),
}

Ri Cache Manager

This file implements a cache manager that coordinates different cache backends with consistency support across multiple instances. It provides a unified interface for cache operations while ensuring cache consistency through event-driven architecture.

Design Principles

1. Consistency First: Ensures cache consistency across multiple instances using broadcast events
2. Unified Interface: Provides a consistent API regardless of the underlying cache backend
3. Event-Driven Architecture: Uses broadcast channels for efficient cache invalidation
4. Thread Safety: Implements thread-safe operations using Arc and RwLock
5. Flexibility: Supports any backend implementing the RiCache trait
6. Scalability: Designed to handle high-throughput cache operations

Usage Examples

// Create a cache manager with a Redis backend
let redis_backend = Arc::new(RiRedisBackend::new(config).await?);
let mut cache_manager = RiCacheManager::new(redis_backend);
 
// Start the consistency listener
let listener_handle = cache_manager.start_consistency_listener().await;
 
// Set a value in cache
cache_manager.set("user:123", &User { id: 123, name: "John" }, Some(3600)).await?;
 
// Get a value from cache
let user: Option<User> = cache_manager.get("user:123").await?;
 
// Delete a value and invalidate across all instances
cache_manager.delete("user:123").await?;
 
// Clear cache and broadcast to all instances
cache_manager.clear().await?;

Cache event type for maintaining cache consistency across instances

This enum defines the events that are broadcasted to ensure all cache instances remain consistent. Each event triggers a corresponding action on all cache instances.

Variants

Invalidate

Invalidate a specific cache key

Parameters:

• key: The cache key to invalidate

Fields

key: String

InvalidatePattern

Invalidate all cache keys matching a pattern

Parameters:

• pattern: The pattern to match cache keys (supports wildcards depending on backend)

Fields

pattern: String

Clear()

Clear all cache entries

Trait Implementations

impl Clone for RiCacheEvent

fn clone(&self) -> RiCacheEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RiCacheEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RiCacheEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'py> IntoPyObject<'py> for RiCacheEvent

type Target = RiCacheEvent

The Python output type

type Output = Bound<'py, <RiCacheEvent as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl PyClass for RiCacheEvent

type Frozen = True

Whether the pyclass is frozen.

impl PyClassBaseType for RiCacheEvent

type LayoutAsBase = PyClassObject<RiCacheEvent>

type BaseNativeType = <RiCacheEvent as PyClassImpl>::BaseNativeType

type Initializer = PyClassInitializer<RiCacheEvent>

type PyClassMutability = <RiCacheEvent as PyClassImpl>::PyClassMutability

impl PyClassImpl for RiCacheEvent

const IS_BASETYPE: bool = true

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]

const RAW_DOC: &'static CStr = /// remain consistent. Each event triggers a corresponding action on all cache instances.

Docstring for the class provided on the struct or enum.

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined.

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<RiCacheEvent>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::ImmutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyTypeInfo for RiCacheEvent

const NAME: &'static str = "RiCacheEvent"

Class name.

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl Serialize for RiCacheEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ExtractPyClassWithClone for RiCacheEvent