#tree #ipfs #unix-fs #file-tree #traversal #unix-f

rust-unixfs

UnixFs tree support

11 releases

0.5.0 Sep 27, 2024
0.4.1 Feb 19, 2024
0.4.0 Aug 26, 2023
0.3.2 Jul 17, 2023
0.3.0-alpha Dec 8, 2022

#639 in Filesystem

Download history 7/week @ 2024-08-22 38/week @ 2024-08-29 15/week @ 2024-09-05 13/week @ 2024-09-12 64/week @ 2024-09-19 205/week @ 2024-09-26 75/week @ 2024-10-03 59/week @ 2024-10-10 56/week @ 2024-10-17 11/week @ 2024-10-24 9/week @ 2024-10-31 2/week @ 2024-11-07 8/week @ 2024-11-14 21/week @ 2024-11-21 52/week @ 2024-11-28 32/week @ 2024-12-05

113 downloads per month
Used in 4 crates (3 directly)

MIT/Apache

220KB
4.5K SLoC

ipfs-unixfs

Goals

  • blockstore API independent way to traverse the merkledag
    • the core read API does not deal with loading blocks
    • instead access to interesting Cids is given

Status

  • unfiltered walking of known unixfs trees
  • creation of balanced file trees
  • creation of non HAMT-sharded directory trees

See the docs at https://docs.rs/ipfs-unixfs.

License

MIT or APL2.


lib.rs:

ipfs-unixfs: UnixFs tree support in Rust.

The crate aims to provide a blockstore implementation independent of the UnixFs implementation by working on slices and not doing any IO operations.

The main entry point for extracting information and/or data out of UnixFs trees is ipfs_unixfs::walk::Walker. To resolve IpfsPath segments over dag-pb nodes, ipfs_unixfs::resolve should be used.

Dependencies

~6–13MB
~165K SLoC