模块¶

导入模块¶

使用 using 来导入模块，模块中的内容将会被导入到对应的命名空间中。

using "std";

对应的命名空间 指配置文件中指定的模块名，如果没有指定则为模块所在的文件夹名。

Lumos 提供了一种写法，可以导入模块内容到指定的命名空间中。

using "std" -> abc; // 导入 std 模块到 abc 命名空间
                    // abc 命名空间可以不存在

导入模块后可以 using 需要的内容。

using "std";
using std.println;

当然也可以导入到根命名空间：

using "std" -> ::;

但这样会导致一些问题，比如向当前命名空间导入了一些不需要或不应该导入的内容。

构建模块¶

Lumos 的模块是一个配置文件，一个简单的架构为

my_model/
  main.lh
  main.lm
  lumos.yaml

main.lh 和 main.lm 的基本形式为

fn my_func();

fn my_func() {
    println("Hello, world!");
}

lumos.yaml 的基本形式为

# 基本信息（可选）
name: my_model # 模块名（默认为所在文件夹名）
version: 1.0.0 # 模块版本号（默认为 1.0.0）
std: 1.0.0     # 使用的语言标准版本（默认为最新）
target: x86_64 # 目标平台（默认为当前平台）
# 附加信息（可选）
author: xxx      # 作者
email: xxx       # 联系邮箱
license: xxx     # 许可证
description: xxx # 描述
url: xxx         # 项目地址
type: xxx        # 模块类型
tags:            # 标签
  - xxx
  - xxx
issues: xxx      # 问题地址
sponsor: xxx     # 赞助商
# 编译选项（可选）
flags:
  debug:
    - -O0 -g
  release:
    - -O2
# 模块依赖（可选）
dependencies: # 不允许循环依赖
  - std       # 标准库
  - xxx       # 其他模块
using:             # 实现文件中默认导入的模块声明
  - "std  -> ::" # 标准库
  - "self -> ::" # 当前模块
# 模块本体
decl:    # 声明所在的文件
  - main # 查找时忽略 .lm 文件，除非使用完整文件名
impl:    # 实现所在的文件
  - main # 查找时忽略 .lh 文件，除非使用完整文件名

name 模块名，不能包含特殊字符，不能为 self。
version 模块版本号，格式为 x.y.z。
std 使用的语言标准版本。
target 目标平台。
author 作者。人员信息或人员信息列表
email 联系邮箱。字符串或字符串列表
license 许可证。字符串
description 描述。字符串
url 项目地址。url 字符串
type 模块类型。字符串
tags 标签。字符串列表
issues 问题地址。url 字符串
sponsor 赞助商。人员信息或人员信息列表
flags 编译选项。
dependencies 模块依赖。字符串列表
using 实现文件中默认导入的模块声明。字符串列表
decl 声明所在的文件。字符串列表
impl 实现所在的文件。字符串列表

人员信息可以是一个字符串（表示名称），也可以是一个对象。

author:
  - xxx
  - yyy
  - name: zzz # 名称（必须）
    # 以下为可选项
    email: zzz  # 联系邮箱
    avatar: zzz # 头像地址
    url: zzz    # 个人主页

可以使用更复杂的目录结构，比如模块中包含子模块：

my_model/
  my_submodel/
    main.lh
    main.lm
    lumos.yaml
  main.lh
  main.lm
  lumos.yaml

此时你可以在 lumos.yaml 中

using:
  - ".my_submodel -> submodel"

模块宏¶

ismodelimpl 宏用于判断当前文件是否被当前模块实现文件包含或导入。

#if ismodelimpl
// 代码
#endif

isfileimpl 宏用于判断当前文件是否被对应的实现文件包含。
如 xxx.lh 和 xxx.lm

#if isfileimpl
// 代码
#endif