rhizome

Rhizome is an in-development database for use in building local-first applications over a content addressable store, like IPFS.

• Rhizome
• Outline
• Crates
• Usage
• Testing the Project
• Benchmarking the Project
• Setting-up rhizome-wasm
• Contributing
  • Nix
  • Formatting
  • Pre-commit Hook
  • Recommended Development Flow
  • Conventional Commits
• Getting Help
• External Resources
• License
  • Contribution

• rhizome
• rhizome-wasm

• Add the following to the [dependencies] section of your Cargo.toml file for using the rust-only rhizome crate/workspace:

rhizome = "0.1.0"

• Add the following to the [dependencies] section of your Cargo.toml file for using rhizome-wasm crate/workspace:

rhizome-wasm = "0.1.0"

• Run tests for crate/workspace rhizome:

  cd rhizome && cargo test --all-features

• To run tests for crate/workspace rhizome-wasm, follow the instructions in rhizome-wasm, which leverages wasm-pack.

For benchmarking and measuring performance, this workspaces provides a Rust-specific benchmarking package leveraging criterion and a test_utils feature flag for integrating proptest within the suite for working with strategies and sampling from randomly generated values.

• Run benchmarks

  cargo bench -p rhizome-benches

Note: Currently, this workspace only supports Rust-native benchmarking, as wasm-bindgen support for criterion is still an open issue. However, with some extra work, benchmarks can be compiled to wasi and run with wasmer/wasmtime or in the brower with webassembly.sh. Please catch-up with wasm support for criterion on their user-guide.

The Wasm targetted version of this project relies on wasm-pack for building, testing, and publishing artifacts sutiable for Node.js, web broswers, or bundlers like webpack.

Please read more on working with wasm-pack directly in rhizome-wasm.

🎈 We're thankful for any feedback and help in improving our project! We have a contributing guide to help you get involved. We also adhere to our Code of Conduct.

This repository contains a Nix flake that initiates both the Rust toolchain set in rust-toolchain.toml and a pre-commit hook. It also installs helpful cargo binaries for development. Please install nix and direnv to get started.

Run nix develop or direnv allow to load the devShell flake output, according to your preference.

For formatting Rust in particular, please use cargo +nightly fmt as it uses specific nightly features we recommend by default.

This library recommends using pre-commit for running pre-commit hooks. Please run this before every commit and/or push.

• If you are doing interim commits locally, and for some reason if you don't want pre-commit hooks to fire, you can run git commit -a -m "Your message here" --no-verify.

• We recommend leveraging cargo-watch, cargo-expand and irust for Rust development.
• We recommend using cargo-udeps for removing unused dependencies before commits and pull-requests.

This project lightly follows the Conventional Commits convention to help explain commit history and tie in with our release process. The full specification can be found here. We recommend prefixing your commits with a type of fix, feat, docs, ci, refactor, etc..., structured like so:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

For usage questions, usecases, or issues reach out to us in our Discord channel.

We would be happy to try to answer your question or try opening a new issue on Github.

These are references to specifications, talks and presentations, etc.

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.