Noções Básicas de Módulos

7 exemplos - 5 básicos, 2 intermediários - para o sistema de módulos do Rust.

Pré-requisitos

• Noções Básicas de Cargo

Exemplos Básicos

1. Módulo Inline

mod math {
    pub fn add(a: i32, b: i32) -> i32 { a + b }
}
fn main() { println!("{}", math::add(1, 2)); }

2. Módulo de Arquivo

// lib.rs: mod config;
// config.rs: pub fn port() -> u16 { 8080 }

mod config; carrega config.rs ou config/mod.rs.

3. Visibilidade pub

mod api {
    pub fn ping() {}
    fn secret() {}
}

Apenas ping é visível fora de api.

4. Módulos Aninhados

mod outer {
    pub mod inner { pub fn f() {} }
}

Caminho: outer::inner::f.

5. Importação use

use std::collections::HashMap;

Relacionado: use & Caminhos

Exemplos Intermediários

6. Diretório mod.rs

src/
  lib.rs
  models/
    mod.rs
    user.rs

mod user; em models/mod.rs.

7. Raiz do Crate

Binário: main.rs. Biblioteca: lib.rs - módulo raiz do crate.

Relacionado: Melhores Práticas de Módulos e Crates

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.