Struct hermes_ipfs::IpfsPath

pub struct IpfsPath {
    root: PathRoot,
    pub(crate) path: SlashedPath,
}

Enum for specifying paths in IPFS. Abstraction over Ipfs paths, which are used to target sub-trees or sub-documents on top of content addressable (Cid) trees. The most common use case is to specify a file under an unixfs tree from underneath a Cid forest.

In addition to being based on content addressing, IpfsPaths provide adaptation from other Ipfs (related) functionality which can be resolved to a Cid such as IPNS. IpfsPaths have similar structure to and can start with a “protocol” as Multiaddr, except the protocols are different, and at the moment there can be at most one protocol.

This implementation supports:

• synonymous /ipfs and /ipld prefixes to point to a Cid
• /ipns to point to either:
  • PeerId to signify an IPNS DHT record
  • domain name to signify an DNSLINK reachable record

See crate::Ipfs::resolve_ipns for the current IPNS resolving capabilities.

IpfsPath is usually created through the FromStr or From conversions.

Fields

root: PathRoot

path: SlashedPath

Implementations

impl IpfsPath

pub fn new(root: PathRoot) -> IpfsPath

Creates a new IpfsPath from a [PathRoot].

pub fn root(&self) -> &PathRoot

Returns the [PathRoot] “protocol” configured for the IpfsPath.

pub fn sub_path(&self, segments: &str) -> Result<IpfsPath, Error>

Returns a new IpfsPath with the given path segments appended, or an error, if a segment is invalid.

pub fn iter(&self) -> impl Iterator<Item = &str>

Returns an iterator over the path segments following the root.

Trait Implementations

impl Clone for IpfsPath

fn clone(&self) -> IpfsPath

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IpfsPath

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

Formats the value using the given formatter.

impl Display for IpfsPath

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

Formats the value using the given formatter.

impl From<GetIpfsFile> for IpfsPath

fn from(value: GetIpfsFile) -> Self

Converts to this type from the input type.

impl From<IpfsPath> for GetIpfsFile

fn from(value: IpfsPath) -> Self

Converts to this type from the input type.

impl<T> From<T> for IpfsPath

where T: Into<PathRoot>,

fn from(root: T) -> IpfsPath

Converts to this type from the input type.

impl FromStr for IpfsPath

type Err = Error

The associated error which can be returned from parsing.

fn from_str(string: &str) -> Result<IpfsPath, Error>

Parses a string s to return a value of this type.

impl Hash for IpfsPath

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for IpfsPath

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<&str> for IpfsPath

type Error = Error

The type returned in the event of a conversion error.

fn try_from( string: &str, ) -> Result<IpfsPath, <IpfsPath as TryFrom<&str>>::Error>

Performs the conversion.

impl Eq for IpfsPath

impl StructuralPartialEq for IpfsPath