minijinja-cli

minijinja-cli 是一个命令行可执行文件，它使用 MiniJinja 将Jinja2模板直接从命令行渲染到stdout。

您可以使用Shell安装程序自动安装二进制文件

curl -sSfL https://github.com/mitsuhiko/minijinja/releases/latest/download/minijinja-cli-installer.sh | sh

或手动下载二进制文件

• aarch64-apple-darwin (Apple Silicon macOS)
• x86_64-apple-darwin (Intel macOS)
• x86_64-pc-windows-msvc (x64 Windows)
• x86_64-unknown-linux-gnu (x64 Linux, GNU)
• x86_64-unknown-linux-musl (x64 Linux, MUSL)

您也可以使用 cargo 编译它

cargo install minijinja-cli

然后像这样运行

minijinja-cli my-template.j2 data.json

参数

minijinja-cli 有两个位置参数用于引用文件。其中任何一个都可以设置为 - 以从stdin读取。这是模板的默认设置，但一次只能设置一个stdin。

• [TEMPLATE]：第一个参数是模板的文件名。如果没有提供，则默认为 -，这意味着它从stdin加载模板。
• [DATA]：第二个参数是数据文件的路径。这是一个包含应渲染的输入变量的文件。支持各种文件格式。当从 stdin 读取数据时，必须指定 --format，因为自动检测基于文件扩展名。

选项

• -f, --format <FORMAT>：这定义了数据文件的输入格式。默认是 auto，它会根据文件扩展名自动检测。有关支持的格式，请参阅下一节。
• -，--autoescape <MODE>：选择一个自动转义模式。默认是自动检测（auto），基于文件扩展名。选项包括 none 禁用转义，html 启用 HTML/XML 转义，json 启用 JSON（兼容 YAML）序列化。
• -D，--define <EXPR>：从一个表达式定义一个变量。支持的格式有 NAME 用于定义变量 NAME，其值为 true，NAME=VALUE 用于定义变量 NAME，其值为字符串 VALUE 或 NAME:=VALUE 用于将变量 NAME 设置为 YAML 解释的值 VALUE。当 YAML 支持未启用时，:= 只支持 JSON。
• --strict：启用严格模式。在渲染时，未定义的变量将引发错误。
• --no-include：禁止从文件系统包含或扩展模板。
• --no-newline：不输出尾部换行。
• --trim-blocks：启用 trim_blocks 标志。
• --lstrip-blocks：启用 lstrip_blocks 标志。
• --py-compat：启用改进的 Python 兼容性。启用此选项将添加方法，如 dict.keys 以及其他一些方法。
• -，--syntax <PAIR>：更改一个语法功能（feature=value）[可能的功能：block-start，block-end，variable-start，variable-end，comment-start，comment-end，line-statement-prefix，line-statement-comment]
• --safe-path <PATH>：仅允许从此路径包含。可以使用多次。
• --env：将环境变量传递到模板中的变量 ENV。
• -E，--expr <EXPR>：不是渲染模板，而是评估一个表达式。结果的处理由 --expr-out 决定。
• --expr-out <MODE>：设置表达式输出模式。默认是print。 print仅打印表达式输出，json将其作为JSON序列化值输出，status隐藏输出但报告退出状态。true转换为0，而false转换为1。数值结果保持不变。
• --fuel <AMOUNT>：设置发动机的最大燃料。当发动机耗尽燃料时将报错。
• --repl：为MiniJinja表达式启动交互式读取-评估-打印循环。
• --dump <KIND>：打印模板的内部结构。可能的选项包括tokens查看分词器的输出，ast查看解析后的AST，以及instructions检查编译的字节码。
• -o、--output <FILENAME>：将输出写入文件名而不是标准输出。
• --select <SELECTOR>：选择输入数据的路径。
• --generate-completion <SHELL>：为给定的shell生成补全。
• --version：打印版本。
• --help：打印帮助。

minijinja-cli template.j2 input.ini --section default

{{ values.key }}

{{ key }}

minijinja-cli template.j2 -D name=World -D count:=3

echo '{"name": "World"}' | minijinja-cli -f json template.j2 -

minijinja-cli --env -E "ENV.HOME or ENV.USERPROFILE"

minijinja-cli --repl -D name=World
MiniJinja Expression REPL
Type .help for help. Use .quit or ^D to exit.
>>> name|upper
"WORLD"
>>> range(3)
[0, 1, 2]