combu

crates.io version license

combu is a customizable (or rather bare bones...?) cli framework. The library name "combu" comes from command + 昆布(konbu, it means kelp in japanese).

combu has no dependencies(or depends on only std library). Crate.io's page is here.

combu(com + 昆布)は柔軟に CLI を組み上げられることを目標とした、カスタマイズ可能(というより骨組みを組み上げてあるだけのような気もする)な CLI フレームワークです。（一時クレートの名前が cmb だったこともありましたが、現在は combu です）

Features (特徴)

flag parsing in Unix format (Unix 形式でのフラグパース)
Nestable sub commmands (サブコマンド（多重可能）)
No dependencies; combu depends on only std library (標準ライブラリ以外への依存ライブラリなし)
Typed flag: Bool, String, Int and Float, inspired from seahorse（seahorse を参考にした Bool, String, Int, Float の型つきフラグ）
common flag, local flag (コモンフラグ、ローカルフラグ両方を設定可能)
flag parsing before sub command args(サブコマンド前のフラグの受付)
独自でパース等を行いたい場合に再利用できそうな構造体の設定
- 似たような CLI フレームワークを作りたいときに使用できる部品を用意
Useful presets (コマンド、フラグ等のプリセット)
Return the result of run as Result (実行結果を Result に込めて実行後返却)

Documentation

Here

Installation to your project (プロジェクトでの使用方法)

Combu exists on crates.io. You can use(or import) this crate like other crate that exists on crates.io.

combu は crates.io に登録してありますので、他の crates.io 上のクレートと同じように使用（インポート）することが可能です。

Edit cargo.toml manually (手動での cargo.toml への追加)

Add

toml combu="[version you want to use]"

to cargo.toml.

上記コードでバージョンを指定して、cargo.toml に追加してください。

Use cargo-edit (Recommended) (cargo-edit でプロジェクトに追加する(推奨))

If you installed cargo-edit, exec below command under the target project:

bash cargo add combu

cargo-edit をインストールしてある場合は、上記のコマンドを実行することで使用可能です。

Quick Start

```rust use combu::command::presets::func::helptablizewithaliasdedup; use combu::{actionresult, checkerror, checkhelp, done, presetroot, Command}; use combu::{Context, Flag}; use std::env;

fn main() { let r = presetroot!(act) .usage(env!("CARGOPKGNAME").tostring() + " [args]") .commonflag( Flag::newbool("help") .shortalias('h') .description("show help"), ) .localflag( Flag::newbool("local") .shortalias('l') .description("local flag"), ) .runfrom_args(env::args().collect()); }

fn act(cmd: Command, c: Context) -> actionresult!() { checkerror!(cmd, c); checkhelp!(cmd, c, helptablizewithalias_dedup); println!("Hello, combu - {:?}", c.args);