diff --git a/README.md b/README.md index 04db0a7be..735fbdb94 100644 --- a/README.md +++ b/README.md @@ -125,18 +125,26 @@ This code-base is still very much under-development and does not provide any user-facing functionality. For developers and researchers, there are several tests and benchmarks which may be of interest. -To run tests, use: +A few basic steps are needed to get set up: + 1. Install [rustup](https://rustup.rs/). It's a toolchain manager for Rust (Linux | macos | Windows). For installation run the below command in your terminal + ``` + $ curl https://sh.rustup.rs -sSf | sh ``` -$ cargo test --all -``` - -To run benchmarks, use: - -``` -$ cargo bench --all + 2. To configure your current shell run: + + ``` + $ source $HOME/.cargo/env ``` + + 3. Use the command `rustup show` to get information about the Rust installation. You should see that the active toolchain is the stable version. + 4. Run `rustc --version` to check the installation and version of rust. + - Updates can be performed using` rustup update` . + 5. Navigate to the working directory. + 6. Run the test by using command `cargo test --all` . By running, it will pass all the required test cases. If you are doing it for the first time, then you can grab a coffee meantime. Usually, it takes time to build, compile and pass all test cases. If there is no error then, it means everything is working properly and it's time to get hand's dirty. In case, if there is an error, then please raise the [issue](https://github.com/sigp/lighthouse/issues). We will help you. + 7. As an alternative to, or instead of the above step, you may also run benchmarks by using the command `cargo bench --all` +##### Note: Lighthouse presently runs on Rust `stable`, however, benchmarks currently require the `nightly` version.