Struct DMSCJWTRevocationList 

pub struct DMSCJWTRevocationList { /* private fields */ }

JWT token revocation list for managing invalidated tokens.

This struct provides functionality to revoke JWT tokens and check if tokens have been revoked. It uses concurrent data structures for thread-safe access.

Usage

The revocation list can be used to implement token invalidation scenarios:

• User logout (revoke specific token)
• Password change (revoke all user tokens)
• Security incidents (bulk revocation)

Storage

By default, revoked tokens are stored in-memory. For production use, consider integrating with Redis or a database-backed storage solution to persist revocations across application restarts.

Implementations

impl DMSCJWTRevocationList

pub fn new() -> Self

Creates a new JWT revocation list with default capacity.

This constructor initializes an empty revocation list with the default maximum capacity for storing revoked tokens.

Returns

A new instance of DMSCJWTRevocationList

pub fn with_capacity(capacity: usize) -> Self

Creates a new JWT revocation list with specified capacity.

This constructor allows specifying the maximum number of revoked tokens that can be stored. When the capacity is exceeded, oldest revoked tokens are automatically removed.

Parameters

• capacity: Maximum number of revoked tokens to store

Returns

A new instance of DMSCJWTRevocationList with specified capacity

impl DMSCJWTRevocationList

pub fn revoke_token( &self, token: &str, user_id: &str, reason: Option<String>, ttl_secs: u64, )

Revokes a specific JWT token.

This method adds a token to the revocation list with associated metadata. The token will be considered invalid for the specified time-to-live duration.

Automatic Cleanup

After revocation, expired tokens are automatically cleaned up if the revocation list exceeds its maximum capacity.

Parameters

• token: The JWT token string to revoke
• user_id: The user ID associated with the token
• reason: Optional reason for revocation
• ttl_secs: Time-to-live in seconds for this revocation record

pub fn revoke_all_user_tokens( &self, user_id: &str, reason: Option<String>, ) -> usize

Revokes all tokens for a specific user.

This method finds all tokens associated with the given user ID and marks them as revoked. Useful for implementing “logout everywhere” functionality or revoking tokens after a security incident.

Parameters

• user_id: The user ID whose tokens should be revoked
• reason: Optional reason for the mass revocation

Returns

The number of tokens that were revoked

pub fn is_revoked(&self, token: &str) -> bool

Checks if a token has been revoked.

This method performs an O(1) lookup to determine if a token exists in the revocation list. If found, it also checks if the revocation record has expired and removes it if so.

Expiration Handling

If the token is found but its revocation record has expired, the token is automatically removed and treated as not revoked.

Parameters

• token: The JWT token string to check

Returns

true if the token is revoked and valid, false otherwise

pub fn get_revocation_info(&self, token: &str) -> Option<DMSCRevokedTokenInfo>

Retrieves revocation information for a specific token.

This method returns the metadata associated with a revoked token, including when it was revoked and the reason (if provided).

Parameters

• token: The JWT token string to look up

Returns

Some(DMSCRevokedTokenInfo) if the token is revoked, None otherwise

pub fn get_revoked_count(&self) -> usize

Returns the current count of revoked tokens.

This method provides the number of tokens currently in the revocation list.

Returns

The number of revoked tokens stored

pub fn clear(&self)

Clears all revoked tokens from the list.

This method removes all entries from both the revoked tokens set and the token info map. Use with caution as it cannot be undone.

Trait Implementations

impl Default for DMSCJWTRevocationList

fn default() -> Self

Returns the “default value” for a type.

impl<'py> IntoPyObject<'py> for DMSCJWTRevocationList

type Target = DMSCJWTRevocationList

The Python output type

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

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for DMSCJWTRevocationList

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 = /// to persist revocations across application restarts.

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

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 DMSCJWTRevocationList

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

impl PyMethods<DMSCJWTRevocationList> for PyClassImplCollector<DMSCJWTRevocationList>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for DMSCJWTRevocationList

const NAME: &'static str = "DMSCJWTRevocationList"

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 DMSCJWTRevocationList

impl ExtractPyClassWithClone for DMSCJWTRevocationList