#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

#725 in Filesystem

Download history 6/week @ 2024-11-13 16/week @ 2024-11-20 53/week @ 2024-11-27 43/week @ 2024-12-04 62/week @ 2024-12-11 196/week @ 2024-12-18 99/week @ 2024-12-25 38/week @ 2025-01-01 10/week @ 2025-01-08 5/week @ 2025-01-15 92/week @ 2025-01-29 60/week @ 2025-02-05 25/week @ 2025-02-12 20/week @ 2025-02-19 30/week @ 2025-02-26

184 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

~7–15MB
~195K SLoC