#[repr(transparent)]pub struct PyModule(PyAny);
Expand description
Represents a Python module
object.
As with all other Python objects, modules are first class citizens. This means they can be passed to or returned from functions, created dynamically, assigned to variables and so forth.
Tuple Fields§
§0: PyAny
Implementations§
source§impl PyModule
impl PyModule
sourcepub fn new_bound<'py>(
py: Python<'py>,
name: &str
) -> PyResult<Bound<'py, PyModule>>
pub fn new_bound<'py>( py: Python<'py>, name: &str ) -> PyResult<Bound<'py, PyModule>>
Creates a new module object with the __name__
attribute set to name
.
§Examples
use pyo3::prelude::*;
Python::with_gil(|py| -> PyResult<()> {
let module = PyModule::new_bound(py, "my_module")?;
assert_eq!(module.name()?.to_cow()?, "my_module");
Ok(())
})?;
sourcepub fn import_bound<N>(py: Python<'_>, name: N) -> PyResult<Bound<'_, PyModule>>
pub fn import_bound<N>(py: Python<'_>, name: N) -> PyResult<Bound<'_, PyModule>>
Imports the Python module with the specified name.
§Examples
use pyo3::prelude::*;
Python::with_gil(|py| {
let module = PyModule::import_bound(py, "antigravity").expect("No flying for you.");
});
This is equivalent to the following Python expression:
import antigravity
sourcepub fn from_code_bound<'py>(
py: Python<'py>,
code: &str,
file_name: &str,
module_name: &str
) -> PyResult<Bound<'py, PyModule>>
pub fn from_code_bound<'py>( py: Python<'py>, code: &str, file_name: &str, module_name: &str ) -> PyResult<Bound<'py, PyModule>>
Creates and loads a module named module_name
,
containing the Python code passed to code
and pretending to live at file_name
.
⚠ ️
Warning: This will compile and execute code. Never pass untrusted code to this function!
§Errors
Returns PyErr
if:
code
is not syntactically correct Python.- Any Python exceptions are raised while initializing the module.
- Any of the arguments cannot be converted to
CString
s.
§Example: bundle in a file at compile time with include_str!
:
use pyo3::prelude::*;
// This path is resolved relative to this file.
let code = include_str!("../../assets/script.py");
Python::with_gil(|py| -> PyResult<()> {
PyModule::from_code_bound(py, code, "example.py", "example")?;
Ok(())
})?;
§Example: Load a file at runtime with std::fs::read_to_string
.
use pyo3::prelude::*;
// This path is resolved by however the platform resolves paths,
// which also makes this less portable. Consider using `include_str`
// if you just want to bundle a script with your module.
let code = std::fs::read_to_string("assets/script.py")?;
Python::with_gil(|py| -> PyResult<()> {
PyModule::from_code_bound(py, &code, "example.py", "example")?;
Ok(())
})?;
Ok(())
Methods from Deref<Target = PyAny>§
#[doc(hidden)] pub const _PYO3_DEF: AddTypeToModule<Self> = _
Trait Implementations§
source§impl AsPyPointer for PyModule
impl AsPyPointer for PyModule
source§impl PyTypeInfo for PyModule
impl PyTypeInfo for PyModule
source§const NAME: &'static str = "PyModule"
const NAME: &'static str = "PyModule"
Available on non-crate feature
gil-refs
only.Class name.
source§const MODULE: Option<&'static str> = _
const MODULE: Option<&'static str> = _
Available on non-crate feature
gil-refs
only.Module name, if any.
source§fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject
Available on non-crate feature
gil-refs
only.Returns the PyTypeObject instance for this type.
source§fn is_type_of_bound(obj: &Bound<'_, PyAny>) -> bool
fn is_type_of_bound(obj: &Bound<'_, PyAny>) -> bool
Available on non-crate feature
gil-refs
only.Checks if
object
is an instance of this type or a subclass of this type.impl DerefToPyAny for PyModule
Auto Trait Implementations§
impl !Freeze for PyModule
impl !RefUnwindSafe for PyModule
impl !Send for PyModule
impl !Sync for PyModule
impl Unpin for PyModule
impl UnwindSafe for PyModule
Blanket Implementations§
source§impl<T> AssertNotZeroSized for T
impl<T> AssertNotZeroSized for T
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more