$ref in path parameters doesn't seem to work

オープン

#605 2022年4月30日に作成コメント 0 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 3/5
見積もり時間: 1〜2日
初心者へのやさしさ: 48/100

issue の種類: バグ
明瞭さ: おおむね明確
活発さ: 停滞
技術スタック: openapi, python
領域: api

調査の方向性

再現可能な openapi-ref-issue リポジトリにリンクされている test-schema.yaml から始め、報告されている openapi-python-client のバージョンを使ってジェネレーターを実行します。生成された sync エントリポイントを noref の例と比較し、パラメーター $ref の解決に注目します。参照されたパラメーターの場合にも、生成された API にオプションの page kwarg が含まれていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

🐞bug

Describe the bug
If a get path has a parameter using $ref to point to #/components/parameters, the generated API lacks the corresponding kwarg. If one "hoists" the indirect parameter up into the path's parameters, it works as expected.

To Reproduce
See this repo for a reproducible example.
And see this repo for the same schema without the $ref, working as expected.

Expected behavior
I expect to see the optional page kwarg in both generated APIs.

I see this in the $ref example:

def sync(
    *,
    client: Client,
) -> Optional[List[str]]:

and this in the noref example:

def sync(
    *,
    client: Client,
    page: Union[Unset, None, GetTestPage] = UNSET,
) -> Optional[List[str]]:

OpenAPI Spec File
A link to your openapi.json which produces this issue.

Desktop (please complete the following information):

OS: Microsoft Windows 10 Pro 10.0.19044 Build 19044
Python Version: 3.9.12
openapi-python-client version 0.11.1

主要言語: Python
スター: 2k
フォーク: 293
平均マージ: 34分
マージ済み PR（30日）: 1

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

openapi-generators/openapi-python-client のほかの issue

typing_extensions should be declared as dependency オープン

難易度 2/5 1〜3時間初心者へのやさしさ 68/100

openapi-generators/openapi-python-client#1481 · 2026年8月20日に作成
Skip setting 'Content-Type' on file upload, when multiple bodies are supported オープン

難易度 2/5 1〜3時間初心者へのやさしさ 65/100

openapi-generators/openapi-python-client#947 · 2024年1月23日に作成
Multi-body endpoints with required requestBody emit `| Unset` without importing `Unset` オープン

難易度 3/5 1〜2日初心者へのやさしさ 72/100

openapi-generators/openapi-python-client#1451 · コメント 1 件 · 2026年6月18日に作成
_build_response crashes with ValueError on non-IANA HTTP status codes (520, 561, etc.) オープン

難易度 3/5 1〜2日初心者へのやさしさ 52/100

openapi-generators/openapi-python-client#1442 · 2026年5月29日に作成
Generator fails on type: array without items even though it's valid in JSON Schema 2020-12 / OpenAPI 3.1 オープン

難易度 3/5 1〜2日初心者へのやさしさ 64/100

openapi-generators/openapi-python-client#1435 · コメント 1 件 · 2026年5月15日に作成

openapi-generators/openapi-python-client の issue をすべて見る

似ている issue

slack-gif-creator: validate_gif() multiplies the last frame's duration by the frame count, so reported duration/fps are wrong (1.0s GIF reported as 1.8s) オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

anthropics/skills#1811 · コメント 1 件 · 2026年9月23日に作成
App fails to start with gradio 6 (allowed by `gradio>=5.49.1`) オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

speaches-ai/speaches#678 · 2026年9月23日に作成
ModuleNotFoundError: No module named 'mcp.server.fastmcp'. オープン

bug

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

datalayer/mcp-compose#42 · 2026年9月23日に作成
import spacy fails with ModuleNotFoundError: No module named 'click' オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

conda-forge/spacy-feedstock#177 · 2026年9月23日に作成
humaneval: extract_function_body corrupts a fenced body-only reply, so the same correct code scores INCORRECT fenced and CORRECT unfenced オープン

難易度 2/5 1〜3時間初心者へのやさしさ 70/100

UKGovernmentBEIS/inspect_evals#2523 · 2026年9月23日に作成

Python の issue をもっと見る