Pyo3Plugin

Struct Pyo3Plugin 

Source
pub struct Pyo3Plugin { /* private fields */ }
Expand description

Represents an individual Docker plugin.

Provides methods to inspect, enable, disable, and manage plugins.

Implementations§

Source§

impl Pyo3Plugin

Source

pub fn new(docker: Pyo3Docker, name: &str) -> Self

Source

pub fn name(&self) -> String

Get the plugin name.

Returns: str: Plugin name

Source

pub fn inspect(&self) -> PyResult<Py<PyAny>>

Inspect the plugin to get detailed information.

Returns: dict: Detailed plugin information including: - id: Plugin ID - name: Plugin name - enabled: Whether the plugin is enabled - settings: Plugin settings (mounts, env, args, devices) - plugin_reference: Plugin reference - config: Full plugin configuration

Raises: SystemError: If the operation fails

Source

pub fn enable(&self, timeout: Option<u64>) -> PyResult<()>

Enable the plugin.

Enables a previously disabled plugin so it can be used by Docker.

Args: timeout: Timeout in seconds to wait for enable (optional)

Returns: None

Raises: SystemError: If the plugin cannot be enabled

Source

pub fn disable(&self) -> PyResult<()>

Disable the plugin.

Disables a running plugin. The plugin must be disabled before it can be removed.

Returns: None

Raises: SystemError: If the plugin cannot be disabled

Source

pub fn remove(&self) -> PyResult<Py<PyAny>>

Remove (delete) the plugin.

Removes the plugin from Docker. The plugin must be disabled first. Use force_remove() to remove an enabled plugin.

Returns: dict: Information about the removed plugin

Raises: SystemError: If the plugin cannot be removed (e.g., still enabled)

Source

pub fn force_remove(&self) -> PyResult<Py<PyAny>>

Forcefully remove the plugin.

Removes the plugin from Docker, even if it’s currently enabled.

Returns: dict: Information about the removed plugin

Raises: SystemError: If the plugin cannot be removed

Source

pub fn push(&self) -> PyResult<()>

Push the plugin to a registry.

Pushes the plugin to the registry specified in the plugin name.

Returns: None

Raises: SystemError: If the push fails

Source

pub fn create(&self, path: &str) -> PyResult<()>

Create a plugin from a tar archive.

Creates a new plugin from a tar archive containing the plugin’s rootfs directory and config.json manifest.

Args: path: Path to the tar archive containing plugin rootfs and manifest

Returns: None

Raises: SystemError: If plugin creation fails

Trait Implementations§

Source§

impl Debug for Pyo3Plugin

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'py> IntoPyObject<'py> for Pyo3Plugin

Source§

type Target = Pyo3Plugin

The Python output type
Source§

type Output = Bound<'py, <Pyo3Plugin as IntoPyObject<'py>>::Target>

The smart pointer type to use. Read more
Source§

type Error = PyErr

The type returned in the event of a conversion error.
Source§

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.
Source§

impl PyClass for Pyo3Plugin

Source§

type Frozen = False

Whether the pyclass is frozen. Read more
Source§

impl PyClassImpl for Pyo3Plugin

Source§

const IS_BASETYPE: bool = false

#[pyclass(subclass)]
Source§

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]
Source§

const IS_MAPPING: bool = false

#[pyclass(mapping)]
Source§

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]
Source§

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]
Source§

const RAW_DOC: &'static CStr = /// Represents an individual Docker plugin. /// /// Provides methods to inspect, enable, disable, and manage plugins.

Docstring for the class provided on the struct or enum. Read more
Source§

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined. Read more
Source§

type BaseType = PyAny

Base class
Source§

type ThreadChecker = SendablePyClass<Pyo3Plugin>

This handles following two situations: Read more
Source§

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

Immutable or mutable
Source§

type Dict = PyClassDummySlot

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

type WeakRef = PyClassDummySlot

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

type BaseNativeType = PyAny

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

fn items_iter() -> PyClassItemsIter

Source§

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

Source§

fn dict_offset() -> Option<isize>

Source§

fn weaklist_offset() -> Option<isize>

Source§

impl PyClassNewTextSignature for Pyo3Plugin

Source§

const TEXT_SIGNATURE: &'static str = "(docker, name)"

Source§

impl PyMethods<Pyo3Plugin> for PyClassImplCollector<Pyo3Plugin>

Source§

fn py_methods(self) -> &'static PyClassItems

Source§

impl PyTypeInfo for Pyo3Plugin

Source§

const NAME: &'static str = "Plugin"

Class name.
Source§

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.
Source§

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.
Source§

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.
Source§

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.
Source§

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.
Source§

impl DerefToPyAny for Pyo3Plugin

Source§

impl ExtractPyClassWithClone for Pyo3Plugin

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<'py, T> IntoPyObjectExt<'py> for T
where T: IntoPyObject<'py>,

Source§

fn into_bound_py_any(self, py: Python<'py>) -> Result<Bound<'py, PyAny>, PyErr>

Converts self into an owned Python object, dropping type information.
Source§

fn into_py_any(self, py: Python<'py>) -> Result<Py<PyAny>, PyErr>

Converts self into an owned Python object, dropping type information and unbinding it from the 'py lifetime.
Source§

fn into_pyobject_or_pyerr(self, py: Python<'py>) -> Result<Self::Output, PyErr>

Converts self into a Python object. Read more
Source§

impl<T> PyErrArguments for T
where T: for<'py> IntoPyObject<'py> + Send + Sync,

Source§

fn arguments(self, py: Python<'_>) -> Py<PyAny>

Arguments for exception
Source§

impl<T> PyTypeCheck for T
where T: PyTypeInfo,

Source§

const NAME: &'static str = T::NAME

👎Deprecated since 0.27.0: Use ::classinfo_object() instead and format the type name at runtime. Note that using built-in cast features is often better than manual PyTypeCheck usage.
Name of self. This is used in error messages, for example.
Source§

fn type_check(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of Self, which may include a subtype. Read more
Source§

fn classinfo_object(py: Python<'_>) -> Bound<'_, PyAny>

Returns the expected type as a possible argument for the isinstance and issubclass function. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> Ungil for T
where T: Send,