papycli 0.8.0__tar.gz → 0.9.0__tar.gz

{papycli-0.8.0 → papycli-0.9.0}/CLAUDE.md

@@ -43,7 +43,8 @@ papycli/
 │       ├── completion.py    # シェル補完スクリプト生成
 │       ├── config.py        # 設定ファイルの読み書き
 │       ├── i18n.py          # 日英ヘルプテキストの切り替えユーティリティ
-│       ├── request_filter.py # リクエストフィルタープラグイン機構
+│       ├── filters.py        # リクエスト・レスポンスフィルタープラグイン機構
+│       ├── response_checker.py # --response-check のレスポンス検証
 │       ├── spec_loader.py   # OpenAPI spec の読み込み・$ref 解決
 │       └── summary.py       # summary コマンド・CSV 出力
 ├── tests/
@@ -54,7 +55,8 @@ papycli/
 │   ├── test_i18n.py
 │   ├── test_init_cmd.py
 │   ├── test_main.py
-│   ├── test_request_filter.py
+│   ├── test_filters.py
+│   ├── test_response_checker.py
 │   ├── test_spec_loader.py
 │   └── test_summary.py
 ├── examples/
@@ -92,9 +94,12 @@ bash / zsh 向けの補完スクリプトを生成する。補完の候補はメ
 **`config.py`** — 設定管理
 `papycli.conf` の読み書きと、`PAPYCLI_CONF_DIR` 環境変数の解決を行う。ログファイルパスの取得・設定・削除も担当する。
 
-**`request_filter.py`** — リクエスト・レスポンスフィルタープラグイン機構
+**`filters.py`** — リクエスト・レスポンスフィルタープラグイン機構
 エントリポイントグループ `papycli.request_filters` に登録されたフィルター関数をプラグイン名の昇順で呼び出し、リクエスト送信前に URL・クエリパラメータ・ボディ・ヘッダーを変換できるようにする。同様に `papycli.response_filters` グループのフィルター関数を呼び出し、レスポンス受信後にステータスコード・理由フレーズ（reason）・ボディ・ヘッダーを参照・変更できるようにする。`RequestContext` / `ResponseContext` データクラスと `load_filters()` / `apply_filters()` / `load_response_filters()` / `apply_response_filters()` 関数を提供する。
 
+**`response_checker.py`** — レスポンス検証
+`--response-check` オプション用のレスポンス検証ロジック。実際のHTTPステータスコードと OpenAPI spec に定義されたレスポンスコードを照合し、不一致の場合に警告する。また JSON レスポンスボディをスキーマに照合し、型・enum・必須フィールド・additionalProperties 等の違反を検出して警告メッセージのリストを返す。
+
 **`summary.py`** — サマリー表示
 登録済み API のエンドポイント一覧を整形して出力する。`--summary-csv` では CSV 形式で出力する。
 
@@ -169,6 +174,7 @@ papycli config list
 papycli config log [PATH] [--unset]
 papycli config completion-script <bash|zsh>
 papycli spec [resource]
+papycli spec --full [resource]
 papycli summary [resource] [--csv]
 papycli --version
 papycli --help / -h
@@ -187,6 +193,7 @@ papycli --help / -h
 - `-H <header: value>` — カスタム HTTP ヘッダー
 - `--check` — 送信前にパラメータを検証する（警告を stderr に出力、リクエストは送信）
 - `--check-strict` — 送信前にパラメータを検証する（警告を stderr に出力、問題があればリクエスト中止・exit 1）
+- `--response-check` — レスポンスのステータスコードとボディを OpenAPI spec に照合する（違反は stderr に出力、exit code には影響しない）
 
 ### パステンプレートのマッチング
 
@@ -220,22 +227,33 @@ papycli --help / -h
 
 ---
 
-## Git リポジトリ運用
+## コード調査・編集のワークフロー
+
+- シンボル操作はファイルを直接読む前にできるだけSerenaを使うこと
+- ファイル内容の検索には可能なら `grep` ではなく `rg`（ripgrep）を使うこと
+
+---
+
+## Git リポジトリ運用 (GitHub)
 
 ### issue 管理
 
 - ソースコードやドキュメントの追加・修正は原則として issue を作成し、それに対応する形で行う
-- issue のタイトルには適切なプレフィックスをつける
+- issue には適切なラベルをつける。使用するラベルは以下のいずれか。
 
-| プレフィックス | 用途 |
+| ラベル | 用途 |
 |---------------|------|
-| `feat:` | 新機能の追加 |
-| `fix:` | バグ修正 |
-| `refactor:` | 機能変更を伴わないリファクタリング |
-| `chore:` | ビルド・依存関係・設定等のメンテナンス |
-| `docs:` | ドキュメントのみの変更 |
+| `feature` | 新機能の追加 |
+| `bug` | バグ修正 |
+| `refactor` | 機能変更を伴わないリファクタリング |
+| `documentation` | ドキュメントのみの変更 |
+| `chore` | 上記以外 (ビルド・依存関係・設定等のメンテナンス) |
 
 ### ブランチ・コミット・PR
 
+- コミットメッセージは Conventional Commits に従う
+- コミットに互換性を損なう破壊的変更が含まれる場合、"BREAKING CHANGE:" フッターを**必ず**追加する
 - ソースコードの修正は適切な粒度でコミットし、プルリクエスト (PR) を提出する
-- PR でレビュー指摘を受けた場合、必要であればコードを修正し、PR に修正した旨のコメントを追加する
+- ソースコード修正時、異なるタイプの修正 (たとえば機能追加とリファクタリング) は極力コミットを分ける。
+- PR でレビュー指摘を受けた場合、必要であればコードを修正し、修正コミットをプッシュする
+- プッシュ後、修正内容を簡潔にまとめてPRに返信する

{papycli-0.8.0 → papycli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: papycli
-Version: 0.8.0
+Version: 0.9.0
 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
@@ -36,6 +36,7 @@ Description-Content-Type: text/markdown
 - Register and switch between multiple APIs
 - Inspect API specs with `papycli spec`
 - Validate request parameters before sending with `--check` / `--check-strict`
+- Validate response body and status code against the OpenAPI spec with `--response-check`
 - Automatically coerces `-p` values to the correct JSON type (integer, number, boolean) based on the API spec
 - Log requests and responses to a file with `papycli config log`
 - Extend request processing with request filter plugins (`papycli.request_filters` entry point)
@@ -147,7 +148,7 @@ $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict  --response-check
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -156,7 +157,7 @@ $ papycli get /pet/findByStatus -q status <TAB>
   available  pending  sold
 
 $ papycli post /pet -p <TAB>
-  name  status  photoUrls
+  name*  photoUrls*  status
 
 $ papycli post /pet -p status <TAB>
   available  pending  sold
@@ -260,6 +261,8 @@ Options:
   --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)
+  --response-check        Validate response status code and body against the OpenAPI spec
+                            (warn on stderr; violations do not affect exit code)
   --verbose / -v          Show HTTP status line
   --version               Show version
   --help / -h             Show help
@@ -281,7 +284,7 @@ A filter is a callable that receives a `RequestContext` and returns a modified `
 
 ```python
 # my_plugin.py
-from papycli.request_filter import RequestContext
+from papycli.filters import RequestContext
 
 def request_filter(ctx: RequestContext) -> RequestContext:
     ctx.headers["X-Request-ID"] = "my-id"
@@ -313,18 +316,20 @@ Install the package and filters are applied automatically on every request, sort
 
 You can inspect and transform incoming responses by writing a response filter plugin.
 
-A filter is a callable that receives a `ResponseContext` and returns a modified `ResponseContext`:
+A filter is a callable that receives a `ResponseContext` and returns a modified `ResponseContext`, or `None` to suppress the response output and stop the filter chain:
 
 ```python
 # my_plugin.py
-from papycli.request_filter import ResponseContext
+from papycli.filters import ResponseContext
 
-def response_filter(ctx: ResponseContext) -> ResponseContext:
+def response_filter(ctx: ResponseContext) -> ResponseContext | None:
     if isinstance(ctx.body, dict):
         ctx.body["_status"] = ctx.status_code
     return ctx
 ```
 
+Returning `None` suppresses the response output entirely and prevents any subsequent filters from running — useful for silencing responses that match certain criteria.
+
 Register it in your package's `pyproject.toml`:
 
 ```toml
@@ -344,6 +349,7 @@ Install the package and the filters are applied automatically after every respon
 | `reason` | `str` | HTTP response reason phrase (e.g. `"OK"`, `"Not Found"`). |
 | `headers` | `dict[str, str]` | Response headers. |
 | `body` | `dict \| list \| str \| int \| float \| bool \| None` | Parsed response body. Modify this field to replace the response body. |
+| `request_body` | `dict \| list \| str \| int \| float \| bool \| None` | Request body sent to the server (read-only). `None` for requests without a body. |
 
 ---
 

{papycli-0.8.0 → papycli-0.9.0}/README.ja.md

@@ -9,6 +9,7 @@
 - 複数 API の登録・切り替え
 - `papycli spec` による API スペックの確認
 - `--check` / `--check-strict` によるリクエスト前のパラメータ検証
+- `--response-check` による OpenAPI spec に基づくレスポンスのステータスコード・ボディ検証
 - API 仕様に基づいて `-p` の値を適切な JSON 型（integer / number / boolean）に自動変換
 - `papycli config log` によるリクエスト/レスポンスのファイルログ
 - リクエストフィルタープラグイン（`papycli.request_filters` エントリポイント）によるリクエスト処理の拡張
@@ -120,7 +121,7 @@ $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict  --response-check
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -129,7 +130,7 @@ $ papycli get /pet/findByStatus -q status <TAB>
   available  pending  sold
 
 $ papycli post /pet -p <TAB>
-  name  status  photoUrls
+  name*  photoUrls*  status
 
 $ papycli post /pet -p status <TAB>
   available  pending  sold
@@ -232,6 +233,8 @@ papycli <method> <resource> [options]
   --summary               リクエストを送らずにエンドポイント情報を表示する
   --check                 送信前にパラメータを検証する（警告を stderr に出力、リクエストは送信）
   --check-strict          送信前にパラメータを検証する（警告を stderr に出力、問題があればリクエスト中止・exit 1）
+  --response-check        レスポンスのステータスコードとボディを OpenAPI spec に照合する
+                            （違反は stderr に出力、exit code には影響しない）
   --verbose / -v          HTTP ステータス行を表示する
   --version               バージョンを表示する
   --help / -h             使い方を表示する
@@ -253,7 +256,7 @@ papycli <method> <resource> [options]
 
 ```python
 # my_plugin.py
-from papycli.request_filter import RequestContext
+from papycli.filters import RequestContext
 
 def request_filter(ctx: RequestContext) -> RequestContext:
     ctx.headers["X-Request-ID"] = "my-id"
@@ -285,18 +288,20 @@ my-filter = "my_plugin:request_filter"
 
 レスポンスフィルタープラグインを作成することで、受信後のレスポンスを参照・変換できます。
 
-フィルターは `ResponseContext` を受け取り、変更した `ResponseContext` を返す callable です：
+フィルターは `ResponseContext` を受け取り、変更した `ResponseContext` を返す callable です。`None` を返すとレスポンスの出力を抑制し、後続のフィルター実行を中止します：
 
 ```python
 # my_plugin.py
-from papycli.request_filter import ResponseContext
+from papycli.filters import ResponseContext
 
-def response_filter(ctx: ResponseContext) -> ResponseContext:
+def response_filter(ctx: ResponseContext) -> ResponseContext | None:
     if isinstance(ctx.body, dict):
         ctx.body["_status"] = ctx.status_code
     return ctx
 ```
 
+`None` を返すと、そのレスポンスの出力が完全に抑制され、後続フィルターへの処理も中断されます。特定の条件に合致するレスポンスを無音化したい場合に便利です。
+
 パッケージの `pyproject.toml` にエントリポイントを登録します：
 
 ```toml
@@ -316,6 +321,7 @@ my-filter = "my_plugin:response_filter"
 | `reason` | `str` | HTTP レスポンスの理由フレーズ（例：`"OK"`、`"Not Found"`）。 |
 | `headers` | `dict[str, str]` | レスポンスヘッダー。 |
 | `body` | `dict \| list \| str \| int \| float \| bool \| None` | パース済みレスポンスボディ。このフィールドを変更するとレスポンスボディを差し替えられる。 |
+| `request_body` | `dict \| list \| str \| int \| float \| bool \| None` | サーバーへ送信したリクエストボディ（参照専用）。ボディなしのリクエストは `None`。 |
 
 ---
 

{papycli-0.8.0 → papycli-0.9.0}/README.md

@@ -9,6 +9,7 @@
 - Register and switch between multiple APIs
 - Inspect API specs with `papycli spec`
 - Validate request parameters before sending with `--check` / `--check-strict`
+- Validate response body and status code against the OpenAPI spec with `--response-check`
 - Automatically coerces `-p` values to the correct JSON type (integer, number, boolean) based on the API spec
 - Log requests and responses to a file with `papycli config log`
 - Extend request processing with request filter plugins (`papycli.request_filters` entry point)
@@ -120,7 +121,7 @@ $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict  --response-check
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -129,7 +130,7 @@ $ papycli get /pet/findByStatus -q status <TAB>
   available  pending  sold
 
 $ papycli post /pet -p <TAB>
-  name  status  photoUrls
+  name*  photoUrls*  status
 
 $ papycli post /pet -p status <TAB>
   available  pending  sold
@@ -233,6 +234,8 @@ Options:
   --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)
+  --response-check        Validate response status code and body against the OpenAPI spec
+                            (warn on stderr; violations do not affect exit code)
   --verbose / -v          Show HTTP status line
   --version               Show version
   --help / -h             Show help
@@ -254,7 +257,7 @@ A filter is a callable that receives a `RequestContext` and returns a modified `
 
 ```python
 # my_plugin.py
-from papycli.request_filter import RequestContext
+from papycli.filters import RequestContext
 
 def request_filter(ctx: RequestContext) -> RequestContext:
     ctx.headers["X-Request-ID"] = "my-id"
@@ -286,18 +289,20 @@ Install the package and filters are applied automatically on every request, sort
 
 You can inspect and transform incoming responses by writing a response filter plugin.
 
-A filter is a callable that receives a `ResponseContext` and returns a modified `ResponseContext`:
+A filter is a callable that receives a `ResponseContext` and returns a modified `ResponseContext`, or `None` to suppress the response output and stop the filter chain:
 
 ```python
 # my_plugin.py
-from papycli.request_filter import ResponseContext
+from papycli.filters import ResponseContext
 
-def response_filter(ctx: ResponseContext) -> ResponseContext:
+def response_filter(ctx: ResponseContext) -> ResponseContext | None:
     if isinstance(ctx.body, dict):
         ctx.body["_status"] = ctx.status_code
     return ctx
 ```
 
+Returning `None` suppresses the response output entirely and prevents any subsequent filters from running — useful for silencing responses that match certain criteria.
+
 Register it in your package's `pyproject.toml`:
 
 ```toml
@@ -317,6 +322,7 @@ Install the package and the filters are applied automatically after every respon
 | `reason` | `str` | HTTP response reason phrase (e.g. `"OK"`, `"Not Found"`). |
 | `headers` | `dict[str, str]` | Response headers. |
 | `body` | `dict \| list \| str \| int \| float \| bool \| None` | Parsed response body. Modify this field to replace the response body. |
+| `request_body` | `dict \| list \| str \| int \| float \| bool \| None` | Request body sent to the server (read-only). `None` for requests without a body. |
 
 ---
 

{papycli-0.8.0 → papycli-0.9.0}/design_doc.md

@@ -40,7 +40,7 @@ papycli/
 │       ├── checker.py       # --check / --check-strict のパラメータ検証
 │       ├── summary.py       # summary コマンドの出力
 │       ├── completion.py    # bash / zsh 補完スクリプト生成
-│       ├── request_filter.py # リクエストフィルタープラグイン機構
+│       ├── filters.py        # リクエスト・レスポンスフィルタープラグイン機構
 │       └── i18n.py          # 日英ヘルプテキストの切り替えユーティリティ
 ├── tests/
 │   ├── test_api_call.py
@@ -50,7 +50,7 @@ papycli/
 │   ├── test_i18n.py
 │   ├── test_init_cmd.py
 │   ├── test_main.py
-│   ├── test_request_filter.py
+│   ├── test_filters.py
 │   ├── test_spec_loader.py
 │   └── test_summary.py
 ├── examples/
@@ -241,13 +241,13 @@ papycli/
 **目的**: サードパーティプラグインがリクエスト送信前に URL・クエリ・ボディ・ヘッダーを変換できる拡張ポイントを提供する。
 
 **実装内容**:
-- `request_filter.py`
+- `filters.py`
   - `RequestContext` データクラス（`method`, `url`, `query_params`, `body`, `headers`）
   - `load_filters()`: `papycli.request_filters` エントリポイントグループからフィルターをロードし、callable 検証後にプラグイン名の昇順で返す
   - `apply_filters()`: フィルターを順番に適用。各フィルター呼び出し前にスナップショットを作成し（body は deepcopy、他はシャローコピー）、例外・戻り値不正の場合は警告して前の ctx を維持する
 - `api_call.py` の `call_api()` でフィルターを適用するよう更新
   - フィルター適用後の `method` は使用しない（API 定義マッチング時に確定した元の値を使う）
-- テスト: `test_request_filter.py`
+- テスト: `test_filters.py`
   - フィルターの読み込み・適用・例外処理・戻り値型検証など
 
 **プラグイン登録例** (`pyproject.toml`):
@@ -292,6 +292,46 @@ my-filter = "my_plugin:request_filter"
 
 ---
 
+### Milestone 8 — `spec --full` とレスポンスフィルタープラグイン機構
+
+**目的**: `papycli spec --full` で生の OpenAPI spec を表示できるようにする。また response filter プラグインによりレスポンスの参照・変換を可能にする。
+
+**実装内容**:
+- `main.py` に `papycli spec --full [resource]` サブコマンドを追加
+  - 内部変換後の API 定義ではなく、元の OpenAPI spec を JSON で出力する
+  - `resource` 指定時は該当パスのみ絞り込んで表示する
+- `filters.py` にレスポンスフィルター機構を追加
+  - `ResponseContext` データクラス（`status_code`, `reason`, `body`, `headers`）
+  - `load_response_filters()`: `papycli.response_filters` エントリポイントグループからフィルターをロード
+  - `apply_response_filters()`: フィルターを順番に適用。例外・戻り値不正の場合は警告して前の ctx を維持する
+- `api_call.py` でレスポンス受信後にフィルターを適用するよう更新
+
+**完了条件**: `papycli spec --full` で生の OpenAPI spec が出力される。`papycli.response_filters` エントリポイントに登録したフィルターがレスポンス受信後に自動適用される。テストがパスする。
+
+---
+
+### Milestone 9 — `--response-check` レスポンス検証
+
+**目的**: `--response-check` オプションを追加し、実際のレスポンスを OpenAPI spec に照合して違反を警告できるようにする。
+
+**実装内容**:
+- `response_checker.py`
+  - `check_response()`: レスポンスのステータスコードとボディを spec に照合し、違反メッセージのリストを返す
+    - ステータスコード照合: exact match (`"200"`) → 範囲指定 (`"2XX"`, `"2xx"`) → `"default"` の順で探索。どれにも一致しない場合に警告する
+    - ボディスキーマ照合: `application/json` および `+json` サフィックスのメディアタイプに対して実施。型・enum・必須フィールド・additionalProperties・配列 items を再帰的に検証する
+    - スキーマ存在確認を先に行い、スキーマが定義されていない場合はボディパースをスキップする（204 等での誤警告防止）
+    - YAML 由来の整数キー（`200:` → `200`）を文字列に正規化してから照合する
+  - `_check_value()`: 値とスキーマを再帰的に照合するヘルパー
+    - union type（`type: ["object", "null"]`）・type 省略スキーマ（`properties`/`items` から推論）をサポート
+    - 不正なスキーマ形状（`properties` が非 dict 等）に対して型ガードを設けクラッシュを防止する
+- `main.py` に `--response-check` フラグを追加
+- `api_call.py` の `call_api()` で response filter 適用前に `check_response()` を呼び出す
+- テスト: `test_response_checker.py`、`test_main.py`
+
+**完了条件**: `papycli get /pet/1 --response-check` で spec と一致しないレスポンスが返された場合に stderr へ警告が出力される。ステータスコード不一致・ボディスキーマ違反ともに検出される。テストがパスする。
+
+---
+
 ## 開発上の方針
 
 ### ブランチ・コミット戦略

{papycli-0.8.0 → papycli-0.9.0}/examples/request_filter/src/papycli_debug_filter/__init__.py

@@ -13,7 +13,7 @@ from __future__ import annotations
 import json
 import sys
 
-from papycli.request_filter import RequestContext
+from papycli.filters import RequestContext
 
 
 def _to_json(value: object) -> str:

{papycli-0.8.0 → papycli-0.9.0}/examples/response_filter/README.md

@@ -71,7 +71,7 @@ The plugin is registered via the `papycli.response_filters` entry point in `pypr
 debug = "papycli_debug_response_filter:response_filter"
 ```
 
-papycli discovers all installed plugins in this group, sorts them by name, and calls each one after receiving the response. The filter receives a `ResponseContext` and must return a (possibly modified) `ResponseContext`.
+papycli discovers all installed plugins in this group, sorts them by name, and calls each one after receiving the response. The filter receives a `ResponseContext` and must return a (possibly modified) `ResponseContext`, or `None` to suppress the response output and stop the filter chain.
 
 ## Writing your own filter
 

{papycli-0.8.0 → papycli-0.9.0}/examples/response_filter/src/papycli_debug_response_filter/__init__.py

@@ -13,7 +13,7 @@ from __future__ import annotations
 import json
 import sys
 
-from papycli.request_filter import ResponseContext
+from papycli.filters import ResponseContext
 
 
 def _to_json(value: object) -> str:

{papycli-0.8.0 → papycli-0.9.0}/pyproject.toml

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

{papycli-0.8.0 → papycli-0.9.0}/src/papycli/api_call.py

@@ -10,7 +10,7 @@ from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    from papycli.request_filter import RequestContext
+    from papycli.filters import RequestContext
 
 import requests
 
@@ -313,9 +313,13 @@ def call_api(
     logfile: str | None = None,
     raw_spec: dict[str, Any] | None = None,
     do_response_check: bool = False,
-) -> requests.Response:
-    """API を呼び出し、レスポンスを返す。"""
-    from papycli.request_filter import (
+) -> requests.Response | None:
+    """API を呼び出し、レスポンスを返す。
+
+    レスポンスフィルターが ``None`` を返してチェーンを中断した場合は ``None`` を返す。
+    呼び出し元はこの戻り値をレスポンスの出力を抑制するシグナルとして扱う。
+    """
+    from papycli.filters import (
         RequestContext,
         ResponseContext,
         apply_filters,
@@ -429,8 +433,12 @@ def call_api(
             reason=resp.reason or "",
             headers=dict(resp.headers),
             body=resp_body,
+            request_body=ctx.body,
         )
         resp_ctx = apply_response_filters(resp_ctx, response_filters)
+        if resp_ctx is None:
+            # フィルターが None を返してチェーンを中断した。出力を抑制するため None を返す。
+            return None
 
         # フィルターがフィールドを変更した場合、resp に反映する。
         # ボディ: 値の等価比較で変更を検出し、_content・encoding・Content-Type を更新する。

{papycli-0.8.0 → papycli-0.9.0}/src/papycli/completion.py

@@ -87,8 +87,9 @@ def _used_param_names(words: list[str], flag: str) -> set[str]:
         if words[i] == flag and i + 1 < len(words):
             name = words[i + 1]
             # NAME が別のオプションフラグでも空文字でもない場合のみ使用済みとして扱う
+            # 補完で選択された場合に末尾に * が付いていることがあるため取り除いてから登録する
             if name and not name.startswith("-"):
-                used.add(name)
+                used.add(name.removesuffix("*"))
             # flag と NAME までは確実に読み飛ばすが、VALUE は仮定しない
             i += 2
         else:
@@ -108,11 +109,21 @@ def _complete_param_names(
     if op is None:
         return []
     key = "query_parameters" if kind == "query" else "post_parameters"
-    return [
-        p["name"]
-        for p in op.get(key, [])
-        if p["name"].startswith(incomplete) and (used is None or p["name"] not in used)
-    ]
+    # incomplete の末尾 * を取り除いてからパラメータ名と比較する
+    incomplete_stripped = incomplete.removesuffix("*")
+    required: list[str] = []
+    optional: list[str] = []
+    for p in op.get(key, []):
+        name = p["name"]
+        if not name.startswith(incomplete_stripped):
+            continue
+        if used is not None and name in used:
+            continue
+        if p.get("required", False):
+            required.append(name + "*")
+        else:
+            optional.append(name)
+    return required + optional
 
 
 def _complete_enum_values(
@@ -127,8 +138,10 @@ def _complete_enum_values(
     if op is None:
         return []
     key = "query_parameters" if kind == "query" else "post_parameters"
+    # 補完で選択された場合、param_name の末尾に * が付いていることがあるため取り除く
+    normalized_name = param_name.removesuffix("*")
     for p in op.get(key, []):
-        if p["name"] == param_name and "enum" in p:
+        if p["name"] == normalized_name and "enum" in p:
             return [str(v) for v in p["enum"] if str(v).startswith(incomplete)]
     return []