rust-ipfs/unixfs
2020-06-24 10:25:39 +03:00
..
examples refactor: suggestions from code review 2020-06-17 17:27:05 +03:00
src refactor: remove/cfg(test) unused of FileReader 2020-06-24 10:25:39 +03:00
Cargo.toml add(unixfs): repository, description, readme 2020-06-18 20:41:32 +03:00
CHANGELOG.md add(unixfs): initial CHANGELOG.md 2020-06-18 20:24:57 +03:00
pb-rs-gen.sh fix: remove --owned from pb-rs gen 2020-06-08 15:03:34 +03:00
README.md chore(unixfs): README, license notes, set version to 0.0.1 2020-06-18 20:24:57 +03:00

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

  • first iteration of file reader has been implemented
  • first iteration of resolving IpfsPath segments through directories has been implemented
    • as the HAMTShard structure is not fully understood, all buckets are searched, however the API is expected to remain the same even if more efficient lookup is implemented
  • first iteration of /get-like tree walking implemented
  • creation and alteration of dags has not been implemented

Usage

  • The main entry point to walking anything unixfs should be ipfs_unixfs::walk::Walker
  • The main entry point to resolving links under dag-pb or unixfs should be ipfs_unixfs::resolve
  • There is a ipfs_unixfs::file::visit::FileVisit utility but it should be considered superceded by ipfs_unixfs::walk::Walker

License

MIT or APL2.