Rust modules structure in a nutshell

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

#![allow(dead_code)]
// declare module in the root dir, so that this module is added to the
// module tree
mod my_modules_in_rootdir; 
mod my_modules_with_modrs;
mod my_modules_without_modrs;
mod my_module_in_main {
    // DESCRIPTION IS PRIVATE TO my_mod
    const DESCRIPTION: &str = "This module is defined as `mod my_mod_in_main{{...}}` in main.rs";
    pub fn desc() {
       println!("{}", DESCRIPTION);
    }
    }
    pub mod my_mod_in_main_nested {
        // DESCRIPTION PRIVATE TO my_mod::my_mod_nested
        const DESCRIPTION: &str = "This module is defined as a nested mod in my_mod_in_main` in main.rs";
        pub fn desc() {
           println!("{}", DESCRIPTION);
        }
    }
}

fn main() {
    println!("Hello, world from main()");
    my_module_in_main::desc();
    my_module_in_main::my_mod_in_main_nested::desc();
    my_modules_in_rootdir::desc();
    my_modules_with_modrs::desc();
    my_modules_with_modrs::submod_a::desc();
    my_modules_with_modrs::submod_b::desc();
    my_modules_without_modrs::submod_1::desc();
    my_modules_without_modrs::submod_2::desc();
}

1
2
3
4

const DESCRIPTION: &str = "This module is defined in src/my_modules_in_rootdir.rs, and declared in main.rs";
pub fn desc() {
    println!("{}", DESCRIPTION);
}

1
2
3
4

// This is bad, you need this file in root dir to declare the module into the module tree anyways,
// why don't you just move this file to somemodule/mod.rs ?? 
pub mod submod_1;
pub mod submod_2;

1
2
3
4

const DESCRIPTION: &str = "This module is /src/my_modules_without_modrs/submod_1, module declared in /src/my_modules_without_modrs.rs";
pub fn desc() {
    println!("{}", DESCRIPTION);
}

1
2
3
4

const DESCRIPTION: &str = "This module is /src/my_modules_without_modrs/submod_2, module declared in /src/my_modules_without_modrs.rs";
pub fn desc() {
    println!("{}", DESCRIPTION);
}

1
2
3
4
5
6
7

pub mod submod_a;
pub mod submod_b;

const DESCRIPTION: &str = "This module is /src/my_modules_with_modrs, function declared in mod.rs";
pub fn desc() {
    println!("{}", DESCRIPTION);
}

1
2
3
4

const DESCRIPTION: &str = "This module is /src/my_modules_with_modrs/submod_a, module declared in mod.rs";
pub fn desc() {
    println!("{}", DESCRIPTION);
}

1
2
3
4

const DESCRIPTION: &str = "This module is /src/my_modules_with_modrs/submod_b, module declared in mod.rs";
pub fn desc() {
    println!("{}", DESCRIPTION);
}