#logging #logger #gba #log #no-alloc #nocash

no-std nocash_gba_log

为no$gba提供的日志记录实现

1个不稳定版本

0.1.0 2023年9月16日

#736 in 调试

MIT/Apache

10KB
74

nocash_gba_log

crates.io docs.rs License

为no$gba提供的日志记录实现。

为编译Game Boy Advance并在no$gba模拟器中运行时提供log crate的日志记录实现。

使用方法

在库中

nocash_gba_log 应仅用于二进制文件。库应直接使用log crate提供的日志界面。

在二进制文件中

在二进制文件中进行日志记录时,只能启用一个日志记录器。因此,nocash_gba_log 不能与其他日志记录实现一起使用。

安装

在您的 Cargo.toml 中将 nocash_gba_log 添加为依赖项。

[dependencies]
nocash_gba_log = "0.1.0"

然后在您的二进制文件中尽早调用 init()。初始化之前的任何记录都将静默丢弃。

fn main() {
    nocash_gba_log::init().expect("unable to initialize no$gba logger");

    log::info!("Hello, world!");
}

请注意,您可能需要更稳健地处理从 init() 返回的 Error 消息,除非您只想在no$gba上运行项目。

兼容性

此日志记录器使用针对Game Boy Advance特定的内存映射I/O寄存器。因此,只有在构建用于在Game Boy Advance或Game Boy Advance模拟器上运行时,才安全地使用此库。

如果在不在no$gba上运行时尝试初始化此日志记录器,它将失败并返回一个标识失败原因的 Error

许可证

本项目受以下任一许可证的许可:

由您选择。

贡献

除非您明确说明,否则根据Apache-2.0许可证定义的,您有意提交以包含在作品中的任何贡献,将按上述方式双授权,无需附加任何条款或条件。

依赖项

~87KB