docker volume

VolumeCLI

clone

clone(source, new_volume_name=None, driver=None, labels={}, options={})

Clone a volume.

PARAMETER	DESCRIPTION
source	The volume to clone TYPE: ValidVolume
new_volume_name	The new volume name. If not given, a random name is chosen. TYPE: Optional[str] DEFAULT: None
driver	Specify volume driver name (default "local") TYPE: Optional[str] DEFAULT: None
labels	Set metadata for a volume TYPE: Dict[str, str] DEFAULT: {}
options	Set driver specific options TYPE: Dict[str, str] DEFAULT: {}

Returns

A `python_on_whales.Volume`, the new volume.

copy

copy(source, destination)

Copy files/folders between a volume and the local filesystem.

PARAMETER	DESCRIPTION
source	If source is a directory/file inside a Docker volume, a tuple (my_volume, path_in_volume) must be provided. The volume can be a python_on_whales.Volume or a volume name as str. The path can be a pathlib.Path or a str. If source is a local directory, a pathlib.Path or str should be provided. End the source path with /. if you want to copy the directory content in another directory. TYPE: Union[ValidPath, VolumePath]
destination	Same as source. TYPE: Union[ValidPath, VolumePath]

create

create(volume_name=None, driver=None, labels={}, options={})

Creates a volume

PARAMETER	DESCRIPTION
volume_name	The volume name, if not provided, a long random string will be used instead. TYPE: Optional[str] DEFAULT: None
driver	Specify volume driver name (default "local") TYPE: Optional[str] DEFAULT: None
labels	Set metadata for a volume TYPE: Dict[str, str] DEFAULT: {}
options	Set driver specific options TYPE: Dict[str, str] DEFAULT: {}

exists

exists(x)

Returns True if the volume exists. False otherwise.

It's just calling docker.volume.inspect(...) and verifies that it doesn't throw a python_on_whales.exceptions.NoSuchVolume.

Returns

A `bool`

list

list(filters={})

List volumes

PARAMETER	DESCRIPTION
filters	See the Docker documentation page about filtering . An example filters=dict(dangling=1, driver="local"). TYPE: Dict[str, Union[str, int]] DEFAULT: {}

Returns

`List[python_on_whales.Volume]`

prune

prune(filters={}, all=False)

Remove volumes

PARAMETER	DESCRIPTION
filters	See the Docker documentation page about filtering . An example filters=dict(dangling=1, driver="local"). TYPE: Dict[str, Union[str, int]] DEFAULT: {}
all	Remove all unused volumes, not just anonymous ones. TYPE: bool DEFAULT: False

remove

remove(x)

Removes one or more volumes

PARAMETER	DESCRIPTION
x	A volume or a list of volumes. An empty list as argument means nothing is done. TYPE: Union[ValidVolume, List[ValidVolume]]