# Rust
## 🧾 Visão Geral
Rust fornece performance, segurança de memória e uso previsível de recursos para APIs, workers e bots. Instale com `rustup` para gerenciar toolchains localmente antes de fazer o upload.
***
## 📥 Instalação (escolha seu SO)
{% tabs %}
{% tab title="🪟 Windows" %}
{% tabs %}
{% tab title="rustup-init (Oficial)" %}
{% stepper %}
{% step %}
Baixe o instalador: (ou execute o comando abaixo no PowerShell)
{% endstep %}
{% step %}
Execute e aceite os padrões (instala no perfil do usuário).
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="Alternativo (PowerShell):" %}
```bash
irm https://win.rustup.rs -UseBasicParsing | iex
```
{% endtab %}
{% endtabs %}
**Verificar**
```bash
rustc --version
cargo --version
```
**Atualizar Toolchain**
```bash
rustup update
```
{% endtab %}
{% tab title="🐧 Linux" %}
Instale via script rustup:
```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
rustc --version
cargo --version
```
**Adicionar Build Essentials (Debian/Ubuntu)**
```bash
sudo apt update
sudo apt install -y build-essential pkg-config libssl-dev
```
**Atualizar**
```bash
rustup update
```
**Remover Toolchain**
```bash
rustup self uninstall
```
{% endtab %}
{% tab title="🍎 macOS" %}
Instale com rustup:
```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
rustc --version
cargo --version
```
Adicionar ferramentas de build (se não presentes):
```bash
xcode-select --install # solicita ferramentas de desenvolvedor
```
Atualizar:
```bash
rustup update
```
{% endtab %}
{% endtabs %}
***
## 🧰 Toolchains e Componentes
{% stepper %}
{% step %}
Listar instalados
```bash
rustup toolchain list
```
{% endstep %}
{% step %}
Adicionar nightly (opcional)
```bash
rustup toolchain install nightly
```
{% endstep %}
{% step %}
Definir padrão
```bash
rustup default stable
```
{% endstep %}
{% step %}
Adicionar componentes (exemplo)
```bash
rustup component add clippy rustfmt
```
{% endstep %}
{% endstepper %}
***
## 🗂 Inicialização do Projeto
Criar novo projeto:
```bash
cargo new myapp
cd myapp
cargo build
```
Executar:
```bash
cargo run
```
Formatar e lintar:
```bash
cargo fmt -- --check
cargo clippy -- -D warnings
```
***
## 🗃 Comandos Cargo Comuns
```bash
cargo new api-service # criar projeto binário
cargo build --release # build otimizado
cargo run # build + executar
cargo test # executar testes
cargo update # atualizar lock de dependências
cargo tree # gráfico de dependências (requer cargo-tree)
cargo doc --open # construir docs localmente
```
Instalar cargo tree (se faltar):
```bash
cargo install cargo-tree
```
***
## 📦 Gerenciamento de Dependências
Dependências declaradas em [`Cargo.toml`](/development-environment/supported-languages/rust/cargo.toml.md) sob `[dependencies]`:
```toml
[dependencies]
reqwest = { version = "0.12", features = ["json"] }
serde = { version = "1", features = ["derive"] }
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
```
Atualizar lockfile:
```bash
cargo update
```
***
## 🔄 Atualização
```bash
rustup update # atualizar todas as toolchains
rustup self update # atualizar rustup em si
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.discloud.com/development-environment/local-environment/rust.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.