docker-pyo3

Python bindings the the rust docker_api crate.

Basic Usage

pip install docker_pyo3

```python

from docker_pyo3 import Docker

Connecto the daemon

docker = Docker()

pull an image

docker.images().pull(image='busybox')

build an image

docker.images().build(path="path/to/dockerfile",dockerfile='Dockerfile',tag='test-image')

run a container

c = docker.containers().create(image='busybox',name='weee') ```

Full api examples can be seen in the py_test folder.

Python has docker already, why does this exist ?

Good question. In short, because this is meant to be built into rust projects that expose python as a plugin interface. If you just need docker in python, use pip install docker, if you just need docker in rust use the docker_api crate. If you need to add a python interface to containers to a rust library/binary via pyo3- this will get you most of the way.

Cool how do i do that ?

See the below example. But basically just follow the instructions in pyo3 to register a module and set the package state. This creates the following namespaces and classes within them - root_module._integrations.docker, Docker - root_module._integrations.image, Image Images - root_module._integrations.container, Container Containers - root_module._integrations.network, Network Networks - root_module._integrations.volume, Volume Volumes

```python

[pymodule]

fn rootmodule(py: Python, m: &PyModule) -> PyResult<()> { pylogger::register(); m.addfunction(wrappyfunction!(main, m)?)?; task::register(py, m)?; utils::register(_py, m)?;

m.add_wrapped(wrap_pymodule!(_integrations))?;

let sys = PyModule::import(_py, "sys")?;
let sys_modules: &PyDict = sys.getattr("modules")?.downcast()?;
sys_modules.set_item("root_module._integrations", m.getattr("_integrations")?)?;
sys_modules.set_item("root_module._integrations.docker", m.getattr("_integrations")?.getattr("docker")?)?;

sys_modules.set_item("root_module._integrations.docker.image", m.getattr("_integrations")?.getattr("docker")?.getattr("image")?)?;
sys_modules.set_item("root_module._integrations.docker.container", m.getattr("_integrations")?.getattr("docker")?.getattr("container")?)?;
sys_modules.set_item("root_module._integrations.docker.network", m.getattr("_integrations")?.getattr("docker")?.getattr("network")?)?;
sys_modules.set_item("root_module._integrations.docker.volume", m.getattr("_integrations")?.getattr("docker")?.getattr("volume")?)?;
Ok(())

}

[pymodule]

fn integrations(py: Python, m:&PyModule) -> PyResult<()>{ m.addwrapped(wrappymodule!(docker))?; Ok(()) }

[pymodule]

fn docker(py: Python, m:&PyModule) -> PyResult<()>{ m.addclass::()?; m.addwrapped(wrappymodule!(dockerpyo3::image::image))?; m.addwrapped(wrappymodule!(dockerpyo3::container::container))?; m.addwrapped(wrappymodule!(dockerpyo3::network::network))?; m.addwrapped(wrappymodule!(dockerpyo3::volume::volume))?; Ok(()) } ```