domingo, 31 de maio de 2026

"Canivete suíço" do Rust

PowerShell (Windows):

Aqui está o resumo visual e prático de cada comando:

1. cargo clean ; cargo test --all-features

  • O que é: O Garantidor de Funcionamento.
  • O que faz: O cargo clean apaga o cache antigo de compilações passadas. 
  • O cargo test --all-features força o Rust a baixar as novas dependências do zero absoluta e roda todos os testes de todas as partes do seu framework (Axum, Actix, Leptos, etc.).
  • Quando usar: Sempre após atualizar dependências (como alertas do Dependabot) ou antes de enviar seu código para o GitHub, para ter certeza absoluta de que nada quebrou.


2. cargo clippy --all-features --fix

  • O que é: O Mentor de Código.
  • O que faz: Analisa o seu código procurando por gambiarras, falta de padrões ou códigos ineficientes. 
  • A flag --fix altera o seu arquivo automaticamente corrigindo os problemas mais simples sozinho.
  • Quando usar: Antes de finalizar qualquer funcionalidade nova. 
  • É o comando que garante que o código do Rullst pareça escrito por um especialista em Rust.


3. cargo fmt --check

  • O que é: O Fiscal de Estética.
  • O que faz: Verifica se o seu código está formatado exatamente com as regras visuais oficiais do Rust (espaços, chaves, alinhamento). 
  • Se você tirar o --check (cargo fmt), ele arruma o código sozinho.
  • Quando usar: Antes de fazer um commit. 
  • Garante que qualquer desenvolvedor no mundo consiga ler o código do Rullst de forma confortável.


4. cargo doc --all-features --no-deps --open

  • O que é: O Criador de Manuais.
  • O que faz: Pega os seus comentários de código (com ///) e gera um site HTML de documentação lindo e profissional, abrindo-o direto no seu navegador. 
  • O --no-deps faz ele ignorar as bibliotecas dos outros e focar só na sua.
  • Quando usar: Quando estiver escrevendo novas funções ou APIs para ver como a documentação do Rullst está ficando para os seus usuários finais.


5. cargo publish --dry-run

  • O que é: O Ensaio Geral.
  • O que faz: Simula todo o processo de empacotamento e envio da sua biblioteca para o site oficial (crates.io). 
  • Ele finge que vai publicar para checar se não falta nenhum arquivo ou configuração, mas não envia nada para a internet ainda.
  • Quando usar: O último passo antes de lançar uma versão nova. 
  • Se ele passar sem erros, significa que o seu pacote está pronto para o mundo.


💡 Resumo do fluxo de trabalho (A Ordem Perfeita):

Quando você estiver trabalhando no Rullst, a ordem natural de uso deles é:

  1. Digita o código 
  2. cargo clippy (arruma a lógica) 
  3. cargo fmt (arruma a beleza) 
  4. cargo test (valida tudo) 
  5. cargo publish --dry-run (valida o lançamento).

Nenhum comentário:

Postar um comentário

Postagens mais visitadas

Postagem em destaque

🛠️ O Guia Definitivo: Atualização e Publicação do Rust no: crates.io

Mapa definitivo do processo de atualização e publicação de bibliotecas em Rust. Este raciocínio está perfeitamente alinhado com o que há de ...