kotoba-cli 0.1.21

Command Line Interface for Kotoba graph processing system
Documentation

Kotoba CLI

Command Line Interface for Kotoba graph processing system.

概要

Kotoba CLI は、Kotoba のグラフ処理システムをコマンドラインから操作するためのインターフェースです。Deno CLI を参考にした使いやすいコマンド体系を提供します。

インストール

cargo install kotoba-cli

主なコマンド

ファイル実行

kotoba run src/main.kotoba
kotoba run --watch src/main.kotoba

サーバー起動

kotoba serve
kotoba serve --port 8080 --host 0.0.0.0

プロジェクト管理

kotoba init my-project
kotoba init --template advanced my-project

コンパイル

kotoba compile src/main.kotoba
kotoba compile --output dist/main --optimize 2 src/main.kotoba

開発支援

kotoba test
kotoba fmt
kotoba lint
kotoba doc

情報表示

kotoba info
kotoba info --verbose

設定

CLIの設定は ~/.config/kotoba/cli.toml で管理されます:

[default]
log_level = "info"
default_port = 3000

[cache]
enabled = true
directory = "~/.cache/kotoba"
max_size_mb = 100
ttl_hours = 24

[server]
host = "127.0.0.1"
port = 3000
timeout_seconds = 30
max_connections = 100
cors_enabled = true

[compiler]
optimization_level = 0
include_debug_info = true
generate_source_maps = true
target_arch = "x86_64"

アーキテクチャ

  • CLI Parser: clap を使用したコマンドライン引数解析
  • Configuration: TOML ベースの設定管理
  • Logging: tracing を使用した構造化ログ
  • Async Runtime: tokio を使用した非同期処理
  • File Operations: tokio-util を使用したファイル操作

拡張性

CLI は以下の機能をサポートしています:

  • プラグインシステム: カスタムコマンドの追加
  • 設定プロファイル: 環境別の設定切り替え
  • シェル補完: Bash, Zsh, Fish の補完スクリプト生成
  • スクリプト実行: プロジェクト固有のスクリプト実行

依存関係

  • clap: コマンドライン引数解析
  • tokio: 非同期ランタイム
  • tracing: 構造化ログ
  • serde: シリアライズ/デシリアライズ
  • anyhow: エラーハンドリング