Struct RiSessionManager 

pub struct RiSessionManager { /* private fields */ }

Session manager for handling user sessions.

This struct manages session creation, validation, and cleanup. It limits the number of sessions per user and automatically cleans up expired sessions.

Implementations

impl RiSessionManager

pub fn new(timeout_secs: u64) -> Self

Creates a new session manager with the specified timeout.

Parameters

• timeout_secs: Default session timeout in seconds

Returns

A new instance of RiSessionManager

Notes

Default maximum sessions per user is 5

pub async fn create_session( &self, user_id: String, ip_address: Option<String>, user_agent: Option<String>, ) -> RiResult<String>

Creates a new session for a user.

Parameters

• user_id: ID of the user to create the session for
• ip_address: Optional client IP address
• user_agent: Optional client user agent

Returns

The ID of the newly created session

Notes

• If the user has reached the maximum number of sessions, the oldest session is removed
• Session ID is generated using UUID v4 for security

pub async fn validate_session_security( &self, session_id: &str, current_ip: Option<&str>, current_user_agent: Option<&str>, ) -> RiResult<bool>

Validates session security by checking IP and User-Agent.

Security

This method helps prevent session hijacking by verifying that the client’s IP address and User-Agent match the original values.

Parameters

• session_id: ID of the session to validate
• current_ip: Current client IP address
• current_user_agent: Current client User-Agent

Returns

true if the session is valid, false if there’s a mismatch

pub async fn regenerate_session_id( &self, old_session_id: &str, ) -> RiResult<Option<String>>

Regenerates a session ID to prevent session fixation attacks.

Security

This method should be called after successful authentication to prevent session fixation attacks. It creates a new session ID while preserving the session data.

Parameters

• old_session_id: The current session ID

Returns

The new session ID, or None if the old session doesn’t exist

pub async fn get_session(&self, session_id: &str) -> RiResult<Option<RiSession>>

Gets a session by ID.

Parameters

• session_id: ID of the session to retrieve

Returns

Some(RiSession) if the session exists and is not expired, otherwise None

Notes

• Expired sessions are automatically removed and return None
• The session’s last accessed time is updated when retrieved

pub async fn update_session( &self, session_id: &str, data: FxHashMap<String, String>, ) -> RiResult<bool>

Updates a session’s data.

Parameters

• session_id: ID of the session to update
• data: HashMap of key-value pairs to update in the session

Returns

true if the session was updated successfully, false if the session doesn’t exist or is expired

Notes

• The session’s last accessed time is updated when modified

pub async fn extend_session(&self, session_id: &str) -> RiResult<bool>

Extends a session’s expiration time.

Parameters

• session_id: ID of the session to extend

Returns

true if the session was extended successfully, false if the session doesn’t exist or is expired

pub async fn destroy_session(&self, session_id: &str) -> RiResult<bool>

Destroys a session by ID.

Parameters

• session_id: ID of the session to destroy

Returns

true if the session was destroyed successfully, false if the session doesn’t exist

pub async fn destroy_user_sessions(&self, user_id: &str) -> RiResult<usize>

Destroys all sessions for a user.

Parameters

• user_id: ID of the user whose sessions to destroy

Returns

The number of sessions destroyed

pub async fn get_user_sessions(&self, user_id: &str) -> RiResult<Vec<RiSession>>

Gets all active sessions for a user.

Parameters

• user_id: ID of the user whose sessions to retrieve

Returns

A vector of active sessions for the user

pub async fn cleanup_expired(&self) -> RiResult<usize>

Cleans up all expired sessions.

Returns

The number of expired sessions cleaned up

pub async fn cleanup_all(&self) -> RiResult<()>

Cleans up all sessions.

This method removes all sessions, regardless of their expiration status.

pub fn get_timeout(&self) -> u64

Gets the default session timeout.

Returns

The default session timeout in seconds

pub fn set_timeout(&mut self, timeout_secs: u64)

Sets the default session timeout.

Parameters

• timeout_secs: New default session timeout in seconds

Trait Implementations

impl<'py> IntoPyObject<'py> for RiSessionManager

type Target = RiSessionManager

The Python output type

type Output = Bound<'py, <RiSessionManager 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 RiSessionManager

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for RiSessionManager

const IS_BASETYPE: bool = false

#[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 = c"Session manager for handling user sessions.\n\nThis struct manages session creation, validation, and cleanup. It limits\nthe number of sessions per user and automatically cleans up expired sessions.\x00"

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<RiSessionManager>

This handles following two situations:

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

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 PyClassNewTextSignature for RiSessionManager

const TEXT_SIGNATURE: &'static str = "(timeout_secs)"

impl PyMethods<RiSessionManager> for PyClassImplCollector<RiSessionManager>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for RiSessionManager

const NAME: &'static str = "RiSessionManager"

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 DerefToPyAny for RiSessionManager

impl ExtractPyClassWithClone for RiSessionManager