Avoid relying on `typing.TYPE_CHECKING` to the maximum possible extent

オープン

#468 2025年2月24日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

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

評価

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

issue の種類: リファクタリング
明瞭さ: 説明が足りない
活発さ: 静か
技術スタック: python
領域: developer-experience, documentation

調査の方向性

まず、#454 に関係する TYPE_CHECKING の使用箇所と、関連する Sphinx の issue を確認し、不要な import や循環 import を防いでいる guard を特定します。これらの import が Sphinx のレンダリングとデバッグにどのような影響を与えるかを確認します。不要な TYPE_CHECKING guard が削除され、import の安全性に必要な guard が残っていれば完了です。

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

説明

cuda.core documentation enhancement P1

During investigation of #454 and related doc rendering issues, it has come to my attention that the type checking detection logic does not work well with Sphinx (ex: https://github.com/sphinx-doc/sphinx/issues/13137, https://github.com/sphinx-doc/sphinx/issues/11225).

Independently, Ralf has pointed out that it makes code debugging harder (https://github.com/NVIDIA/cuda-python/pull/463#discussion_r1967029167).

The idea of having a if TYPE_CHECKING: check is to avoid unnecessary imports or circular imports. If such issues do not exist, we should avoid using it.

主要言語: Cython
スター: 3.4k
フォーク: 329
平均マージ: 1日 21時間
マージ済み PR（30日）: 113

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

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

はじめの一歩

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

NVIDIA/cuda-python のほかの issue

cuda.core: VirtualMemoryResource.deallocate() unmaps without ordering on the stream オープン

bug cuda.core

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

NVIDIA/cuda-python#2886 · コメント 1 件 · 2026年9月16日に作成
[DOC]: cuda.core 1.1.1 note misstates program cache permissions オープン

triage

難易度 1/5 1時間未満初心者へのやさしさ 88/100

NVIDIA/cuda-python#2717 · 2026年8月27日に作成
[DOC]: `PinnedMemoryResource.allocate` documents no parameters オープン

triage

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

NVIDIA/cuda-python#2712 · 2026年8月27日に作成
[BUG]: LocatedHeaderDir is mutable, so callers can poison the cached header-directory lookup オープン

triage

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

NVIDIA/cuda-python#2646 · リアクション 1 件 · 2026年8月16日に作成
[FEA]: Support inheritance from Buffer オープン

cuda.core triage

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

NVIDIA/cuda-python#2435 · コメント 1 件 · 2026年7月28日に作成

NVIDIA/cuda-python の issue をすべて見る

似ている issue

Antigravity CLI: PostToolUse hook misidentified as PreToolUse due to `toolCall` check, causing protojson error オープン

bug

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

newrelic-experimental/preflight#793 · コメント 1 件 · 2026年9月21日に作成
[feature] OnlyBigBottleTurbo 检查大小瓶数量问题オープン

enhancement

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

babalae/bettergi-scripts-list#3674 · 2026年9月21日に作成
caddy fmt deletes an opening brace at the end of the input オープン

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

caddyserver/caddy#8046 · 2026年9月21日に作成
Windows: hooks treat CLAUDE_PROJECT_DIR (C:/... style) as relative, session summaries written to a doubled path オープン

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

zilliztech/memsearch#759 · 2026年9月21日に作成
[Bug]: classify_items.py cron script never includes its own required JSON schema in the prompt オープン

comp/cron P2 sweeper:risk-automation type/bug

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

NousResearch/hermes-agent#117792 · コメント 1 件 · 2026年9月21日に作成

DevTools の issue をもっと見る