Back to Details

add-command

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Add support for 
$ARGUMENTS
in Dippy.
为Dippy中的
$ARGUMENTS
添加支持。

1. Research

1. 调研

tldr pages:
ls ~/source/tldr/pages/*/$ARGUMENTS*.md
cat ~/source/tldr/pages/*/$ARGUMENTS.md
CLI docs:
$ARGUMENTS --help
man $ARGUMENTS
Note which operations are read-only vs mutations.
tldr页面：
ls ~/source/tldr/pages/*/$ARGUMENTS*.md
cat ~/source/tldr/pages/*/$ARGUMENTS.md
CLI文档：
$ARGUMENTS --help
man $ARGUMENTS
记录哪些操作是只读的，哪些是变更操作。

2. Decide: Handler or SIMPLE_SAFE?

2. 决策：使用Handler还是SIMPLE_SAFE？

  • SIMPLE_SAFE: Always safe regardless of arguments (read-only, no destructive flags). Go to step 3A.
  • Handler: Needs subcommand/flag analysis. Go to step 3B.
  • SIMPLE_SAFE：无论传入什么参数都始终安全（只读，无破坏性标识）。跳转至步骤3A。
  • Handler：需要进行子命令/标识分析。跳转至步骤3B。

3A. SIMPLE_SAFE Path

3A. SIMPLE_SAFE路径

Add to 
SIMPLE_SAFE
in 
src/dippy/core/allowlists.py
and add tests to 
tests/test_simple.py
in the appropriate category. Skip to step 5.
添加到
src/dippy/core/allowlists.py
的
SIMPLE_SAFE
列表中，并在
tests/test_simple.py
的对应分类下添加测试用例。跳转至步骤5。

3B. Handler Path

3B. Handler路径

Create 
tests/cli/test_$ARGUMENTS.py
:
python
"""Test cases for $ARGUMENTS."""

import pytest
from conftest import is_approved, needs_confirmation

TESTS = [
    # Safe operations
    ("$ARGUMENTS <safe-subcommand>", True),
    ("$ARGUMENTS --help", True),
    # Unsafe operations
    ("$ARGUMENTS <unsafe-subcommand>", False),
]

@pytest.mark.parametrize("command,expected", TESTS)
def test_command(check, command: str, expected: bool):
    result = check(command)
    if expected:
        assert is_approved(result), f"Expected approve: {command}"
    else:
        assert needs_confirmation(result), f"Expected confirm: {command}"
创建
tests/cli/test_$ARGUMENTS.py
文件：
python
"""Test cases for $ARGUMENTS."""

import pytest
from conftest import is_approved, needs_confirmation

TESTS = [
    # Safe operations
    ("$ARGUMENTS <safe-subcommand>", True),
    ("$ARGUMENTS --help", True),
    # Unsafe operations
    ("$ARGUMENTS <unsafe-subcommand>", False),
]

@pytest.mark.parametrize("command,expected", TESTS)
def test_command(check, command: str, expected: bool):
    result = check(command)
    if expected:
        assert is_approved(result), f"Expected approve: {command}"
    else:
        assert needs_confirmation(result), f"Expected confirm: {command}"

4. Implement Handler

4. 实现Handler

Create 
src/dippy/cli/$ARGUMENTS.py
:
python
"""$ARGUMENTS handler for Dippy."""

from dippy.cli import Classification, HandlerContext

COMMANDS = ["$ARGUMENTS"]

SAFE_ACTIONS = frozenset({"list", "show", "status"})

def classify(ctx: HandlerContext) -> Classification:
    tokens = ctx.tokens
    action = tokens[1] if len(tokens) > 1 else None
    if action in SAFE_ACTIONS:
        return Classification("allow", description=f"$ARGUMENTS {action}")
    return Classification("ask", description="$ARGUMENTS")
For handler patterns (nested subcommands, flag-checking, delegation), see patterns.md.
创建
src/dippy/cli/$ARGUMENTS.py
文件：
python
"""$ARGUMENTS handler for Dippy."""

from dippy.cli import Classification, HandlerContext

COMMANDS = ["$ARGUMENTS"]

SAFE_ACTIONS = frozenset({"list", "show", "status"})

def classify(ctx: HandlerContext) -> Classification:
    tokens = ctx.tokens
    action = tokens[1] if len(tokens) > 1 else None
    if action in SAFE_ACTIONS:
        return Classification("allow", description=f"$ARGUMENTS {action}")
    return Classification("ask", description="$ARGUMENTS")
如需了解handler模式（嵌套子命令、标识检查、委托），请参阅patterns.md。

5. Iterate

5. 迭代

just test
Fix failures until tests pass.
just test
修复失败的用例，直到所有测试通过。

6. Verify

6. 验证

just check
MUST pass before you're done.
完成开发前必须确保
just check
运行通过。