Struct unixfs_v1::file::visit::FileVisit

pub struct FileVisit { /* fields omitted */ }

FileVisit represents an ongoing visitation over an UnixFs File tree.

The file visitor does not implement size validation of merkledag links at the moment. This could be implmented with generational storage and it would require an u64 per link.

Note: For easier to use interface, you should consider using ipfs_unixfs::walk::Walker. It uses IdleFileVisit and FileVisit internally but has a better API.

Implementations

impl FileVisit

pub fn pending_links(&self) -> (&Cid, impl Iterator<Item = &Cid>)

Access hashes of all pending links for prefetching purposes. The block for the first item returned by this method is the one which needs to be processed next with continue_walk.

Returns tuple of the next Cid which needs to be processed and an iterator over the remaining.

pub fn continue_walk<'a>(
    self,
    next: &'a [u8],
    cache: &mut Option<Cache>
) -> Result<(&'a [u8], Option<Self>), FileReadFailed>

Continues the walk with the data for the first pending_link key.

Returns on success a tuple of bytes and new version of FileVisit to continue the visit, when there is something more to visit.

pub fn file_size(&self) -> u64

Returns the total size of the file in bytes.

Trait Implementations

impl AsRef<Metadata> for FileVisit

fn as_ref(&self) -> &Metadata

Performs the conversion.

impl Debug for FileVisit

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

Formats the value using the given formatter.