Moving Event() to python - bugfix 5.

Author: gresm

README.rst

@@ -165,6 +165,7 @@ If you have any questions, please feel free to ask in the `Pygame Community Disc
 
 License
 -------
+**License Identifier:** LGPL-2.1-or-later
 
 This library is distributed under `GNU LGPL version 2.1`_, which can
 be found in the file ``docs/LGPL.txt``.  We reserve the right to place

buildconfig/stubs/pygame/_common.pyi

@@ -1,8 +1,5 @@
 from os import PathLike
-from typing import IO, Callable, Tuple, Union, TypeVar, Dict, Any, Optional
-
-from typing_extensions import Literal as Literal, SupportsIndex as SupportsIndex
-from typing_extensions import Protocol
+from typing import IO, Callable, Tuple, Union, TypeVar, Dict, Any, Optional, Protocol, SupportsIndex
 
 # For functions that take a file name
 AnyPath = Union[str, bytes, PathLike[str], PathLike[bytes]]

buildconfig/stubs/pygame/color.pyi

@@ -1,7 +1,8 @@
 import sys
-from typing import Any, Dict, Iterator, Tuple, Union, overload
+from typing import Any, Dict, Iterator, SupportsIndex, Tuple, Union, overload
+from typing_extensions import deprecated # added in 3.13
 
-from ._common import ColorValue, SupportsIndex
+from ._common import ColorValue
 
 if sys.version_info >= (3, 9):
     from collections.abc import Collection
@@ -79,6 +80,7 @@ class Color(Collection[int]):
     def from_normalized(cls, r: float, g: float, b: float, a: float, /) -> Color: ...
     def normalize(self) -> Tuple[float, float, float, float]: ...
     def correct_gamma(self, gamma: float, /) -> Color: ...
+    @deprecated("since 2.1.3. Use unpacking instead")
     def set_length(self, length: int, /) -> None: ...
     def lerp(self, color: ColorValue, amount: float) -> Color: ...
     def premul_alpha(self) -> Color: ...

buildconfig/stubs/pygame/cursors.pyi

@@ -1,8 +1,8 @@
-from typing import Any, Iterator, Tuple, Union, overload
+from typing import Any, Iterator, Literal, Tuple, Union, overload
 
 from pygame.surface import Surface
 
-from ._common import FileArg, Literal, IntCoordinate, Sequence
+from ._common import FileArg, IntCoordinate, Sequence
 
 _Small_string = Tuple[
     str, str, str, str, str, str, str, str, str, str, str, str, str, str, str, str

buildconfig/stubs/pygame/display.pyi

@@ -1,4 +1,5 @@
 from typing import Dict, List, Optional, Tuple, Union, overload, Literal
+from typing_extensions import deprecated # added in 3.13
 
 from pygame.constants import FULLSCREEN
 from pygame.surface import Surface
@@ -72,7 +73,9 @@ def gl_set_attribute(flag: int, value: int, /) -> None: ...
 def get_active() -> bool: ...
 def iconify() -> bool: ...
 def toggle_fullscreen() -> int: ...
+@deprecated("since 2.1.4. Removed in SDL3")
 def set_gamma(red: float, green: float = ..., blue: float = ..., /) -> int: ...
+@deprecated("since 2.1.4. Removed in SDL3")
 def set_gamma_ramp(
     red: Sequence[int], green: Sequence[int], blue: Sequence[int], /
 ) -> int: ...

buildconfig/stubs/pygame/font.pyi

@@ -1,8 +1,8 @@
-from typing import Callable, Hashable, Iterable, List, Optional, Tuple, Union
+from typing import Callable, Hashable, Iterable, List, Literal, Optional, Tuple, Union
 
 from pygame.surface import Surface
 
-from ._common import ColorValue, FileArg, Literal
+from ._common import ColorValue, FileArg
 
 # TODO: Figure out a way to type this attribute such that mypy knows it's not
 # always defined at runtime

buildconfig/stubs/pygame/freetype.pyi

@@ -1,4 +1,5 @@
 from typing import Any, Callable, Iterable, List, Optional, Tuple, Union
+from typing_extensions import deprecated # added in 3.13
 
 from pygame.color import Color
 from pygame.rect import Rect
@@ -11,6 +12,7 @@ def get_version(linked: bool = True) -> Tuple[int, int, int]: ...
 def init(cache_size: int = 64, resolution: int = 72) -> None: ...
 def quit() -> None: ...
 def get_init() -> bool: ...
+@deprecated("Use `pygame.freetype.get_init` instead")
 def was_init() -> bool: ...
 def get_cache_size() -> int: ...
 def get_default_resolution() -> int: ...

buildconfig/stubs/pygame/image.pyi

@@ -1,47 +1,48 @@
-from typing import Optional, Tuple, Union
+from typing import Literal, Optional, Tuple, Union
+from typing_extensions import deprecated # added in 3.13
 
 from pygame.bufferproxy import BufferProxy
 from pygame.surface import Surface
 
-from ._common import FileArg, Literal, IntCoordinate, Coordinate
+from ._common import FileArg, IntCoordinate, Coordinate
 
 _BufferStyle = Union[BufferProxy, bytes, bytearray, memoryview]
-_to_string_format = Literal[
+_to_bytes_format = Literal[
     "P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA", "ABGR", "RGBA_PREMULT", "ARGB_PREMULT"
 ]
 _from_buffer_format = Literal["P", "RGB", "BGR", "BGRA", "RGBX", "RGBA", "ARGB"]
-_from_string_format = Literal["P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA", "ABGR"]
+_from_bytes_format = Literal["P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA", "ABGR"]
 
 def load(file: FileArg, namehint: str = "") -> Surface: ...
 def load_sized_svg(file: FileArg, size: Coordinate) -> Surface: ...
 def save(surface: Surface, file: FileArg, namehint: str = "") -> None: ...
 def get_sdl_image_version(linked: bool = True) -> Optional[Tuple[int, int, int]]: ...
 def get_extended() -> bool: ...
+@deprecated("since 2.3.0. Use `pygame.image.tobytes` instead")
 def tostring(
     surface: Surface,
-    format: _to_string_format,
+    format: _to_bytes_format,
     flipped: bool = False,
     pitch: int = -1,
 ) -> bytes: ...
+@deprecated("since 2.3.0. Use `pygame.image.frombytes` instead")
 def fromstring(
     bytes: bytes,
     size: IntCoordinate,
-    format: _from_string_format,
+    format: _from_bytes_format,
     flipped: bool = False,
     pitch: int = -1,
 ) -> Surface: ...
-
-# the use of tobytes/frombytes is preferred over tostring/fromstring
 def tobytes(
     surface: Surface,
-    format: _to_string_format,
+    format: _to_bytes_format,
     flipped: bool = False,
     pitch: int = -1,
 ) -> bytes: ...
 def frombytes(
     bytes: bytes,
     size: IntCoordinate,
-    format: _from_string_format,
+    format: _from_bytes_format,
     flipped: bool = False,
     pitch: int = -1,
 ) -> Surface: ...

buildconfig/stubs/pygame/joystick.pyi

@@ -1,4 +1,5 @@
 from typing import Tuple, final
+from typing_extensions import deprecated # added in 3.13
 
 def init() -> None: ...
 def quit() -> None: ...
@@ -7,9 +8,11 @@ def get_count() -> int: ...
 @final
 class JoystickType:
     def __init__(self, id: int) -> None: ...
+    @deprecated("since 2.0.0. Multiple initializations are not supported anymore")
     def init(self) -> None: ...
     def quit(self) -> None: ...
     def get_init(self) -> bool: ...
+    @deprecated("since 2.0.0. Use `pygame.Joystick.get_instance_id` instead")
     def get_id(self) -> int: ...
     def get_instance_id(self) -> int: ...
     def get_guid(self) -> str: ...

buildconfig/stubs/pygame/math.pyi

@@ -5,6 +5,7 @@ from typing import (
     Iterator,
     List,
     Literal,
+    SupportsIndex,
     Tuple,
     Type,
     TypeVar,
@@ -13,13 +14,14 @@ from typing import (
     overload,
     Optional
 )
+from typing_extensions import deprecated # added in 3.13
 
 if sys.version_info >= (3, 9):
     from collections.abc import Collection
 else:
     from typing import Collection
 
-from ._common import SupportsIndex, Sequence
+from ._common import Sequence
 
 def clamp(value: float, min: float, max: float, /) -> float: ...
 
@@ -231,6 +233,7 @@ class Vector2(_GenericVector):
     def rotate_rad(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_ip(self, angle: float, /) -> None: ...
     def rotate_rad_ip(self, angle: float, /) -> None: ...
+    @deprecated("since 2.1.1. Use `pygame.Vector2.rotate_rad_ip` instead")
     def rotate_ip_rad(self, angle: float, /) -> None: ...
     def cross(self: _TVec, other: Union[Sequence[float], _TVec], /) -> float: ...
     def as_polar(self) -> Tuple[float, float]: ...
@@ -304,23 +307,27 @@ class Vector3(_GenericVector):
     def rotate_rad_ip(
         self: _TVec, angle: float, axis: Union[Sequence[float], _TVec], /
     ) -> None: ...
+    @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_rad_ip` instead")
     def rotate_ip_rad(
         self: _TVec, angle: float, axis: Union[Sequence[float], _TVec], /
     ) -> None: ...
     def rotate_x(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_x_rad(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_x_ip(self, angle: float, /) -> None: ...
     def rotate_x_rad_ip(self, angle: float, /) -> None: ...
+    @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_x_rad_ip` instead")
     def rotate_x_ip_rad(self, angle: float, /) -> None: ...
     def rotate_y(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_y_rad(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_y_ip(self, angle: float, /) -> None: ...
     def rotate_y_rad_ip(self, angle: float, /) -> None: ...
+    @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_y_rad_ip` instead")
     def rotate_y_ip_rad(self, angle: float, /) -> None: ...
     def rotate_z(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_z_rad(self: _TVec, angle: float, /) -> _TVec: ...
     def rotate_z_ip(self, angle: float, /) -> None: ...
     def rotate_z_rad_ip(self, angle: float, /) -> None: ...
+    @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_z_rad_ip` instead")
     def rotate_z_ip_rad(self, angle: float, /) -> None: ...
     def as_spherical(self) -> Tuple[float, float, float]: ...
     def from_spherical(self, spherical: Tuple[float, float, float], /) -> None: ...
@@ -338,7 +345,7 @@ def invlerp(a: float, b: float, value: float, /) -> float: ...
 def remap(i_min: float, i_max: float, o_min: float, o_max: float, value: float, /) -> float: ...
 def smoothstep(a: float, b: float, weight: float, /) -> float: ...
 
-
-# typehints for deprecated functions, to be removed in a future version
+@deprecated("Functionality is removed")
 def enable_swizzling() -> None: ...
+@deprecated("Functionality is removed")
 def disable_swizzling() -> None: ...