Stubs for ttkthemes (#6024)

stubs/ttkthemes/METADATA.toml

@@ -0,0 +1 @@
+version = "3.2"

stubs/ttkthemes/ttkthemes/__init__.pyi

@@ -0,0 +1,7 @@
+from collections.abc import Sequence
+
+from ttkthemes.themed_style import ThemedStyle as ThemedStyle
+from ttkthemes.themed_tk import ThemedTk as ThemedTk
+
+# actually a list, but shouldn't be modified
+THEMES: Sequence[str]

stubs/ttkthemes/ttkthemes/_imgops.pyi

@@ -0,0 +1,2 @@
+def shift_hue(image, hue): ...
+def make_transparent(image): ...

stubs/ttkthemes/ttkthemes/_utils.pyi

@@ -0,0 +1,7 @@
+from typing import Any
+
+def temporary_chdir(new_dir) -> None: ...
+def get_file_directory(): ...
+def get_temp_directory(): ...
+def get_themes_directory(theme_name: Any | None = ..., png: bool = ...): ...
+def create_directory(directory): ...

stubs/ttkthemes/ttkthemes/_widget.pyi

@@ -0,0 +1,26 @@
+import _tkinter
+from _typeshed import StrPath
+from typing import ClassVar
+
+class ThemedWidget:
+    pixmap_themes: ClassVar[list[str]]
+    PACKAGES: ClassVar[dict[str, str]]
+    tk: _tkinter.TkappType
+    png_support: bool
+    def __init__(self, tk_interpreter, gif_override: bool = ...) -> None: ...
+    def set_theme(self, theme_name: str) -> None: ...
+    def get_themes(self) -> list[str]: ...
+    @property
+    def themes(self) -> list[str]: ...
+    @property
+    def current_theme(self) -> str: ...
+    def set_theme_advanced(
+        self,
+        theme_name: str,
+        brightness: float = ...,
+        saturation: float = ...,
+        hue: float = ...,
+        preserve_transparency: bool = ...,
+        output_dir: StrPath | None = ...,
+        advanced_name: str = ...,
+    ) -> None: ...

stubs/ttkthemes/ttkthemes/themed_style.pyi

@@ -0,0 +1,12 @@
+import tkinter
+from tkinter import ttk
+
+from ._widget import ThemedWidget
+
+class ThemedStyle(ttk.Style, ThemedWidget):
+    def __init__(
+        self, master: tkinter.Misc | None, *, theme: str | None = ..., gif_override: bool | None = ..., **kwargs
+    ) -> None: ...
+    # theme_use() can't return None (differs from ttk.Style)
+    def theme_use(self, theme_name: str | None = ...) -> str: ...  # type: ignore
+    def theme_names(self) -> list[str]: ...  # type: ignore

stubs/ttkthemes/ttkthemes/themed_tk.pyi

@@ -0,0 +1,30 @@
+import tkinter
+from typing import Any
+
+from ._widget import ThemedWidget
+
+class ThemedTk(tkinter.Tk, ThemedWidget):
+    def __init__(
+        self,
+        # non-keyword-only args copied from tkinter.Tk
+        screenName: str | None = ...,
+        baseName: str | None = ...,
+        className: str = ...,
+        useTk: bool = ...,
+        sync: bool = ...,
+        use: str | None = ...,
+        *,
+        theme: str | None = ...,
+        # fonts argument does nothing
+        toplevel: bool | None = ...,
+        themebg: bool | None = ...,
+        background: bool | None = ...,  # old alias for themebg
+        gif_override: bool = ...,
+    ) -> None: ...
+    def set_theme(self, theme_name, toplevel: bool | None = ..., themebg: bool | None = ...) -> None: ...
+    # TODO: currently no good way to say "use the same big list of kwargs as parent class but also add these"
+    def config(self, kw: Any | None = ..., **kwargs): ...  # type: ignore
+    def cget(self, k): ...
+    def configure(self, kw: Any | None = ..., **kwargs): ...  # type: ignore
+    def __getitem__(self, k): ...
+    def __setitem__(self, k, v): ...