kotoba-cli 0.1.21

Command Line Interface for Kotoba graph processing system
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! Kotoba CLI - Deno-inspired command line interface
//!
//! Merkle DAG: cli_interface (build_order: 10)
//! Provides: Cli, Commands, ConfigManager, ProgressBar, LogFormatter
//! Dependencies: types, distributed_engine, network_protocol, cid_system

use clap::{Parser, Subcommand};

// Re-export core types for CLI interface
pub use config::ConfigManager;
pub use logging::LogFormatter;
pub use utils::ProgressBar;

// Import modules
pub mod commands;
pub mod config;
pub mod logging;
pub mod utils;

/// Kotoba CLIのメイン構造体
/// Merkle DAG: cli_interface -> Cli component
#[derive(Parser)]
#[command(name = "kotoba")]
#[command(about = "Kotoba - GP2-based Graph Rewriting Language")]
#[command(version = env!("CARGO_PKG_VERSION"))]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

/// Kotoba CLIのサブコマンド
/// Merkle DAG: cli_interface -> Commands component
#[derive(Subcommand)]
pub enum Commands {
    /// プロジェクト情報を表示
    Info {
        /// 詳細表示
        #[arg(short, long)]
        verbose: bool,
    },

    /// ドキュメント生成・管理コマンド
    #[command(subcommand)]
    Docs(DocsCommand),
}

/// ドキュメント関連サブコマンド
/// Merkle DAG: docs_cli -> docs generate, docs serve, docs search, docs init
#[derive(Subcommand)]
pub enum DocsCommand {
    /// ドキュメントを生成
    Generate {
        /// ソースディレクトリ
        #[arg(short, long, default_value = "src")]
        source: String,

        /// 出力ディレクトリ
        #[arg(short, long, default_value = "docs")]
        output: String,

        /// 設定ファイル
        #[arg(short, long)]
        config: Option<String>,

        /// ウォッチモード
        #[arg(short, long)]
        watch: bool,
    },

    /// ドキュメントサーバーを起動
    Serve {
        /// ポート番号
        #[arg(short, long, default_value = "3000")]
        port: u16,

        /// ホストアドレス
        #[arg(short, long, default_value = "127.0.0.1")]
        host: String,

        /// ドキュメントディレクトリ
        #[arg(short, long, default_value = "docs")]
        dir: String,

        /// オープン後にブラウザで開く
        #[arg(short, long)]
        open: bool,
    },

    /// ドキュメントを検索
    Search {
        /// 検索クエリ
        query: String,

        /// 検索対象ディレクトリ
        #[arg(short, long, default_value = "docs")]
        dir: String,

        /// JSON形式で出力
        #[arg(short, long)]
        json: bool,
    },

    /// ドキュメント設定を初期化
    Init {
        /// 設定ファイル名
        #[arg(short, long, default_value = "kdoc.toml")]
        config: String,

        /// 強制的に上書き
        #[arg(short, long)]
        force: bool,
    },
}