papycli 0.5.1__tar.gz → 0.5.3__tar.gz

papycli-0.5.3/.github/workflows/release.yml

@@ -0,0 +1,151 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Verify tag version matches pyproject.toml
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PKG_VERSION=$(python3 -c "
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          ")
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "::error::Version mismatch: tag=$TAG_VERSION, pyproject.toml=$PKG_VERSION"
+            exit 1
+          fi
+          echo "Version OK: $PKG_VERSION"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  github-release:
+    name: Create GitHub Release (draft)
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      models: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history needed for git log
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Get previous release tag
+        id: prev-tag
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          # Exclude drafts, pre-releases, and the current tag to get the true previous release
+          PREV_TAG=$(gh release list --repo "$REPO" --limit 20 \
+            --json tagName,isDraft,isPrerelease \
+            --jq 'map(select((.isDraft | not) and (.isPrerelease | not) and (.tagName != env.TAG))) | .[0].tagName // ""')
+          echo "prev_tag=$PREV_TAG" >> "$GITHUB_OUTPUT"
+
+      - name: Collect commits since previous release
+        id: commits
+        env:
+          TAG: ${{ github.ref_name }}
+          PREV_TAG: ${{ steps.prev-tag.outputs.prev_tag }}
+        run: |
+          set -euo pipefail
+          if [ -n "${PREV_TAG}" ]; then
+            RANGE="${PREV_TAG}..${TAG}"
+          else
+            RANGE="${TAG}"
+          fi
+          # Validate that the range resolves before proceeding
+          if ! git rev-parse "${RANGE}" > /dev/null 2>&1; then
+            echo "Error: git range '${RANGE}' does not resolve." >&2
+            exit 1
+          fi
+          # Collect up to 100 subject lines; exclude merge commits
+          # Use --max-count instead of | head to avoid SIGPIPE under set -euo pipefail
+          COMMITS=$(git log "${RANGE}" --no-merges --max-count=100 --pretty=format:"%s")
+          # Use a unique delimiter to avoid collision with commit message content
+          DELIM=$(uuidgen)
+          {
+            echo "commits<<${DELIM}"
+            echo "${COMMITS}"
+            echo "${DELIM}"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Generate release notes with GitHub Models
+        id: ai
+        uses: actions/ai-inference@v1
+        with:
+          model: openai/gpt-4o-mini
+          system-prompt: |
+            You are a technical writer generating GitHub release notes from git commit messages.
+
+            Rules:
+            - Classify each commit subject into one of three sections:
+                ## Features   — commits starting with "feat:"
+                ## Bug Fixes  — commits starting with "fix:"
+                ## Maintenance — all other commits (refactor:, ci:, test:, perf:, etc.)
+            - IGNORE commits starting with "docs:" or "chore:" — do not include them at all.
+            - Rewrite each item as a concise, user-friendly bullet point (do not copy the raw commit subject verbatim).
+            - Omit any section that has no entries.
+            - Output valid Markdown only. No preamble, no explanation outside the Markdown.
+          prompt: |
+            Generate release notes for ${{ github.ref_name }} from the following commit messages:
+
+            ${{ steps.commits.outputs.commits }}
+
+      - name: Write release notes to file
+        env:
+          NOTES: ${{ steps.ai.outputs.response }}
+        run: printf '%s' "$NOTES" > release_notes.md
+
+      - name: Create draft release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          gh release create "$TAG" \
+            --repo "$REPO" \
+            --title "$TAG" \
+            --notes-file release_notes.md \
+            --draft \
+            dist/*
+
+  pypi-publish:
+    name: Publish to PyPI
+    needs: github-release
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{papycli-0.5.1 → papycli-0.5.3}/CLAUDE.md

@@ -39,6 +39,7 @@ papycli/
 │       ├── main.py          # エントリポイント・引数パース
 │       ├── init_cmd.py      # config add コマンド（spec の変換・保存）
 │       ├── api_call.py      # HTTP リクエスト実行
+│       ├── checker.py       # --check / --check-strict のパラメータ検証
 │       ├── completion.py    # シェル補完スクリプト生成
 │       ├── config.py        # 設定ファイルの読み書き
 │       ├── i18n.py          # 日英ヘルプテキストの切り替えユーティリティ
@@ -46,6 +47,7 @@ papycli/
 │       └── summary.py       # summary コマンド・CSV 出力
 ├── tests/
 │   ├── test_api_call.py
+│   ├── test_checker.py
 │   ├── test_completion.py
 │   ├── test_config.py
 │   ├── test_i18n.py
@@ -66,7 +68,7 @@ papycli/
 ### 主要モジュール
 
 **`main.py`** — CLI エントリポイント
-引数をパースし、各コマンド（`config add`/`use`/`remove`/`list`/`completion-script`、`summary`、メソッド呼び出し）に処理を委譲する。シェル補完用の `_complete` 内部コマンドもここで定義する。
+引数をパースし、各コマンド（`config add`/`use`/`remove`/`list`/`completion-script`、`spec`、`summary`、メソッド呼び出し）に処理を委譲する。シェル補完用の `_complete` 内部コマンドもここで定義する。
 
 **`init_cmd.py`** — API 初期化（`config add` コマンドの実処理）
 OpenAPI spec ファイルを受け取り、`$ref` を解決した上で papycli 内部の API 定義フォーマットに変換し、`$PAPYCLI_CONF_DIR/apis/<name>.json` に保存する。設定ファイル (`papycli.conf`) も更新する。
@@ -77,6 +79,9 @@ OpenAPI spec の JSON/YAML を読み込み、`$ref` を再帰的に解決して
 **`api_call.py`** — HTTP リクエスト実行
 メソッド・リソースパス・オプションを受け取り、`requests` ライブラリで HTTP リクエストを実行する。パステンプレート（`/pet/{petId}`）のマッチングと値の埋め込みも担当する。
 
+**`checker.py`** — パラメータ検証
+`--check` / `--check-strict` オプション用のリクエスト前バリデーションロジック。必須パラメータの存在確認、型チェック（integer / boolean）、enum 値の検証を行い、警告メッセージのリストを返す。
+
 **`completion.py`** — シェル補完
 bash / zsh 向けの補完スクリプトを生成する。補完の候補はメソッド、リソースパス、パラメータ名、enum 値の順にコンテキストに応じて提供する。
 
@@ -155,6 +160,7 @@ papycli config use <api-name>
 papycli config remove <api-name>
 papycli config list
 papycli config completion-script <bash|zsh>
+papycli spec [resource]
 papycli summary [resource] [--csv]
 papycli --version
 papycli --help / -h
@@ -171,6 +177,8 @@ papycli --help / -h
 - `-p <name.subname> <value>` — ドット記法で 1 レベルのネストオブジェクトを構築する
 - `-d <json>` — 生の JSON 文字列。`-p` オプションを上書きする
 - `-H <header: value>` — カスタム HTTP ヘッダー
+- `--check` — 送信前にパラメータを検証する（警告を stderr に出力、リクエストは送信）
+- `--check-strict` — 送信前にパラメータを検証する（警告を stderr に出力、問題があればリクエスト中止・exit 1）
 
 ### パステンプレートのマッチング
 

{papycli-0.5.1 → papycli-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: papycli
-Version: 0.5.1
+Version: 0.5.3
 Summary: A CLI tool to call REST APIs defined in OpenAPI 3.0 specs
 Project-URL: Homepage, https://github.com/tmonj1/papycli
 Project-URL: Repository, https://github.com/tmonj1/papycli
@@ -34,6 +34,8 @@ Description-Content-Type: text/markdown
 - Auto-generates a CLI from any OpenAPI 3.0 spec
 - Shell completion for bash and zsh
 - Register and switch between multiple APIs
+- Inspect API specs with `papycli spec`
+- Validate request parameters before sending with `--check` / `--check-strict`
 
 ## Requirements
 
@@ -41,8 +43,6 @@ Description-Content-Type: text/markdown
 |------|-------|
 | Python | 3.12 or later |
 
-No external tools (e.g. `jq`) required. Works with Python and pip alone.
-
 ---
 
 ## Installation
@@ -126,13 +126,13 @@ Once shell completion is enabled, tab completion is available:
 
 ```
 $ papycli <TAB>
-  get  post  put  patch  delete  config  summary
+  get  post  put  patch  delete  config  spec  summary
 
 $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -210,10 +210,13 @@ papycli config use <api-name>              Switch the active API
 papycli config list                        List registered APIs and current configuration
 papycli config completion-script <bash|zsh>  Print a shell completion script
 
-# API call commands
+# Inspection commands
+papycli spec [resource]             Show the raw internal API spec (filter by resource path)
 papycli summary [resource]          List available endpoints (filter by resource prefix)
                                       Required params marked with *, array params with []
 papycli summary --csv               Output endpoints in CSV format
+
+# API call commands
 papycli <method> <resource> [options]
 
 Methods:
@@ -230,6 +233,9 @@ Options:
                               →  {"category":{"id":"1","name":"Dogs"}}
   -d <json>               Raw JSON body (overrides -p)
   --summary               Show endpoint info without sending a request
+  --check                 Validate params before sending (warn on stderr, request is still sent)
+  --check-strict          Validate params before sending (warn on stderr, abort with exit 1 on failure)
+  --verbose / -v          Show HTTP status line
   --version               Show version
   --help / -h             Show help
 
@@ -257,6 +263,4 @@ Environment variables:
 git clone https://github.com/tmonj1/papycli.git
 cd papycli
 pip install -e ".[dev]"
-```
-
-See [CLAUDE.md](CLAUDE.md) for details.
+```

{papycli-0.5.1 → papycli-0.5.3}/README.ja.md

@@ -7,6 +7,8 @@
 - OpenAPI 3.0 仕様から CLI を自動生成
 - シェル補完（bash / zsh）対応
 - 複数 API の登録・切り替え
+- `papycli spec` による API スペックの確認
+- `--check` / `--check-strict` によるリクエスト前のパラメータ検証
 
 ## 必要環境
 
@@ -97,13 +99,13 @@ papycli delete /pet/1
 
 ```
 $ papycli <TAB>
-  get  post  put  patch  delete  config  summary
+  get  post  put  patch  delete  config  spec  summary
 
 $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -181,10 +183,13 @@ papycli config use <api-name>              アクティブな API を切り替
 papycli config list                        登録済み API と現在の設定を一覧表示する
 papycli config completion-script <bash|zsh>  シェル補完スクリプトを出力する
 
-# API 呼び出しコマンド
+# 確認コマンド
+papycli spec [resource]             内部 API スペックを表示する（リソースパスでフィルタ可能）
 papycli summary [resource]          利用可能なエンドポイントを表示する（リソースでフィルタ可能）
                                       必須パラメータは * 付き、配列パラメータは [] 付きで表示
 papycli summary --csv               CSV フォーマットでエンドポイントを表示する
+
+# API 呼び出しコマンド
 papycli <method> <resource> [options]
 
 メソッド:
@@ -201,6 +206,9 @@ papycli <method> <resource> [options]
                               →  {"category":{"id":"1","name":"Dogs"}}
   -d <json>               生の JSON ボディ（-p を上書きする）
   --summary               リクエストを送らずにエンドポイント情報を表示する
+  --check                 送信前にパラメータを検証する（警告を stderr に出力、リクエストは送信）
+  --check-strict          送信前にパラメータを検証する（警告を stderr に出力、問題があればリクエスト中止・exit 1）
+  --verbose / -v          HTTP ステータス行を表示する
   --version               バージョンを表示する
   --help / -h             使い方を表示する
 
@@ -228,6 +236,4 @@ papycli <method> <resource> [options]
 git clone https://github.com/<your-org>/papycli.git
 cd papycli
 pip install -e ".[dev]"
-```
-
-詳細は [CLAUDE.md](CLAUDE.md) を参照してください。
+```

{papycli-0.5.1 → papycli-0.5.3}/README.md

@@ -7,6 +7,8 @@
 - Auto-generates a CLI from any OpenAPI 3.0 spec
 - Shell completion for bash and zsh
 - Register and switch between multiple APIs
+- Inspect API specs with `papycli spec`
+- Validate request parameters before sending with `--check` / `--check-strict`
 
 ## Requirements
 
@@ -14,8 +16,6 @@
 |------|-------|
 | Python | 3.12 or later |
 
-No external tools (e.g. `jq`) required. Works with Python and pip alone.
-
 ---
 
 ## Installation
@@ -99,13 +99,13 @@ Once shell completion is enabled, tab completion is available:
 
 ```
 $ papycli <TAB>
-  get  post  put  patch  delete  config  summary
+  get  post  put  patch  delete  config  spec  summary
 
 $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -183,10 +183,13 @@ papycli config use <api-name>              Switch the active API
 papycli config list                        List registered APIs and current configuration
 papycli config completion-script <bash|zsh>  Print a shell completion script
 
-# API call commands
+# Inspection commands
+papycli spec [resource]             Show the raw internal API spec (filter by resource path)
 papycli summary [resource]          List available endpoints (filter by resource prefix)
                                       Required params marked with *, array params with []
 papycli summary --csv               Output endpoints in CSV format
+
+# API call commands
 papycli <method> <resource> [options]
 
 Methods:
@@ -203,6 +206,9 @@ Options:
                               →  {"category":{"id":"1","name":"Dogs"}}
   -d <json>               Raw JSON body (overrides -p)
   --summary               Show endpoint info without sending a request
+  --check                 Validate params before sending (warn on stderr, request is still sent)
+  --check-strict          Validate params before sending (warn on stderr, abort with exit 1 on failure)
+  --verbose / -v          Show HTTP status line
   --version               Show version
   --help / -h             Show help
 
@@ -230,6 +236,4 @@ Environment variables:
 git clone https://github.com/tmonj1/papycli.git
 cd papycli
 pip install -e ".[dev]"
-```
-
-See [CLAUDE.md](CLAUDE.md) for details.
+```

{papycli-0.5.1 → papycli-0.5.3}/design_doc.md

@@ -37,11 +37,13 @@ papycli/
 │       ├── spec_loader.py   # OpenAPI spec 読み込み・$ref 解決・内部形式変換
 │       ├── init_cmd.py      # config add コマンドの処理
 │       ├── api_call.py      # HTTP リクエスト実行・パステンプレートマッチング
+│       ├── checker.py       # --check / --check-strict のパラメータ検証
 │       ├── summary.py       # summary コマンドの出力
 │       ├── completion.py    # bash / zsh 補完スクリプト生成
 │       └── i18n.py          # 日英ヘルプテキストの切り替えユーティリティ
 ├── tests/
 │   ├── test_api_call.py
+│   ├── test_checker.py
 │   ├── test_completion.py
 │   ├── test_config.py
 │   ├── test_i18n.py
@@ -174,12 +176,19 @@ papycli/
   - `requests` による HTTP 実行
   - レスポンスの出力（JSON は整形表示、それ以外はそのまま）
 - `main.py` に `papycli <method> <resource>` コマンド追加
-- テスト: `test_api_call.py`
+- `main.py` に `papycli spec [resource]` コマンド追加（内部 API 定義の JSON 表示）
+- `checker.py`
+  - `--check` / `--check-strict` オプション用のパラメータ検証ロジック
+  - 必須パラメータの存在確認、型チェック（integer / boolean）、enum 値の検証
+  - `--check`: 問題があっても警告を出力してリクエストを送信する
+  - `--check-strict`: 問題があれば警告を出力してリクエストを中止し exit 1
+- テスト: `test_api_call.py`、`test_checker.py`
   - パステンプレートマッチングの各ケース
   - `-p` による JSON 構築（配列、ネスト）
   - `responses` ライブラリで HTTP をモックしたエンドツーエンドテスト
+  - `check_request()` の各検証ケース（必須・型・enum・raw body）
 
-**完了条件**: `papycli get /store/inventory`、`papycli post /pet -p name "My Dog" -p status available` 等が Petstore サーバーに対して動作する。テストがパスする。
+**完了条件**: `papycli get /store/inventory`、`papycli post /pet -p name "My Dog" -p status available` 等が Petstore サーバーに対して動作する。`papycli spec` で内部 API 定義が表示される。`--check` / `--check-strict` でパラメータ検証が動作する。テストがパスする。
 
 ---
 
@@ -217,9 +226,11 @@ papycli/
     4. パラメータ名補完: `-q <TAB>` → クエリパラメータ名の候補
     5. enum 値補完: `-q status <TAB>` → `available pending sold` 等
 - `main.py` に `--completion-script <bash|zsh>` コマンド追加
+- 補完候補の強化（`spec` コマンド、`summary --csv`、`--check`/`--check-strict` オプションを追加）
+- Windows 対応: `_complete` の出力を binary stream（LF のみ）に変更
 - 手動テスト手順をドキュメント化
 
-**完了条件**: `eval "$(papycli config completion-script zsh)"` 後にタブ補完が動作する。メソッド・リソース・クエリパラメータ名・ボディパラメータ名・enum 値が補完候補として表示される。
+**完了条件**: `eval "$(papycli config completion-script zsh)"` 後にタブ補完が動作する。メソッド・リソース・クエリパラメータ名・ボディパラメータ名・enum 値が補完候補として表示される。`spec`・`summary`・`--check`・`--check-strict` も補完候補に含まれる。
 
 ---
 

{papycli-0.5.1 → papycli-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "papycli"
-version = "0.5.1"
+version = "0.5.3"
 description = "A CLI tool to call REST APIs defined in OpenAPI 3.0 specs"
 readme = "README.md"
 license = {text = "MIT"}

papycli-0.5.3/src/papycli/checker.py

@@ -0,0 +1,126 @@
+"""リクエスト前のパラメータ検証ロジック。"""
+
+from __future__ import annotations
+
+import json
+from collections.abc import Sequence
+from typing import Any
+
+
+def _check_value(param: dict[str, Any], raw_value: Any) -> list[str]:
+    """単一パラメータ値に対して型・enum チェックを行い、警告メッセージのリストを返す。
+
+    raw_value は文字列（-p/-q 経由）または JSON から解析された任意の値。
+    """
+    warnings: list[str] = []
+    name = param["name"]
+    ptype = param.get("type", "")
+    enum = param.get("enum")
+
+    if ptype == "integer":
+        # Note: int(str(x)) rejects float strings like "1.5" (even if mathematically integer-like).
+        # For -d JSON where raw_value may already be a float (e.g. 1.5), this is intentional:
+        # the spec declares the type as integer, so floating-point values trigger a warning.
+        try:
+            int(str(raw_value))
+        except ValueError:
+            warnings.append(
+                f"Warning: parameter '{name}' expects integer, got '{raw_value}'"
+            )
+    elif ptype == "boolean":
+        if str(raw_value).lower() not in {"true", "false", "1", "0"}:
+            warnings.append(
+                f"Warning: parameter '{name}' expects boolean (true/false), got '{raw_value}'"
+            )
+
+    if enum is not None and str(raw_value) not in [str(e) for e in enum]:
+        warnings.append(
+            f"Warning: parameter '{name}' value '{raw_value}' is not in enum {enum}"
+        )
+
+    return warnings
+
+
+def check_request(
+    apidef: dict[str, Any],
+    method: str,
+    resource: str,
+    query_params: Sequence[tuple[str, str]],
+    body_params: Sequence[tuple[str, str]],
+    raw_body: str | None,
+) -> list[str]:
+    """リクエスト前に必須パラメータ・型・enum を検証し、警告メッセージのリストを返す。
+
+    問題がなければ空リストを返す。
+    """
+    from papycli.api_call import match_path_template  # lazy import to avoid circular dependency
+
+    warnings: list[str] = []
+
+    match = match_path_template(resource, list(apidef.keys()))
+    if match is None:
+        return warnings  # パス不明は api_call 側でエラーになるのでここでは無視
+
+    template, _ = match
+    ops: list[dict[str, Any]] = apidef[template]
+    op = next((o for o in ops if o["method"] == method), None)
+    if op is None:
+        return warnings
+
+    # ---- クエリパラメータのチェック ----
+    q_params: list[dict[str, Any]] = op.get("query_parameters", [])
+    provided_query = {name for name, _ in query_params}
+
+    for p in q_params:
+        if p.get("required") and p["name"] not in provided_query:
+            warnings.append(f"Warning: required query parameter '{p['name']}' is missing")
+
+    for name, value in query_params:
+        param_def = next((p for p in q_params if p["name"] == name), None)
+        if param_def:
+            warnings.extend(_check_value(param_def, value))
+
+    # ---- ボディパラメータのチェック ----
+    b_params: list[dict[str, Any]] = op.get("post_parameters", [])
+
+    if raw_body is not None:
+        # -d JSON の場合: JSON をパースして各フィールドをチェック
+        can_check_body = True
+        try:
+            parsed = json.loads(raw_body)
+        except json.JSONDecodeError:
+            warnings.append("Warning: failed to parse raw body as JSON")
+            can_check_body = False
+
+        if can_check_body and not isinstance(parsed, dict):
+            warnings.append(
+                "Warning: raw body is not a JSON object; parameter checks skipped"
+            )
+            can_check_body = False
+
+        if not can_check_body:
+            return warnings
+
+        body_dict: dict[str, Any] = parsed
+        provided_body = set(body_dict.keys())
+        for p in b_params:
+            if p.get("required") and p["name"] not in provided_body:
+                warnings.append(f"Warning: required body parameter '{p['name']}' is missing")
+
+        for p in b_params:
+            if p["name"] in body_dict:
+                warnings.extend(_check_value(p, body_dict[p["name"]]))
+    else:
+        # -p ペアの場合
+        provided_body = {name for name, _ in body_params}
+
+        for p in b_params:
+            if p.get("required") and p["name"] not in provided_body:
+                warnings.append(f"Warning: required body parameter '{p['name']}' is missing")
+
+        for name, value in body_params:
+            param_def = next((p for p in b_params if p["name"] == name), None)
+            if param_def:
+                warnings.extend(_check_value(param_def, value))
+
+    return warnings

{papycli-0.5.1 → papycli-0.5.3}/src/papycli/completion.py

@@ -12,7 +12,7 @@ from typing import Any
 
 METHODS = ["get", "post", "put", "patch", "delete"]
 CONFIG_SUBCOMMANDS = ["add", "completion-script", "list", "remove", "use"]
-TOP_LEVEL_COMMANDS = METHODS + ["config", "summary"]
+TOP_LEVEL_COMMANDS = METHODS + ["config", "spec", "summary"]
 
 # ---------------------------------------------------------------------------
 # シェルスクリプトテンプレート
@@ -140,6 +140,25 @@ def completions_for_context(
             return [c for c in CONFIG_SUBCOMMANDS if c.startswith(incomplete)]
         return []
 
+    # summary コマンドの補完
+    if words[1] == "summary":
+        if current == 2:
+            candidates: list[str] = []
+            if apidef is not None:
+                candidates = [p for p in sorted(apidef.keys()) if p.startswith(incomplete)]
+            if "--csv".startswith(incomplete):
+                candidates.append("--csv")
+            return candidates
+        if current == 3 and (len(words) <= 2 or words[2] != "--csv"):
+            return ["--csv"] if "--csv".startswith(incomplete) else []
+        return []
+
+    # spec コマンドの補完
+    if words[1] == "spec":
+        if current == 2 and apidef is not None:
+            return [p for p in sorted(apidef.keys()) if p.startswith(incomplete)]
+        return []
+
     # words[1] が HTTP メソッドでない場合は補完なし
     if words[1] not in METHODS:
         return []
@@ -177,7 +196,9 @@ def completions_for_context(
 
     # オプション名（エンドポイントのパラメータ有無に応じてフィルタリング）
     op = _find_op(apidef, method, resource)
-    opts: list[str] = ["-q", "-p", "-d", "-H", "--summary", "-v", "--verbose"]
+    opts: list[str] = [
+        "-q", "-p", "-d", "-H", "--summary", "-v", "--verbose", "--check", "--check-strict",
+    ]
     if op is not None:
         if not op.get("query_parameters"):
             opts = [o for o in opts if o != "-q"]