learn-rust

package

learn-rust is a package. a crate is a binary or library. a package can have a library crate (lib.rs) and multiple binary crates (main.rs, bin/*.rs, bin/*/main.rs). (need at least one library or binary crate. a workspace can have multiple packages as members.

cargo

https://doc.rust-lang.org/stable/cargo/

configuration

https://doc.rust-lang.org/stable/cargo/reference/config.html https://doc.rust-lang.org/stable/cargo/reference/environment-variables.html

init current directory as new project

sh cargo init --bin # for binary(executable) crate cargo init --lib # for library crate

executable

• https://doc.rust-lang.org/cargo/reference/cargo-targets.html#binaries
• https://doc.rust-lang.org/cargo/guide/project-layout.html
• single executable main.rs
  • src/main.rs

sh cargo run

• multiple executable
  • put other binaries except main.rs in the src/bin directory.
  • src/main.rs
  • src/bin/another_executable.rs
  • src/bin/multi_files_executable/main.rs
  • you can set default-run in Cargo.toml
  • you should set this value to exec cargo run without --bin option.

```sh cargo run --bin learn-rust # to run main.rs cargo run --bin anotherexecutable # to run bin/anotherexecutable.rs cargo run --bin multifilesexecutable

to run bin/multifilesexecutable/main.rs

cargo run # = cargo run --bin learn-rust (when default-run = learn-rust) ```

in releasee mode with optimization

sh cargo run --release

add another crate

sh cargo new --lib another_crate

Cargo.lock to .gitignore?

https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html

• library layer: yes
• application, endpoint layer: no

See document

• https://doc.rust-lang.org/cargo/commands/cargo-doc.html

sh cargo doc --open

Clean targets

• https://doc.rust-lang.org/cargo/commands/cargo-clean.html
• use when something is wrong.

sh cargo clean

Check easy compilation errors

• https://doc.rust-lang.org/cargo/commands/cargo-check.html

sh cargo check

publish to crates.io

https://doc.rust-lang.org/cargo/reference/publishing.html

formatter

• rustfmt
  • https://github.com/rust-lang/rustfmt
  • https://rust-lang.github.io/rustfmt/

linter

• clippy
  • https://github.com/rust-lang/rust-clippy
  • https://rust-lang.github.io/rust-clippy/master/

in vscode

extensions

• rust-analyzer
• even better toml
• bash IDE
• shell-format
• markdownlint
• gitlens
• live server