Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

`tkinter.ttk.Progressbar` stubs are outdated for Tk 9.0

オープン 初心者向け
  • 何か問題がありますか？
#16,612 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
75/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
python
領域
developer-experience

調査の方向性

stdlib/tkinter/ttk.pyi の 803-836 行付近で、明示的な Progressbar.__init__ シグネチャがある場所から始めてください。Issue でリンクされている Tk 9.0 ttk_progressbar マニュアルページと比較し、新しいテキストオプション (text, anchor, font, foreground, justify, wraplength) のためのキーワード専用パラメータを追加し、Tk 9.0 が削除したオプションを削除してください。隣接する stubs が Tk 固有のオプションをバージョンでゲートしている方法を確認してください。sys.version_info はリンクされた Tk バージョンを反映しない可能性があるためです。終わったらファイルに対して typeshed check script を実行してください。

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

説明

NOTE: The detail of the issue is raised and verified by human, but these text are drafted with the assistance of AI, since my English is poor.

Description

Tk 9.0 added native text display support to ttk::progressbar, but the current
typeshed stub for tkinter.ttk.Progressbar does not reflect the Tk 9.0 option
set.

According to the Tk 9.0 ttk_progressbar manual page:
https://www.tcl-lang.org/man/tcl9.0/TkCmd/ttk_progressbar.html

Tk 9.0 ttk::progressbar supports text-related options such as:

  • -anchor
  • -font
  • -foreground
  • -justify
  • -text
  • -wraplength

These options did not exist in Tk 8.6 and earlier. Tk 9.0 also removes support
for some options that were accepted by earlier versions, so the stub currently
does not match either the new or the removed parts of the Tk 9.0 option set.

The relevant typeshed file is:
https://github.com/python/typeshed/blob/main/stdlib/tkinter/ttk.pyi#L803-L836

Example

With Python 3.14.9 and Tk 9.0.4, the following is valid:

from tkinter import ttk

bar = ttk.Progressbar(
    text="Loading",
    anchor="center",
    font=("TkDefaultFont", 10),
) # make a progressbar with a text of "Loading" packed in the center of widget

bar.configure(text="Done")

However, the explicit Progressbar.__init__ signature in typeshed does not
include text, anchor, font, foreground, justify, or wraplength.
Depending on the current fallback signature, this may be accepted through
**kw: Any, but the options are still not modeled explicitly, so IDE
completion and typed usage are outdated. If some options are no longer valid
in Tk 9.0, the stub may also continue to advertise options that now fail at
runtime.

Requested change

Please update tkinter.ttk.Progressbar to match the Tk 9.0 option set, at
least by adding explicit keyword-only parameters for the new text-related
options to Progressbar.__init__ and, where appropriate, to
configure/config.

One open question is version gating: tkinter can be built against different
Tk versions, so keying this only on sys.version_info may not always be
correct. (See P.S. below)

Additional context

I searched the existing typeshed issues and did not find a dedicated report for
ttk.Progressbar being out of date with Tk 9.0. This seems to be a gap in the
current stubs.

P.S. : AI also generates texts as shown below, but I can't verify the detail, since I didn't find any description of major version update on bundled tcl/tk in What’s new in Python 3.14:

https://docs.python.org/3.14/whatsnew/3.14.html#tkinter

Since Python 3.14, the official binary installers have begun shipping Tcl/Tk 9.0 (e.g. the macOS installer uses Tcl/Tk 9.0.3 as of Python 3.14.5, and Windows installers also bundle Tcl/Tk 9.0). This means the Tk 9.0 Progressbar options are now relevant to users of official CPython builds, not just those who manually build against Tk 9.
主要言語
Python
スター
5.1k
フォーク
2.1k
平均マージ
1日 14時間
マージ済み PR（30日）
78

環境構築

はじめの一歩

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

python/typeshed のほかの issue

python/typeshed の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。