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 é:
- Digita o código
- cargo clippy (arruma a lógica)
- cargo fmt (arruma a beleza)
- cargo test (valida tudo)
- cargo publish --dry-run (valida o lançamento).
Nenhum comentário:
Postar um comentário