Conceptos básicos de módulos

A medida que tus programas de Rust crecen, mantener todo en un solo archivo se vuelve poco práctico. El sistema de módulos de Rust te permite organizar el código moviendo las estructuras y sus implementaciones a archivos separados.

Para crear un módulo en un archivo separado, simplemente crea un archivo nuevo con el nombre de módulo que desees. Por ejemplo, para crear un módulo player, crearías un archivo llamado 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 en tu archivo principal, lo declaras con la palabra clave mod. Esto indica a Rust que busque un archivo con ese nombre:

// main.rs
mod player;

fn main() {
    // Ahora podemos acceder a los elementos del módulo player
}

La declaración mod player; indica a Rust que busque e incluya el contenido de player.rs. Piensa en ello como vincular el código de ese archivo a tu programa. El nombre del módulo debe coincidir exactamente con el nombre del archivo (sin la extensión .rs).

Esta separación mantiene unido el código relacionado. La definición de tu estructura y todos sus métodos se encuentran en un archivo específico, mientras que main.rs se centra en el punto de entrada del programa. En la próxima lección, aprenderás a acceder realmente a los elementos que has colocado en los módulos.