#ci #kicad #cli-tool #cli

bin+lib kicad-text-injector

一个小巧的 CLI 工具,用于替换 KiCad PCB (pcbnew) 文件中样式为 ${KEY} 的变量

2 个不稳定版本

0.3.1 2024年6月1日
0.2.2 2021年8月8日

#865命令行工具

Download history 160/week @ 2024-05-31 15/week @ 2024-06-07 4/week @ 2024-06-14 2/week @ 2024-06-28

每月 77 次下载

GPL-3.0-or-laterAGPL-3.0-or-later

48KB
415

KiCad 文本注入器

License: GPL-3.0-or-later REUSE status crates.io Docs dependency status Build status

In cooperation with FabCity Hamburg In cooperation with Open Source Ecology Germany

此工具允许您通过替换文本元素中的类型为 ${NAME} 的变量来后处理您的 KiCad PCB 文件。

您可以在 PCB 上的任何层放置占位文本 - 例如 ${PROJECT_REPO_URL} - 然后,此工具将填充实际值,例如 https://github.com/myorg/myproj。这对于填充最终输出的特定项目元数据非常有用,因此此工具主要针对 CI 作业,尽管也可以本地运行。

如何编译

您需要安装 Rust 语言和 Cargo。

然后您可以运行

scripts/build

获取工具

目前,您有两个选择

  1. 编译它 自己
  2. 发布页面 下载 Linux x86_64 静态链接的二进制文件

用法

$ kicad-text-injector --help
Given a KiCad PCB file (*.kicad_pcb) as input, replaces variables of the type `${KEY}` within text
fields with their respective value.

USAGE:
    kicad-text-injector [FLAGS] [OPTIONS] --input <input> --output <output>

FLAGS:
    -e, --env                       use environment variables for substitution in the text
    -f, --fail-on-missing-values    fail if no value is available for a variable key found in the
                                    input text
    -h, --help                      Prints help information
    -v, --verbose                   more verbose output (useful for debugging)
    -V, --version                   Prints version information

OPTIONS:
    -i, --input <input>             the input file to use; '-' for stdin [default: -]
    -o, --output <output>           the output file to use; '-' for stdout [default: -]
    -D, --variable <variable>...    a variable key-value pair to be used for substitution in the
                                    text

其他

我们强烈建议您使用 KiBot 工具 来从后处理的 KiCad 源生成最终输出。它可以生成比 Gerbers 和 PCB 的 2D 渲染更多的内容。

另请参阅 KiCad 图像/二维码注入器

资金

该项目由欧洲区域发展基金(ERDF)在 INTERFACER 项目 的背景下资助,从 2021 年 7 月到 2023 年 3 月。

Logo of the EU ERDF program

依赖项

~4–5.5MB
~100K SLoC