Struct ServiceDefinitionBuilder 

pub struct ServiceDefinitionBuilder { /* private fields */ }

Builder for ServiceDefinition.

Mirrors the v1 super::super::builders::ServiceDefinitionBuilder API verbatim so consumers can swap use paths and keep the same call sites. v2 ships the same launcher + isolation field set as v1 (slice 22 of zccache#782) plus the v2-only HTTP capability slot.

Implementations

impl ServiceDefinitionBuilder

pub fn shared_broker( service_name: impl Into<String>, binary_path: impl Into<String>, ) -> Self

Start a builder for a service that opts in to the per-user shared broker (the common case for first-party tools).

service_name must satisfy validate_service_name (already enforced by write_service_definition_v2 at install time; the builder itself is permissive so a caller can finish constructing then validate once).

pub fn private_broker( service_name: impl Into<String>, binary_path: impl Into<String>, ) -> Self

Start a builder for a service that uses a private per-service broker (the default — safest for third-party consumers).

pub fn explicit_instance( service_name: impl Into<String>, binary_path: impl Into<String>, instance: impl Into<String>, ) -> Self

Start a builder pinned to a named broker instance (e.g. "ci-trusted" / "ci-untrusted").

pub fn per_version_binary_dir(self, dir: impl Into<String>) -> Self

Pin the canonicalized binary-directory allow-list root.

pub fn min_version(self, version: impl Into<String>) -> Self

Set the semver floor; broker refuses Hello below this.

pub fn version_allow_list<I, S>(self, versions: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Pin to a strict allow-list of versions.

pub fn label(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add a key/value label.

pub fn build(self) -> ServiceDefinition

Finalize into a ServiceDefinition. Does not validate; call write_service_definition_v2 to validate + install.

pub fn install_in(self, root: &Path) -> Result<PathBuf, ServiceDefinitionError>

Install into a specific service-definition directory. Equivalent to write_service_definition_v2(root, &self.build()).

Errors

See write_service_definition_v2.

pub fn install(self) -> Result<PathBuf, ServiceDefinitionError>

Install into the platform’s default v2 service-definition directory (service_definition_dir_v2).

Errors

See write_service_definition_v2.

Trait Implementations

impl Clone for ServiceDefinitionBuilder

fn clone(&self) -> ServiceDefinitionBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceDefinitionBuilder

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

Formats the value using the given formatter.