Struct pyo3::prelude::PyModule

#[repr(transparent)]pub struct PyModule(_, _);

Represents a Python module object.

Implementations

impl PyModule

pub fn new<'p>(py: Python<'p>, name: &str) -> PyResult<&'p PyModule>

Creates a new module object with the __name__ attribute set to name.

pub fn import<'p>(py: Python<'p>, name: &str) -> PyResult<&'p PyModule>

Imports the Python module with the specified name.

pub fn from_code<'p>(
    py: Python<'p>,
    code: &str,
    file_name: &str,
    module_name: &str
) -> PyResult<&'p PyModule>

Loads the Python code specified into a new module.

code is the raw Python you want to load into the module. file_name is the file name to associate with the module (this is used when Python reports errors, for example). module_name is the name to give the module.

pub fn dict(&self) -> &PyDict

Return the dictionary object that implements module's namespace; this object is the same as the __dict__ attribute of the module object.

pub fn index(&self) -> PyResult<&PyList>

Return the index (__all__) of the module, creating one if needed.

pub fn name(&self) -> PyResult<&str>

Returns the module's name.

May fail if the module does not have a __name__ attribute.

pub fn filename(&self) -> PyResult<&str>

Returns the module's filename.

May fail if the module does not have a __file__ attribute.

pub fn call(
    &self,
    name: &str,
    args: impl IntoPy<Py<PyTuple>>,
    kwargs: Option<&PyDict>
) -> PyResult<&PyAny>

Calls a function in the module.

This is equivalent to the Python expression module.name(*args, **kwargs).

pub fn call1(
    &self,
    name: &str,
    args: impl IntoPy<Py<PyTuple>>
) -> PyResult<&PyAny>

Calls a function in the module with only positional arguments.

This is equivalent to the Python expression module.name(*args).

pub fn call0(&self, name: &str) -> PyResult<&PyAny>

Calls a function in the module without arguments.

This is equivalent to the Python expression module.name().

pub fn get(&self, name: &str) -> PyResult<&PyAny>

Gets a member from the module.

This is equivalent to the Python expression module.name.

pub fn add<V>(&self, name: &str, value: V) -> PyResult<()> where
    V: ToPyObject, 

Adds a member to the module.

This is a convenience function which can be used from the module's initialization function.

pub fn add_class<T>(&self) -> PyResult<()> where
    T: PyClass, 

Adds a new extension type to the module.

This is a convenience function that initializes the class, sets new_type.__module__ to this module's name, and adds the type to this module.

pub fn add_wrapped(&self, wrapper: &impl Fn(Python) -> PyObject) -> PyResult<()>

Adds a function or a (sub)module to a module, using the functions name as name.

Use this together with the#[pyfunction] and wrap_pyfunction! or #[pymodule] and wrap_pymodule!.

m.add_wrapped(wrap_pyfunction!(double));
m.add_wrapped(wrap_pymodule!(utils));

You can also add a function with a custom name using add:

m.add("also_double", wrap_pyfunction!(double)(py));

Trait Implementations

impl AsPyPointer for PyModule

fn as_ptr(&self) -> *mut PyObject

Gets the underlying FFI pointer, returns a borrowed pointer.

impl AsRef<PyAny> for PyModule

fn as_ref(&self) -> &PyAny

Performs the conversion.

impl Debug for PyModule

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

Formats the value using the given formatter.

impl Display for PyModule

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

Formats the value using the given formatter.

impl<'a> From<&'a PyModule> for &'a PyAny

fn from(ob: &'a PyModule) -> Self

Performs the conversion.

impl<'py> FromPyObject<'py> for &'py PyModule

fn extract(obj: &'py PyAny) -> PyResult<Self>

Extracts Self from the source PyObject.

impl PartialEq<PyModule> for PyModule

fn eq(&self, o: &PyModule) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PyLayout<PyModule> for PyObject

const IS_NATIVE_TYPE: bool

fn get_super(&mut self) -> Option<&mut T::BaseLayout>

unsafe fn py_init(&mut self, _value: T)

unsafe fn py_drop(&mut self, _py: Python)

impl PyNativeType for PyModule

fn py(&self) -> Python

impl PyTypeInfo for PyModule

type Type = ()

Type of objects to store in PyObject struct

type BaseType = PyAny

Base class

type Layout = PyObject

Layout

type BaseLayout = PyObject

Layout of Basetype.

type Initializer = PyNativeTypeInitializer<Self>

Initializer for layout

type AsRefTarget = Self

Utility type to make AsPyRef work

const NAME: &'static str

Class name

const MODULE: Option<&'static str>

Module name, if any

fn type_object() -> &'static PyTypeObject

PyTypeObject instance for this type.

fn is_instance(ptr: &PyAny) -> bool

Check if *mut ffi::PyObject is instance of this type

const DESCRIPTION: &'static str

Class doc string

const FLAGS: usize

Type flags (ie PY_TYPE_FLAG_GC, PY_TYPE_FLAG_WEAKREF)

fn is_exact_instance(object: &PyAny) -> bool

Check if *mut ffi::PyObject is exact instance of this type

impl ToPyObject for PyModule

fn to_object(&self, py: Python) -> PyObject

Converts self into a Python object.