Cargo.toml

Guia completo do manifesto Cargo.toml para bots Rust e aplicações web (site/API) na Discloud.

🗂️ O que é Cargo.toml?

Cargo.toml é o manifesto que define os metadados do seu pacote Rust (crate): nome, versão, autores, edição, dependências, recursos, scripts de build e mais. A Discloud depende dele para resolver e compilar seu projeto antes de iniciá-lo.

---

🛠️ Criando um Novo Projeto

1

Inicialize em diretório existente:

cargo init

2

Crie um novo diretório automaticamente:

cargo new my_bot

Use nomes em snake_case ou kebab-case.

3

Adicione uma dependência rapidamente (Cargo 1.62+):

cargo add serenity

Precisa do Rust? Veja a página de instalação.

---

📦 Exemplos

Bot Discord (serenity)

Cargo.toml

[package]
name = "discord_bot"
version = "0.1.0"
edition = "2021"

[dependencies]
serenity = { version = "0.11", default-features = false, features = [
	"client", "gateway", "rustls_backend", "model" ] }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
tracing = "0.1"
dotenvy = "0.15"

Serenity é uma biblioteca da API do Discord: https://crates.io/crates/serenity

API Axum

Cargo.toml

[package]
name = "axum_api"
version = "0.1.0"
edition = "2021"

[dependencies]
axum = "0.7"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["fmt", "env-filter"] }
dotenvy = "0.15"

Deve escutar em 0.0.0.0:8080.

Rocket (Nightly)

Cargo.toml

[package]
name = "rocket_site"
version = "0.1.0"
edition = "2021"

[dependencies]
rocket = { version = "0.5.0", features = ["json"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"

Requer toolchain nightly + bind na porta 8080.

Precisa de dependências no nível do SO (ex.: openssl, ffmpeg)? Adicione-as sob APT= no discloud.config. Veja a lista de pacotes APT para sintaxe e exemplos.

---

🧰 Referência de Comandos Comuns

# Build debug
cargo build

# Build release
cargo build --release

# Executar
cargo run

# Adicionar dependência
cargo add <crate>

# Remover dependência
cargo rm <crate>

# Auditar (opcional; precisa cargo-audit)
cargo audit

Ferramentas opcionais:

cargo install cargo-edit cargo-outdated cargo-audit