Struct StorePath 

pub struct StorePath { /* private fields */ }

A path in the Nix store.

Represents a store path that can be realized or queried.

Implementations

impl StorePath

pub fn parse(context: &Arc<Context>, store: &Store, path: &str) -> Result<Self>

Parse a store path string into a StorePath.

Arguments

• context - The Nix context
• store - The store containing the path
• path - The store path string (e.g., "/nix/store/...")

Errors

Returns an error if the path string is not a valid store path.

pub fn name(&self) -> Result<String>

Get the name component of the store path.

Returns the name part of the store path (everything after the hash). For example, for "/nix/store/abc123...-hello-1.0" this returns "hello-1.0".

Errors

Returns an error if the name cannot be retrieved.

pub fn hash_part(&self) -> Result<[u8; 20]>

Get the hash component of the store path as raw bytes.

The 20-byte hash is decoded from the “nix32” encoding in the store path. For example, for "/nix/store/abc123...-hello-1.0" this returns the raw hash bytes corresponding to "abc123...".

Returns

The raw 20-byte hash.

Errors

Returns an error if the hash cannot be retrieved.

pub fn from_parts( context: &Arc<Context>, hash: &[u8; 20], name: &str, ) -> Result<Self>

Create a StorePath from its constituent hash and name parts.

Unlike parse, this does not require a Store reference or the /nix/store prefix.

Arguments

• hash - The 20-byte raw hash (as produced by hash_part).
• name - The name component (e.g., "hello-1.0").

Returns

A new StorePath.

Errors

Returns an error if the path cannot be created.

Trait Implementations

impl Clone for StorePath

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorePath

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

Formats the value using the given formatter.

impl Display for StorePath

Renders the name component only (e.g. hello-1.0), not the canonical /nix/store/<hash>-<name> string.

The Nix C API does not expose a store-directory-aware print function; without a Store handle there is no way to recover the full path. Use Store::print_path (requires the shim feature) when you need the canonical form.

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

Formats the value using the given formatter.

impl Drop for StorePath

fn drop(&mut self)

Executes the destructor for this type.

impl Send for StorePath