Module

模块化

模块的划分和使用

总体来说，pl的模块化与rust类似，但是规则比rust简单。
任何一个pl文件都是一个模块，模块的名字就是文件名。一个pl项目的根目录一定有Kagari.toml配置文件，之后所有该项目 模块的路径都是从该文件所在的目录开始计算的。

举个例子，如果我的pl项目有以下的目录结构：

test
├── Kagari.toml
├── mod1.pi
├── main.pi
└── sub
    └── mod.pi

如果main.pi想使用mod1.pi或者mod.pi中的函数，那么可以这样写：

use mod1;
use sub::mod;

fn main() void {
    mod1::func();
    mod::func();
    return;
}

如果mod.pi想使用mod1.pi中的函数，那么可以这样写：

use mod1;

fn main() void {
    mod1::func();
    return;
}

单独引入和全引入

pl的模块引入支持单独引入某些符号或者全引入。

use mod1::func1; // 单独引入
use mod2::*; // 全引入

请注意，单独引入仍然会形成父子模块关系，会对extension method的作用域产生影响。

引用另一个pl项目

目前只支持引用本地的pl项目，引用的方式是在Kagari.toml中添加[deps]

[deps]
sub3 = { path = "sub2" }

使用时，引用的项目模块会在deps中定义的命名空间之下：

use sub3::lib;

fn main() void {
    lib::func();
    return;
}