diff --git a/pages.pt_BR/common/cargo-add.md b/pages.pt_BR/common/cargo-add.md new file mode 100644 index 000000000..3f1f10986 --- /dev/null +++ b/pages.pt_BR/common/cargo-add.md @@ -0,0 +1,32 @@ +# cargo add + +> Adiciona dependências ao arquivo `Cargo.toml` de um projeto Rust. +> Mais informações: . + +- Adicionar a versão mais recente de uma dependência ao projeto atual: + +`cargo add {{dependência}}` + +- Adicionar uma versão específica de uma dependência: + +`cargo add {{dependência}}@{{versão}}` + +- Adicionar uma dependência e habilitar uma ou mais funcionalidades específicas: + +`cargo add {{dependência}} --features {{funcionalidade_1}},{{funcionalidade_2}}` + +- Adicionar uma dependência opcional, que será exposta como uma funcionalidade da crate: + +`cargo add {{dependência}} --optional` + +- Adicionar uma crate local como dependência: + +`cargo add --path {{caminho/para/crate}}` + +- Adicionar uma dependência de desenvolvimento ou de compilação: + +`cargo add {{dependência}} --{{dev|build}}` + +- Adicionar uma dependência com todas as funcionalidades padrão desabilitadas: + +`cargo add {{dependência}} --no-default-features` diff --git a/pages.pt_BR/common/cargo-build.md b/pages.pt_BR/common/cargo-build.md new file mode 100644 index 000000000..d6ffba0f7 --- /dev/null +++ b/pages.pt_BR/common/cargo-build.md @@ -0,0 +1,32 @@ +# cargo build + +> Compila um projeto Rust em um pacote local incluindo todas as suas dependências. +> Mais informações: . + +- Compilar o pacote ou pacotes definidos pelo arquivo `Cargo.toml` no diretório local: + +`cargo build` + +- Compilar os artefatos em modo de publicação (release), com otimizações: + +`cargo build --release` + +- Compilar um pacote garantindo que o `Cargo.lock` esteja atualizado: + +`cargo build --locked` + +- Compilar todos os pacotes no workspace: + +`cargo build --workspace` + +- Compilar um pacote específico: + +`cargo build --package {{pacote}}` + +- Compilar apenas o binário especificado: + +`cargo build --bin {{nome}}` + +- Compilar apenas um teste específico: + +`cargo build --test {{nome_do_teste}}` diff --git a/pages.pt_BR/common/cargo-clippy.md b/pages.pt_BR/common/cargo-clippy.md new file mode 100644 index 000000000..5a5915a25 --- /dev/null +++ b/pages.pt_BR/common/cargo-clippy.md @@ -0,0 +1,32 @@ +# cargo clippy + +> Conjunto de validadores para identificar erros comuns e melhorar código em Rust. +> Mais informações: . + +- Executar verificações no código no diretório atual: + +`cargo clippy` + +- Executar verificações garantindo que o `Cargo.lock` esteja atualizado: + +`cargo clippy --locked` + +- Executar verificações em todos os pacotes no workspace: + +`cargo clippy --workspace` + +- Executar verificações para um pacote específico: + +`cargo clippy --package {{pacote}}` + +- Executar validações tratando avisos como erros: + +`cargo clippy -- --deny warnings` + +- Executar verificações e ignorar avisos: + +`cargo clippy -- --allow warnings` + +- Aplicar automaticamente as sugestões do Clippy: + +`cargo clippy --fix` diff --git a/pages.pt_BR/common/cargo-doc.md b/pages.pt_BR/common/cargo-doc.md new file mode 100644 index 000000000..0810183bc --- /dev/null +++ b/pages.pt_BR/common/cargo-doc.md @@ -0,0 +1,20 @@ +# cargo doc + +> Constrói e visualiza a documentação de um pacote Rust, opcionalmente em modo offline. +> Mais informações: . + +- Construir a documentação padrão do pacote e mostrá-la no navegador: + +`cargo doc --open` + +- Construir a documentação sem acessar a rede: + +`cargo doc --offline` + +- Visualizar a documentação de um pacote específico: + +`cargo doc --open --package {{pacote}}` + +- Visualizar a documentação de um pacote específico sem acessar a rede: + +`cargo doc --open --offline --package {{pacote}}` diff --git a/pages.pt_BR/common/cargo-rustc.md b/pages.pt_BR/common/cargo-rustc.md new file mode 100644 index 000000000..578e8f062 --- /dev/null +++ b/pages.pt_BR/common/cargo-rustc.md @@ -0,0 +1,36 @@ +# cargo rustc + +> Compila um pacote Rust. +> Mais informações: . + +- Compilar o pacote ou pacotes definidos pelo arquivo `Cargo.toml` no diretório de trabalho atual: + +`cargo rustc` + +- Compilar os artefatos em modo de publicação (release), com otimizações: + +`cargo rustc --release` + +- Compilar com otimizações específicas para a arquitetura do CPU atual: + +`cargo rustc --release -- -C target-cpu=native` + +- Compilar com otimização de velocidade: + +`cargo rustc -- -C opt-level {{1|2|3}}` + +- Compilar com otimização de tamanho (`z` também desativa a vetorização de ciclos): + +`cargo rustc -- -C opt-level {{s|z}}` + +- Verificar se o pacote usa código com padrões inseguros de acesso à memória: + +`cargo rustc --lib -- -D unsafe-code` + +- Compilar um pacote específico: + +`cargo rustc --package {{pacote}}` + +- Compilar apenas o binário especificado: + +`cargo --bin {{nome}}` diff --git a/pages.pt_BR/common/cargo-test.md b/pages.pt_BR/common/cargo-test.md new file mode 100644 index 000000000..7eae8af05 --- /dev/null +++ b/pages.pt_BR/common/cargo-test.md @@ -0,0 +1,32 @@ +# cargo test + +> Executa os testes unitários e de integração de um pacote Rust. +> Mais informações: . + +- Executar apenas os testes que contenham uma string específica em seus nomes: + +`cargo test {{nomedoteste}}` + +- Definir o número de casos de teste para execução simultânea: + +`cargo test -- --test-threads={{quantidade}}` + +- Executar os testes garantindo que o `Cargo.lock` esteja atualizado: + +`cargo test --locked` + +- Testar os artefatos em modo de publicação (release), com otimizações: + +`cargo test --release` + +- Testar todos os pacotes no workspace: + +`cargo test --workspace` + +- Executar testes para um pacote específico: + +`cargo test --package {{pacote}}` + +- Executar testes sem ocultar a saída das execuções dos testes: + +`cargo test -- --nocapture`