tsarevvv/rust-ipfs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9e948f943f
rust-ipfs/unixfs
History
Joonas Koivunen 9e948f943f perf: render Cids to bytes without allocating a Vec 
not sure how much sense does this make, given that the byte writing fns
might be less inlined. would be nice to have some benchmarks.

this also adds a test to verify directory cid when using cidv1 even
though it's quite unclear to me if those are allowed in unixfs dirs.
2020-08-07 15:06:55 +03:00
..
examples Split Entry into two different enums 2020-07-31 08:39:47 -03:00
src perf: render Cids to bytes without allocating a Vec 2020-08-07 15:06:55 +03:00
Cargo.toml Update filetime 2020-08-03 14:47:17 -03:00
CHANGELOG.md chore: changelog 2020-07-03 12:20:58 +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

README.md

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.