金库银行

金库银行是一个命令行应用程序，用于列出、提取和创建由 Kilohearts 产品（如 Kilohearts 的 Phase Plant、Snap Heap 和 Multipass 以及任何 Snap In）使用的银行文件。

此应用程序由 Sheldon Young 独立开发。金库银行不是 Kilohearts 产品，请不要联系他们寻求支持。

安装

二进制文件

二进制文件可在多个平台上从 GitHub 发布 获取。

从 crates.io

要从 crates.io 安装此应用程序，请确保已安装 Rust，然后运行

$ cargo install kibank

从源代码

要从源代码安装此应用程序，请确保已安装 git 和 Rust，然后运行

$ git clone https://github.com/softdev.ca/kibank
$ cd kibank 
$ cargo build --release
$ cp target/release/kibank /your/dest/path/

用法

列出银行内容

$ kibank list MyBank.bank

查看银行详细信息

$ kibank info MyBank.bank

将银行提取到当前目录

$ kibank extract MyBank.bank

将银行提取到指定目录

$ kibank extract -d output_directory MyBank.bank

创建新的银行

要创建新的银行，请提供要包含的文件和目录的名称作为参数。只有被识别为兼容的文件才会包含在银行中。

$ kibank create MyBank.bank your_files_and_directories

要设置银行使用的背景图片，请包含名为 background.png 或 background.jpg 的文件。

要创建带有附加元数据的新的银行

$ kibank create --author "Your Name" --name "My Bank" --description "Weird and wonderful presets" MyNewBank.bank presets samples/*.wav

要直接提供元数据来创建新的银行，请在银行中包含一个名为 index.json 的文件，其内容格式如下

{
  "name": "My Bank",
  "author": "Your Name",
  "description": "My weird and wonderful presets"
}

获取帮助

有关如何使用 kibank 的更多信息，请使用 --help 选项

$ kibank --help
kibank 0.1.2
Sheldon Young <[email protected]>
Tool for Kilohearts banks

USAGE:
    kibank [OPTIONS] [SUBCOMMAND]

OPTIONS:
    -h, --help       Print help information
    -v, --verbose
    -V, --version    Print version information

SUBCOMMANDS:
    create     Create a new bank [aliases: c]
    extract    Extract the contents of a bank [aliases: x]
    help       Print this message or the help of the given subcommand(s)
    info       Display the details of a bank [aliases: i]
    list       Display the contents of a bank [aliases: l]

每个子命令（如 create、extract、info 和 list）也都有 --help 选项。例如

$ kibank create --help
kibank-create
Create a new bank

USAGE:
    kibank create [OPTIONS] <BANK_FILE> <IN_FILES>...

ARGS:
    <BANK_FILE>      File name of new bank
    <IN_FILES>...    Files and directories to add to the bank

OPTIONS:
    -a, --author <author>              Creator of the new bank
    -d, --description <description>    Overview of the new bank
    -h, --help                         Print help information
    -n, --name <name>                  Title of the new bank

与 Kilohearts Bank Maker 相比

Kilohearts 的 Bank Maker 是创建银行的官方应用程序。区别在于 Bank Maker

• 有一个图形用户界面
• 支持打开和编辑的项目文件
• 可以直接修改每个预设中的描述和作者
• 可以为每个文件指定一个额外的子目录

Kibank 是一个命令行应用程序。对于那些习惯于命令行的人来说，它有更直接的流程，并且更容易自动化。

库

该应用程序的功能可以作为库在您的 Rust 应用程序中重复使用。您可以在 crates.io 上添加 kibank 包到您的 Cargo.toml 文件中。

[dependencies]
kibank = { version = "0", default-features = false }

问题

如果您对这个项目有任何问题或疑问，请通过创建一个 GitHub 问题 来联系我们。

贡献

我们邀请您为新的功能、修复或更新做出贡献，无论大小；我们总是很高兴收到拉取请求，并尽力尽快处理它们。

在您开始编码之前，我们建议通过 GitHub 问题 讨论您的计划，尤其是对于更具雄心的贡献。这给了其他贡献者一个机会，指导您正确的方向，对您的方案提供反馈，并帮助您了解是否有人正在做相同的事情。

对本项目的贡献版权归贡献者所有。不需要将版权转让给本项目。

许可

根据 Apache 许可证 2.0 版（“许可证”）；除非遵守许可证，否则您不得使用此文件。您可以在以下位置获得许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”基础分发，不提供任何明示或暗示的保证或条件。有关许可证中规定的权限和限制的具体语言，请参阅许可证。