rust-by-example-ext icon indicating copy to clipboard operation
rust-by-example-ext copied to clipboard

Rust by Example -- Extended Edition

Rust By Example -- Extended Edition

Build and Publish

Learn Rust with examples from 3rd party crates. This book is the sister book for the Rust By Example book, which covers core Rust language features and standard libraries. This book, being the Extended Edition, focuses on commonly used 3rd party libraries and tools.

Using

If you'd like to read Rust by Example -- Extended Edition, you can visit https://rust-by-example-ext.com/ to read it online.

Interactive code example

Run an example from the web page

Contribute using VSCode codespaces

The VSCode online IDE allows you to make changes, test your changes, and send us Pull Requests without having to install any software on your computer!

  • First fork this repository!
  • Log into VSCode codespaces with your Azure account and open the forked repository in a new codespace. It will take a few minutes as codespace needs to build mdbook in the process.
  • Make changes or add to MD files in VSCode.
  • Use Menu | Terminal | Run Task ... | mdbook server to start a local server for your book. You will see it running in the IDE's built-in Terminal.
  • Open a browser to access the VSCode server to see the book, and confirm your edits look good.
  • Use the Git menu to commit the changes, and use the GitHub menu to send the changes to use via Pull Request.

Building locally

If you'd like to read it locally, install Rust, and then:

$ git clone https://github.com/second-state/rust-by-example-ext
$ cd rust-by-example-ext
$ cargo install mdbook
$ mdbook build
$ mdbook serve

License

Rust by Example is licensed under either of

at your option.

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