import typer
from pathlib import Path
from enum import Enum
app = typer.Typer(help="檔案管理工具")
class Mode(str, Enum):
    copy = "copy"
    move = "move"
    delete = "delete"
@app.command()
def process(
    input_file: Path = typer.Argument(..., help="輸入檔案路徑"),
    output_file: Path = typer.Argument(None, help="輸出檔案路徑 (copy/move 模式需要)"),
    mode: Mode = typer.Option(Mode.copy, "--mode", "-m", help="處理模式"),
    overwrite: bool = typer.Option(False, "--overwrite", "-o", help="是否覆蓋輸出檔案"),
    verbose: bool = typer.Option(False, "--verbose", "-v", help="顯示詳細訊息")
):
    """
    處理檔案：支援 copy/move/delete。
    """
    if verbose:
        typer.echo(f"Mode={mode}, Input={input_file}, Output={output_file}, Overwrite={overwrite}")
    if not input_file.exists():
        typer.echo("❌ Input file does not exist.")
        raise typer.Exit(code=1)
    if mode in [Mode.copy, Mode.move]:
        if output_file is None:
            typer.echo("❌ Output file required for copy/move.")
            raise typer.Exit(code=1)
        if output_file.exists() and not overwrite:
            typer.echo("❌ Output file already exists. Use --overwrite.")
            raise typer.Exit(code=1)
    if mode == Mode.copy:
        typer.echo(f"📂 Copying {input_file} → {output_file}")
    elif mode == Mode.move:
        typer.echo(f"📂 Moving {input_file} → {output_file}")
    elif mode == Mode.delete:
        typer.echo(f"🗑️ Deleting {input_file}")
# 子指令群組
user_app = typer.Typer(help="使用者管理")
app.add_typer(user_app, name="user")
@user_app.command()
def add(
    username: str = typer.Argument(..., help="使用者名稱"),
    admin: bool = typer.Option(False, "--admin", help="是否為管理員")
):
    typer.echo(f"✅ Added user {username}, admin={admin}")
@user_app.command()
def remove(
    username: str = typer.Argument(..., help="要刪除的使用者名稱")
):
    typer.echo(f"🗑️ Removed user {username}")
if __name__ == "__main__":
    app()

# 檔案處理
python main.py process input.txt output.txt --mode copy --verbose
python main.py process input.txt output.txt --mode move --overwrite
python main.py process input.txt --mode delete
# 使用者管理
python main.py user add Alice --admin
python main.py user remove Bob

project/
│── main.py          # 入口點，註冊 Typer app
│── commands/
│   │── __init__.py  # 匯入子指令
│   │── files.py     # 檔案處理相關指令
│   │── users.py     # 使用者管理相關指令
│── utils/
│   │── helpers.py   # 共用工具函式
│── tests/
│   │── test_cli.py  # CLI 測試

import typer
from commands import files, users
app = typer.Typer(help="專案級 CLI 工具")
# 加入子指令群組
app.add_typer(files.app, name="files")
app.add_typer(users.app, name="users")
if __name__ == "__main__":
    app()

import typer
from pathlib import Path
app = typer.Typer(help="檔案相關操作")
@app.command()
def copy(
    src: Path = typer.Argument(..., help="來源檔案"),
    dst: Path = typer.Argument(..., help="目標檔案"),
    overwrite: bool = typer.Option(False, "--overwrite", "-o", help="是否覆蓋")
):
    if dst.exists() and not overwrite:
        typer.echo("❌ 目標檔案已存在，請使用 --overwrite")
        raise typer.Exit(code=1)
    typer.echo(f"📂 Copy {src} → {dst}")

import typer
app = typer.Typer(help="使用者管理")
@app.command()
def add(
    username: str = typer.Argument(..., help="使用者名稱"),
    admin: bool = typer.Option(False, "--admin", help="是否為管理員")
):
    typer.echo(f"✅ 新增使用者 {username}, admin={admin}")
@app.command()
def remove(username: str):
    typer.echo(f"🗑️ 移除使用者 {username}")

from typer.testing import CliRunner
from main import app
runner = CliRunner()
def test_add_user():
    result = runner.invoke(app, ["users", "add", "Alice", "--admin"])
    assert result.exit_code == 0
    assert "新增使用者 Alice" in result.stdout

開始設計 CLI 指令
        │
        ├── 這個參數是否必填？
        │       │
        │       ├── 是 → 使用 Argument
        │       │       └── 需要型別限制嗎？
        │       │              ├── 是 → 使用 Enum
        │       │              └── 否 → 一般 Argument
        │       │
        │       └── 否 → 使用 Option
        │               └── 這是布林旗標嗎？
        │                      ├── 是 → Option(bool)，只需加上 --flag
        │                      └── 否 → Option(型別, 預設值)
        │
        ├── 是否需要子指令群組？
        │       ├── 是 → 建立 Typer 子 app (app.add_typer)
        │       └── 否 → 保持在主 app
        │
        ├── 是否需要環境變數整合？
        │       ├── 是 → Option(os.getenv("VAR"))
        │       └── 否 → 一般 Option/Argument
        │
        └── 是否需要測試？
                ├── 是 → 使用 CliRunner 撰寫 pytest
                └── 否 → 可直接執行