Modules

Módulos en otros directorios

Crates

Integración de todo:

Obs: cuando se habla de “declare a module” se hace referencia a importarlo o bien definirlo ahí mismo.

• Start from the crate root: When compiling a crate, the compiler first looks in the crate root file (usually src/lib.rs for a library crate or src/main.rs for a binary crate) for code to compile.
• Declaring modules: In the crate root file (main o lib), you can declare new modules; say, you declare a “garden” module with mod garden;. The compiler will look for the module’s code in these places:
  • Inline, within curly brackets that replace the semicolon following mod garden (lo defino ahi)
  • In the file src/garden.rs
  • In the file src/garden/mod.rs ← puedo separar las cosas en directorios.
• Declaring submodules: In any file other than the crate root, you can declare submodules. For example, you might declare mod vegetables; in src/garden.rs. The compiler will look for the submodule’s code within the directory named for the parent module in these places:
  • Inline, directly following mod vegetables, within curly brackets instead of the semicolon
  • In the file src/garden/vegetables.rs
  • In the file src/garden/vegetables/mod.rs
• Paths to code in modules: Once a module is part of your crate, you can refer to code in that module from anywhere else in that same crate, as long as the privacy rules allow, using the path to the code. For example, an Asparagus type in the garden vegetables module would be found at crate::garden::vegetables::Asparagus.
• The use keyword: Within a scope, the use keyword creates shortcuts to items to reduce repetition of long paths. In any scope that can refer to crate::garden::vegetables::Asparagus, you can create a shortcut with use crate::garden::vegetables::Asparagus; and from then on, you only need to write Asparagus to make use of that type in the scope.

usualmente en

lib.rs

solo se declaran los módulos, en sus archivos particulares estaran las funciones o estructuras asociadas a ese modulo.

Por ejemplo, podrías tener un

lib.rs

con el siguiente aspecto:

//! src/lib.rs

mod adder;
mod multiplier;