Struct Volume 

pub struct Volume { /* private fields */ }

One application-level volume declaration.

Implementations

impl Volume

pub const fn new(name: Identifier, ownership: ResourceOwnership) -> Self

Creates a volume declaration without inferring native defaults or names.

pub const fn name(&self) -> &Identifier

Returns the neutral resource name.

pub const fn ownership(&self) -> ResourceOwnership

Returns the resource lifecycle owner.

pub fn set_runtime_name(&mut self, name: Sourced<ProtectedString>)

Sets the explicit runtime name, distinct from the logical resource key.

pub const fn runtime_name(&self) -> Option<&Sourced<ProtectedString>>

Returns the explicit provider/runtime name.

pub fn set_service_name(&mut self, name: Sourced<ProtectedString>)

Sets the explicit service-manager unit name without changing its spelling.

pub const fn service_name(&self) -> Option<&Sourced<ProtectedString>>

Returns the explicit service-manager unit name.

pub fn set_driver(&mut self, driver: Sourced<ProtectedString>)

Sets the source-authored volume driver spelling.

pub const fn driver(&self) -> Option<&Sourced<ProtectedString>>

Returns the explicit volume driver spelling.

pub fn set_device(&mut self, device: Sourced<ProtectedString>)

Sets the source-authored local-driver device spelling.

pub const fn device(&self) -> Option<&Sourced<ProtectedString>>

Returns the explicit local-driver device spelling.

pub fn set_volume_type(&mut self, volume_type: Sourced<ProtectedString>)

Sets the source-authored local-driver type spelling.

pub const fn volume_type(&self) -> Option<&Sourced<ProtectedString>>

Returns the explicit local-driver type spelling.

pub fn set_options(&mut self, options: Sourced<ProtectedString>)

Sets the explicit singleton local-driver options spelling.

This is intentionally not a generic option bag: it retains the reviewed Options= setting, including the Compose local-driver driver_opts.o mapping.

pub const fn options(&self) -> Option<&Sourced<ProtectedString>>

Returns the explicit singleton local-driver options spelling.

pub fn set_labels(&mut self, labels: Vec<Sourced<MetadataLabel>>)

Sets metadata labels, retaining omission separately from an explicit empty reset.

pub fn set_labels_with_origins( &mut self, labels: Vec<Sourced<MetadataLabel>>, origins: Vec<Provenance>, )

Sets metadata labels with collection-level provenance.

pub fn add_label(&mut self, label: Sourced<MetadataLabel>)

Appends one metadata label in source order.

pub fn labels(&self) -> Option<&[Sourced<MetadataLabel>]>

Returns metadata labels in authored order, preserving omitted versus explicit-empty state.

pub fn labels_origins(&self) -> &[Provenance]

Returns collection-level label provenance.

pub fn set_copy(&mut self, copy: Sourced<bool>)

Sets the explicit copy choice without inferring an omitted source default.

pub const fn copy(&self) -> Option<&Sourced<bool>>

Returns the explicit copy choice.

pub fn set_containers_conf_modules( &mut self, values: Vec<Sourced<ProtectedString>>, )

Sets ordered protected containers.conf modules, retaining an explicit empty reset.

pub fn set_containers_conf_modules_with_origins( &mut self, values: Vec<Sourced<ProtectedString>>, origins: Vec<Provenance>, )

Sets ordered protected containers.conf modules with collection-level provenance.

pub fn containers_conf_modules(&self) -> Option<&[Sourced<ProtectedString>]>

Returns protected containers.conf modules in authored order, if explicitly present.

pub fn containers_conf_modules_origins(&self) -> &[Provenance]

Returns collection-level containers.conf module provenance.

pub fn set_global_args(&mut self, values: Vec<Sourced<ProtectedString>>)

Sets ordered protected global arguments, retaining an explicit empty reset.

pub fn set_global_args_with_origins( &mut self, values: Vec<Sourced<ProtectedString>>, origins: Vec<Provenance>, )

Sets ordered protected global arguments with collection-level provenance.

pub fn global_args(&self) -> Option<&[Sourced<ProtectedString>]>

Returns protected global arguments in authored order, if explicitly present.

pub fn global_args_origins(&self) -> &[Provenance]

Returns collection-level global-argument provenance.

pub fn set_podman_args(&mut self, values: Vec<Sourced<ProtectedString>>)

Sets ordered protected raw Podman arguments authored by the source.

These arguments are evidence only. Adapters must not synthesize them from typed settings.

pub fn set_podman_args_with_origins( &mut self, values: Vec<Sourced<ProtectedString>>, origins: Vec<Provenance>, )

Sets raw Podman arguments with collection-level provenance.

pub fn podman_args(&self) -> Option<&[Sourced<ProtectedString>]>

Returns source-authored raw Podman arguments in order, if explicitly present.

pub fn podman_args_origins(&self) -> &[Provenance]

Returns collection-level raw-Podman-argument provenance.

pub fn set_user(&mut self, user: Sourced<ProtectedString>)

Sets the source-authored volume user identity.

pub const fn user(&self) -> Option<&Sourced<ProtectedString>>

Returns the source-authored volume user identity.

pub fn set_group(&mut self, group: Sourced<ProtectedString>)

Sets the source-authored volume group identity.

pub const fn group(&self) -> Option<&Sourced<ProtectedString>>

Returns the source-authored volume group identity.

pub fn set_uid(&mut self, uid: Sourced<ProtectedString>)

Sets the source-authored numeric user-ID spelling.

pub const fn uid(&self) -> Option<&Sourced<ProtectedString>>

Returns the source-authored numeric user-ID spelling.

pub fn set_gid(&mut self, gid: Sourced<ProtectedString>)

Sets the source-authored numeric group-ID spelling.

pub const fn gid(&self) -> Option<&Sourced<ProtectedString>>

Returns the source-authored numeric group-ID spelling.

pub fn set_image_source( &mut self, image_source: Sourced<VolumeImageSource>, ) -> Result<(), ModelError>

Sets the explicitly selected image source for an image-backed volume.

Artifact references are checked by Application::validate_image_artifact_references after a complete application graph has been assembled.

Errors

Returns ModelError::EmptyValue or ModelError::ContainsNul for an invalid literal image source.

pub const fn image_source(&self) -> Option<&Sourced<VolumeImageSource>>

Returns the explicitly selected image source for an image-backed volume.

Trait Implementations

impl Clone for Volume

fn clone(&self) -> Volume

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Volume

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

Formats the value using the given formatter.

impl Eq for Volume

impl PartialEq for Volume

fn eq(&self, other: &Volume) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Volume