Enum Caching

#[non_exhaustive]
pub enum Caching {
    Nothing,
    Loggers,
    LoggersAndLevels,
}

What the Logger can cache.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Nothing

Disables caching.

Every time a log message passes the filters, the code goes to the Python side to check if the message shall be logged.

Loggers

Caches the Python Logger objects.

The logger objects (which should stay the same during the lifetime of a Python application) are cached. However, the log levels are not. This means there’s some amount of calling of Python code saved during a logging call, but the GIL still needs to be acquired even if the message doesn’t eventually get output anywhere.

LoggersAndLevels

Caches both the Python Logger and their respective effective log levels.

Therefore, once a Logger has been cached, it is possible to decide on the Rust side if a message would get logged or not. If the message is not to be logged, no Python code is called and the GIL doesn’t have to be acquired.

Trait Implementations

impl Clone for Caching

fn clone(&self) -> Caching

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Caching

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

Formats the value using the given formatter.

impl Default for Caching

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Caching

fn eq(&self, other: &Caching) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Caching

impl Eq for Caching

impl StructuralPartialEq for Caching