Jen

Jen 是一个简单的（但可扩展的）用于生成大型随机数据集的工具。

Jen 是一个核心库和 CLI 的组合，用于根据模板生成随机数据集。虽然已经存在一些这样的工具，但它们大多数都在浏览器中运行，自然不足以生成大量数据。Jen 的创建是为了填补创建大量数据的空白，例如用于单元测试和数据库状态。

Jen 的底层模板语法由 Tera 驱动，以帮助熟悉并避免重新发明模板语言。在此之上，Jen 提供了许多围绕随机化数据的功能。其中一些功能基于 fake，并在存在空白的地方提供额外的功能。您在使用 Jen 时可以自然地附加自己的功能。

安装

Jen 可通过 Crates.io 获得，因此可以直接从那里安装。您可以将 Jen 作为命令行工具或直接通过程序 API 使用。

如果您想将 Jen 安装为命令行工具，您可以通过终端中的一行轻松安装

$ cargo install jen

如果您想将其作为库使用，可以将它添加到您的 Cargo.toml 中，作为您应用程序的依赖项

[dependencies]
jen = { version = "1.6", default-features = false }

您应该禁用默认功能，因为它包含多个依赖项，这些依赖项是 CLI 用例所需的。当禁用这些功能时，不会将依赖项包含在您的应用程序中。

用法

第一步是构建一个模板文件，Jen在生成数据时会使用这个文件。默认情况下，提供了许多模板助手，这些助手通过内部的jen::helpers模块提供。您可以查看文档以获取最新的助手列表，尽管可以在下面找到相当最新的助手表。以下。一旦有了这个模板，您可以通过CLI或编程方式使用Jen。

命令行

CLI相当简单，其基本结构为

$ jen <template>

使用此语法将基于提供的模板（必须是一个有效的Tera模板）生成随机文档。在example目录中有一个基本文档可以进行测试。

您可以通过提供以下选项来调整输出（在撰写本文时，可能有更多）

USAGE:
    jen [FLAGS] [OPTIONS] <template>

FLAGS:
    -h, --help       Prints help information
    -t, --textual    Treat the input as textual, rather than JSON
    -V, --version    Prints version information

OPTIONS:
    -l, --limit <limit>        An upper limit of documents to generate

ARGS:
    <template>    Template to control JSON generation

尽管Jen可以处理任何输入格式，但它最初是针对JSON文档编写的。因此，Jen将自动尝试解析输入（生成后）为JSON，以便压缩并按行输出文档。这种检测有一定量的开销，可以通过提供-t来跳过，如果您明确不希望将传入的数据视为JSON。

有关完整且最新的选项列表，请在终端中使用jen -h。

编程API

编程API非常简单。一切通过使用Generator结构体来处理，它实现了Iterator特质以提供连续（懒）文档。

生成器通过磁盘上模板的路径构建，然后您可以使用以下所示的Iterator方法生成文档。

let mut generator = Generator::load("./example/example.tera")
    .expect("provided a value template");

for document in generator.take(5) {
    println!("{}", document);
}

这将从提供的模板生成五个文档并将它们打印到终端。

模板助手

以下是在撰写本文时的当前助手列表。请参阅上传到Crates.io的文档以获取最新列表。