Struct Path 

pub struct Path { /* private fields */ }

(path feature) Accepts a filesystem path string.

Format checks (absolute/relative, extension) never touch the filesystem. The existence, kind, and permission checks do, and only when explicitly requested. readable/writable consult OS permission flags where available; where the OS exposes no such flag the check is a no-op that accepts.

Implementations

impl Path

pub fn with_meta(self, meta: Meta) -> Self

Attach human-facing metadata (name, description, examples, default, output conversion).

pub fn new() -> Self

pub fn absolute(self) -> Self

pub fn relative(self) -> Self

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

Require the path to end in one of the allowed extensions (compared case-insensitively).

pub fn must_exist(self) -> Self

Require the path to exist on the filesystem.

pub fn kind(self, kind: PathKind) -> Self

Require the path to point at the given kind of entry (implies existence).

pub fn readable(self) -> Self

Require the path to be readable (implies existence).

pub fn writable(self) -> Self

Require the path to be writable (implies existence).

impl Path

pub fn name(&self) -> &str

The human-readable name.

pub fn description(&self) -> Option<&str>

The description, if any.

pub fn examples(&self) -> &[(Value, Option<String>)]

The example values (each with an optional note).

pub fn default_value(&self) -> Option<&Value>

The default value, if any.

pub fn convert(&self) -> Option<ValueType>

The output conversion target, if any.

pub fn with_name(self, name: impl Into<String>) -> Self

Set the human-readable name (surfaced in error messages).

pub fn with_description(self, text: impl Into<String>) -> Self

Attach a human-readable description.

pub fn with_example(self, value: impl Into<Value>) -> Self

Add an example value.

pub fn with_example_noted( self, value: impl Into<Value>, note: impl Into<String>, ) -> Self

Add an example value with an explanatory note.

pub fn with_default(self, value: impl Into<Value>) -> Self

Set the default value used as an on-error fallback (see the pipeline’s validate stage).

pub fn to_string(self) -> Self

After validation succeeds, cast the value to a string.

pub fn to_int(self) -> Self

After validation succeeds, cast the value to an integer.

pub fn to_float(self) -> Self

After validation succeeds, cast the value to a float.

pub fn to_bool(self) -> Self

After validation succeeds, cast the value to a boolean.

Trait Implementations

impl Clone for Path

fn clone(&self) -> Path

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Path

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

Formats the value using the given formatter.

impl Default for Path

fn default() -> Path

Returns the “default value” for a type.

impl Validator for Path

fn meta(&self) -> &Meta

This validator’s human-facing metadata.

fn meta_mut(&mut self) -> &mut Meta

Mutable access to this validator’s metadata (backs the builder setters).

fn check(&self, value: &mut Value) -> Result<(), Error>

The validation rule: check (and coerce) value in place.

fn validate(&self, value: &mut Value) -> Result<(), Error>

Run check; on error attach this validator’s Meta (innermost wins); on success apply the output conversion in meta().convert, if any.