raku - 从另一个 Perl 6 文件访问 POD

Question

Perl 6 POD documentation有一节介绍如何使用 $=pod 访问当前文件的 POD 文档.没有关于访问另一个文件的 POD 文档的信息。

如何在不更改当前文件的 $=pod 的情况下访问另一个文件的 POD 结构?

Answer 1

我在 Module::Pod 中创建了一个与文件系统无关的解决方案(即将发布)在 git@github.com:dmaestro/Module-Pod.git

use Module::Pod;

# Get all Pod::Block::* objects in the module, from its own $=pod
my @pod = pod-from-module(<My::Module>);

优点:

没有文件代码的直接评估(即使在 Module::Pod 中)

使用 CompUnit::Repository 和 kin 定位模块

可以在有或没有 use 的情况下使用- 在代码中将模块用于其他目的

如果模块已经加载，你可以调用它的类型对象

缺点:

模块直接使用 nqp: 方法，如 Pod::Convenience (可能不是真正的骗局？)

无法从 *.pod 文件中检索 pod

用于 Pod6 检查测试等。