rust/comprehensive-rust
1
0
Fork 0
mirror of https://github.com/google/comprehensive-rust.git synced 2024-12-04 03:25:08 +02:00
Code Issues Releases Activity

Merge pull request #139 from brandonpollack23/rust_ecosystem

Browse Source 
Add more info and footnotes to rust-ecosystem.md
This commit is contained in:
Martin Geisler 2023-01-10 17:51:44 +01:00 committed by GitHub
commit 20c0a37949
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 23 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
src/cargo/rust-ecosystem.md
View File

@ -3,12 +3,12 @@
The Rust ecosystem consists of a number of tools, of which the main ones are:
* `rustc`: the Rust compiler which turns `.rs` files into binaries and other
intermediate formats.
intermediate formats[^rustc].
* `cargo`: the Rust dependency manager and build tool. Cargo knows how to
download dependencies hosted on <https://crates.io> and it will pass them to
`rustc` when building your project. Cargo also comes with a built-in test
runner which is used to execute unit tests.
runner which is used to execute unit tests[^cargo].
* `rustup`: the Rust toolchain installer and updater. This tool is used to
install and update `rustc` and `cargo` when new versions of Rust is released.
@ -41,6 +41,27 @@ Key points:
* To avoid splitting the ecosystem, Rust compilers can mix code
written for different editions.
* Mention that it is quite rare to ever use the compiler directly not through `cargo` (most users never do).
* It might be worth alluding that Cargo itself is an extremely powerful and comprehensive tool. It is capable of many advanced features including but not limited to:
* Project/package structure
* [workspaces]
* Dev Dependencies and Runtime Dependency management/caching
* [build scripting]
* [global installation]
* It is also extensible with sub command plugins as well (such as [cargo clippy]).
* Read more from the [official Cargo Book]
[editions]: https://doc.rust-lang.org/edition-guide/
[workspaces]: https://doc.rust-lang.org/cargo/reference/workspaces.html
[build scripting]: https://doc.rust-lang.org/cargo/reference/build-scripts.html
[global installation]: https://doc.rust-lang.org/cargo/commands/cargo-install.html
[cargo clippy]: https://github.com/rust-lang/rust-clippy
[official Cargo Book]: https://doc.rust-lang.org/cargo/
</details>