Fundamentos de Módulos

À medida que seus programas em Rust crescem, manter tudo em um único arquivo se torna inconveniente. O sistema de módulos do Rust permite organizar o código movendo structs e suas implementações para arquivos separados.

Para criar um módulo em um arquivo separado, basta criar um novo arquivo com o nome desejado para o módulo. Por exemplo, para criar um módulo player, você criaria um arquivo chamado player.rs:

// player.rs
struct Player {
    name: String,
    score: u32,
}

impl Player {
    fn new(name: String) -> Player {
        Player { name, score: 0 }
    }
}

Para usar este módulo no seu arquivo principal, você o declara com a palavra-chave mod. Isso informa ao Rust para procurar um arquivo com esse nome:

// main.rs
mod player;

fn main() {
    // Agora podemos acessar itens do módulo player
}

A declaração mod player; diz ao Rust para localizar e incluir o conteúdo de player.rs. Pense nisso como vincular o código desse arquivo ao seu programa. O nome do módulo deve corresponder exatamente ao nome do arquivo (sem a extensão .rs).

Essa separação mantém o código relacionado junto. A definição de struct e todos os seus métodos ficam em um arquivo dedicado, enquanto main.rs permanece focado no ponto de entrada do programa. Na próxima lição, você aprenderá como acessar de fato os itens que colocou nos módulos.