Rust模块

一、模块
模块是用于在crate内部继续进行分层和封装的机制。模块内部又可以包含模块。Rust中的模块是一个典型的树形结构。每个crate会自动产生一个跟当前crate同名的模块，作为这个树形结构的根节点。

模块是item的集合，item可以是：函数，结构体，trait，impl 块，甚至其它模块。

模块是一种抽象的概念，文件是承载这个概念的实体。但是模块和文件并不是简单的一一对应关系，用户可以自己维护这个映射关系。

在一个crate内部创建新模块有以下方式：

1. 一个文件中创建内嵌模块。直接使用mod关键字即可，模块内容包含到大括号内部。
2. 独立的一个文件就是一个模块。文件名即是模块名。
3. 一个文件夹也可以创建一个模块。文件夹内部要有一个mod.rs文件，这个文件就是这个模块的入口。

二、可见性
模块的可见性分为私有和公开两种。默认情况下是私有。
公开和私有的访问权限规则如下：

1. 如果一个元素是私有的，那么只有本模块内的元素以及它的子模块可以访问。
2. 如果一个元素是公开的，那么上一层的模块就有权访问它。

以下是代码样例：

// 一个名为 `my_mod` 的模块
mod my_mod {
   
    // 模块中的项默认具有私有的可见性
    fn private_function() {
   
        println!("called `my_mod::private_function()`");
    }

    // 使用 `pub` 修饰语来改变默认可见性。
    pub fn function() {
   
        println!("called `my_mod::function()`");
    }

    // 在同一模块中，项可以访问其它项，即使它是私有的。
    pub fn indirect_access() {
   
        print!("called `my_mod::indirect_access()`, that\n> ");
        private_function();
    }

    // 模块也可以嵌套
    pub mod nested {
   
        pub fn function() {
   
            println!("called `my_mod::nested::function()`");
        }

        #[allow(dead_code)]
        fn private_function() {
   
            println!("called `my_mod::nested::private_function()`");
        }

        // 使用 `pub(in path)` 语法定义的函数只在给定的路径中可见。
        // `path` 必须是父模块（parent module）或祖先模块（ancestor module）
        pub(in