Trait pyo3::impl_::pyclass::PyClassImpl

pub trait PyClassImpl: Sized + 'static {
    type BaseType: PyTypeInfo + PyClassBaseType;
    type PyClassMutability: PyClassMutability + GetBorrowChecker<Self>;
    type Dict: PyClassDict;
    type WeakRef: PyClassWeakRef;
    type BaseNativeType: PyTypeInfo + PyNativeType;
    type ThreadChecker: PyClassThreadChecker<Self>;

    const IS_BASETYPE: bool = false;
    const IS_SUBCLASS: bool = false;
    const IS_MAPPING: bool = false;
    const IS_SEQUENCE: bool = false;

    // Required methods
    fn doc(py: Python<'_>) -> PyResult<&'static CStr>;
    fn items_iter() -> PyClassItemsIter ;
    fn lazy_type_object() -> &'static LazyTypeObject<Self>;

    // Provided methods
    fn dict_offset() -> Option<Py_ssize_t> { ... }
    fn weaklist_offset() -> Option<Py_ssize_t> { ... }
}

Implements the underlying functionality of #[pyclass], assembled by various proc macros.

Users are discouraged from implementing this trait manually; it is a PyO3 implementation detail and may be changed at any time.

Required Associated Types

type BaseType: PyTypeInfo + PyClassBaseType

Base class

type PyClassMutability: PyClassMutability + GetBorrowChecker<Self>

Immutable or mutable

type Dict: PyClassDict

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

type WeakRef: PyClassWeakRef

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

type BaseNativeType: PyTypeInfo + PyNativeType

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

type ThreadChecker: PyClassThreadChecker<Self>

This handles following two situations:

1. In case T is Send, stub ThreadChecker is used and does nothing. This implementation is used by default. Compile fails if T: !Send.
2. In case T is !Send, ThreadChecker panics when T is accessed by another thread. This implementation is used when #[pyclass(unsendable)] is given. Panicking makes it safe to expose T: !Send to the Python interpreter, where all objects can be accessed by multiple threads by threading module.

Provided Associated Constants

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)]

Required Methods

fn doc(py: Python<'_>) -> PyResult<&'static CStr>

Rendered class doc

fn items_iter() -> PyClassItemsIter

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

Provided Methods

fn dict_offset() -> Option<Py_ssize_t>

fn weaklist_offset() -> Option<Py_ssize_t>

Object Safety

This trait is not object safe.

Implementors

impl PyClassImpl for Coroutine

Available on crate feature experimental-async only.

const IS_BASETYPE: bool = false

const IS_SUBCLASS: bool = false

const IS_MAPPING: bool = false

const IS_SEQUENCE: bool = false

type BaseType = PyAny

type ThreadChecker = SendablePyClass<Coroutine>

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

type Dict = PyClassDummySlot

type WeakRef = PyClassDummySlot

type BaseNativeType = PyAny