pyglet 2.1.dev2__tar.gz → 2.1.dev4__tar.gz

{pyglet-2.1.dev2 → pyglet-2.1.dev4}/.github/workflows/unittests.yml

@@ -28,7 +28,7 @@ jobs:
     runs-on: macos-latest
     strategy:
       matrix:
-        python-version: [ '3.8', '3.9', '3.10', '3.11', '3.12' ]
+        python-version: [ '3.10', '3.11', '3.12' ]
     name: Python ${{ matrix.python-version }} OSX
     steps:
       - uses: actions/checkout@v4

{pyglet-2.1.dev2 → pyglet-2.1.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyglet
-Version: 2.1.dev2
+Version: 2.1.dev4
 Summary: pyglet is a cross-platform games and multimedia package.
 Author-email: Alex Holkner & contributors <Alex.Holkner@gmail.com>
 Requires-Python: >=3.8
@@ -128,10 +128,14 @@ code, is a bug that deserves to be reported on a ticket.
 
 ## Building Docs
 
+[Documentation and Type Hints]: https://pyglet.readthedocs.io/en/latest/internal/doc.html
+
+To get started quickly:
+
     pip install -r doc/requirements.txt
-    python setup.py build_sphinx
+    python make.py docs
 
-Please check [the README.md file in the doc directory](doc/README.md) for more details.
+Please check [Documentation and Type Hints][] guide to learn more.
 
 ## Testing
 

{pyglet-2.1.dev2 → pyglet-2.1.dev4}/README.md

@@ -119,10 +119,14 @@ code, is a bug that deserves to be reported on a ticket.
 
 ## Building Docs
 
+[Documentation and Type Hints]: https://pyglet.readthedocs.io/en/latest/internal/doc.html
+
+To get started quickly:
+
     pip install -r doc/requirements.txt
-    python setup.py build_sphinx
+    python make.py docs
 
-Please check [the README.md file in the doc directory](doc/README.md) for more details.
+Please check [Documentation and Type Hints][] guide to learn more.
 
 ## Testing
 

{pyglet-2.1.dev2 → pyglet-2.1.dev4}/RELEASE_NOTES

@@ -1,3 +1,40 @@
+pyglet 2.0.16
+
+Changes and Improvements
+------------------------
+- library-wide overhaul of docstrings, and addition of type hints. (#1084)
+- sprite: Add `blend_mode` property to change BLEND_MODE without needing to re-create the Sprite.
+- sprite: Deprecate `AdvancedSprite`, and merge functionality into default `Sprite` class.
+- sprite: Add `get_sprite_group` method, allowing easy usage of custom SpriteGroups in subclasses.
+- image: Code for `Texture.blit` has been inlined. (#1109)
+- shapes: Concave polygon can be drawn by earcutting a polygon. (#1121)
+- shapes: Add Rounded Rectangle shape. (#1131)
+- shapes: Add `thickness` property to `Box` shapes.
+- libs: Add `pyglet.libs.ioctl` module, to consolidate shared code on Linux.
+- gui: Add a pseudo "nine-path" Sprite-like class for variable sized windows.
+- math: Add `match` statement support to Vec classes.
+- graphics: Don't re-create a Shader each call to `draw` or `draw_indexed`.
+- pyglet.options: Add runtime typing enforcement to user-set options.
+- pyglet.experimental: Add simple GPU-based particle system in `particles` module.
+- text.layout: Update `on_style_text` to be more efficient.
+
+Bugfixes
+--------
+- window.macos: Fix constant appearance of blinking caret on M1 based Macs. (#1160)
+- window.xlib: Avoid XSet/UnsetICFocus calls when _have_utf8 is False. (#1049)
+- window.win32: Fix application not updating timers and redrawing during moves. (#1125)
+- shapes: Add missing `thickness` property to Box.
+- shapes: Add missing docstrings to `Arc` `thickness` property.
+- shapes: Fix ShapeBase.group setter to only migrate batch when batch is not None. (#1090)
+- shapes: BezierCurve: fix miter artifacts from #1134. (#1155)
+- examples: Fix "more" button outline in soundspace example. (#1085)
+- tests: Fix a rarely-failing audio time test. (#1092)
+- input.controller: Fix accidentially missed mappings.
+- graphics.shader: Add missing parent program reference in Uniforms (#1103)
+- graphics.domain: Fix VertexList.resize method.
+- text.directwrite: Fix crash with dw_legacy_naming. Check if a custom collection exists before find a font with it.
+
+
 pyglet 2.0.15
 
 Changes and Improvements
@@ -911,7 +948,7 @@ New features
 Improvements
 ------------
 - Improved font rendering for fonts with negative bearing (#99)
-- Sprites now have `scale_x` and `scale_y` attributes, allowing for aspect ratio changes. The 
+- Sprites now have `scale_x` and `scale_y` attributes, allowing for aspect ratio changes. The
   existing `scale` attribute sets the overall scaling, and functions as before.
 - Sprites have a new `update` method which allows simultaneous changing of position, scale, and
   rotation. This reduces some overhead when changing multiple attributes at once.
@@ -941,16 +978,16 @@ Bugfixes
 
 
 pyglet 1.2.3
-============                                                                                        
-Minor bugfix release.                                                                               
-                                                                                                    
-Bugfixes:                                                                                           
-- Windows: Fix issue where ALT key causes app to hang.                                              
-- Media: Many fixes to PulseAudio and OpenAL media drivers (a.o. #26, #27).                         
-- OSX: Fix stealing the menu when already present in cocoa.                                         
-- Fix multi texturing support (#28).                                                                
-- OSX: Prevent segfault with multiple runs (#37/GC728)                                              
-- ArchLinux: Fix segmentation fault when using gdk_pixbuf (#25) 
+============
+Minor bugfix release.
+
+Bugfixes:
+- Windows: Fix issue where ALT key causes app to hang.
+- Media: Many fixes to PulseAudio and OpenAL media drivers (a.o. #26, #27).
+- OSX: Fix stealing the menu when already present in cocoa.
+- Fix multi texturing support (#28).
+- OSX: Prevent segfault with multiple runs (#37/GC728)
+- ArchLinux: Fix segmentation fault when using gdk_pixbuf (#25)
 
 
 pyglet 1.2.2

{pyglet-2.1.dev2 → pyglet-2.1.dev4}/contrib/qt_sprite_preview.py

@@ -52,15 +52,15 @@ both frag and vertex (IE: test becomes test.vert and test.frag)
 
 Scrolling the mousewheel also zooms in.
 """
+from __future__ import annotations
 
+import argparse
 import os
 import sys
 import traceback
-import argparse
 from pathlib import Path
-
 from textwrap import dedent
-from typing import TYPE_CHECKING, Final, Dict, List, Optional, Tuple, Mapping
+from typing import TYPE_CHECKING, Final, Mapping
 
 # Constants for choosing a Qt backend and summarizing their licensing
 ENV_VARIABLE: Final[str] = 'PYGLET_QT_BACKEND'
@@ -68,9 +68,9 @@ ENV_VARIABLE: Final[str] = 'PYGLET_QT_BACKEND'
 PYSIDE2: Final[str] = 'PySide2'
 PYQT5: Final[str] = 'PyQt5'
 
-valid_backends: Final[Dict[str, str]] = {
+valid_backends: Final[dict[str, str]] = {
     PYSIDE2: "LGPL; may allow releasing under non-GPL licenses",
-    PYQT5: "Dual GPL / Commercial license; requires GPL or a fee"
+    PYQT5: "Dual GPL / Commercial license; requires GPL or a fee",
 }
 
 # Default to PySide2 as part of allowing non-GPL licenses
@@ -80,34 +80,34 @@ DEFAULT: Final[str] = PYSIDE2
 
 # Argument parser for run-time config as __main__
 parser = argparse.ArgumentParser(
-    description=dedent('''\
+    description=dedent("""\
     A sprite & shader previewer using Qt and pyglet together.
 
     It defaults to PySide2, but can run on PyQt5. The details of how may
     be helpful to users who want to avoid spreading PyQt5's GPL license
     while using it as a fallback. See the docstrings and comments in the
     source to learn more.
-    '''),
+    """),
     formatter_class=argparse.RawTextHelpFormatter)
 
 # On Python 3.9+, argparse.BooleanOptionalAction is more concise
 # See https://docs.python.org/3.9/library/argparse.html#action
 parser.add_argument(
     '--use-qt-file-dialog', dest='native_file_dialog', action='store_false',
-    help="Use Qt's file chooser instead of the system's. Helpful on Gnome DE."
+    help="Use Qt's file chooser instead of the system's. Helpful on Gnome DE.",
 )
 parser.set_defaults(native_file_dialog=True)
 
 
 # Generate options help text lines
 backend_column_width: Final[int] = max(map(len, valid_backends))
-help_lines: List[str] = ["Which Qt binding to use.\n"]
+help_lines: list[str] = ["Which Qt binding to use.\n"]
 
 for backend, description in valid_backends.items():
    line_parts = [
        f"{backend: <{backend_column_width}} - ",
        '(Default) ' if backend == DEFAULT else '',
-       description
+       description,
    ]
    help_lines.append(''.join(line_parts))
 
@@ -122,12 +122,12 @@ arguments = None
 if __name__ == "__main__":
     arguments = parser.parse_args()
 
-reasons_with_backend_values: Final[Dict[str, Optional[str]]] = {
+reasons_with_backend_values: Final[dict[str, str | None]] = {
    'first positional argument'       : None if not arguments else arguments.backend,
    # An environment variable allows specifying the binding when
    # importing the module instead of running it as a main program.
    f'{ENV_VARIABLE!r} env variable'  : os.environ.get(ENV_VARIABLE, None),
-   'default'                         : DEFAULT
+   'default'                         : DEFAULT,
 }
 reason, backend = next(filter(
     lambda t: t[1] is not None, reasons_with_backend_values.items()))
@@ -143,16 +143,14 @@ import pyglet
 # uses of PyQt5-specific features as missing. For example, pyright is
 # one of the strict type checking and linting tools which can help.
 if TYPE_CHECKING or backend == PYSIDE2:
-    from PySide2.QtGui import QWheelEvent
-    from PySide2.QtWidgets import QFileDialog
     from PySide2 import QtCore, QtWidgets
-    from PySide2.QtWidgets import QOpenGLWidget
+    from PySide2.QtGui import QWheelEvent
+    from PySide2.QtWidgets import QFileDialog, QOpenGLWidget
 
 elif backend == PYQT5:
-    from PyQt5.QtGui import QWheelEvent
-    from PyQt5.QtWidgets import QFileDialog
     from PyQt5 import QtCore, QtWidgets
-    from PyQt5.QtWidgets import QOpenGLWidget
+    from PyQt5.QtGui import QWheelEvent
+    from PyQt5.QtWidgets import QFileDialog, QOpenGLWidget
 
 else:  # Handle import edge cases
     raise ValueError(
@@ -162,11 +160,18 @@ else:  # Handle import edge cases
 # Import the other constants after the UI libraries to avoid
 # cluttering the symbol table when debugging import problems.
 from pyglet.gl import (
-    glClear, GL_COLOR_BUFFER_BIT, GL_DEPTH_BUFFER_BIT, glActiveTexture,
-    GL_TEXTURE0, glBindTexture, GL_BLEND, glEnable, glBlendFunc, glDisable
+   GL_BLEND,
+   GL_COLOR_BUFFER_BIT,
+   GL_DEPTH_BUFFER_BIT,
+   GL_TEXTURE0,
+   glActiveTexture,
+   glBindTexture,
+   glBlendFunc,
+   glClear,
+   glDisable,
+   glEnable,
 )
 
-
 default_vertex_src = """#version 150 core
 in vec3 translate;
 in vec4 colors;
@@ -233,8 +238,8 @@ class MultiTextureSpriteGroup(pyglet.sprite.SpriteGroup):
             textures: Mapping[str, pyglet.image.Texture],
             blend_src: int,
             blend_dest: int,
-            program: Optional[pyglet.graphics.shader.ShaderProgram] = None,
-            parent: Optional[pyglet.graphics.Group] = None
+            program: pyglet.graphics.shader.ShaderProgram | None = None,
+            parent: pyglet.graphics.Group | None = None,
     ) -> None:
         """Create a sprite group for multiple textures and samplers.
 
@@ -297,7 +302,7 @@ class MultiTextureSpriteGroup(pyglet.sprite.SpriteGroup):
                      self.blend_src, self.blend_dest))
 
 
-class MultiTextureSprite(pyglet.sprite.AdvancedSprite):
+class MultiTextureSprite(pyglet.sprite.Sprite):
 
     def __init__(
             self,
@@ -305,10 +310,10 @@ class MultiTextureSprite(pyglet.sprite.AdvancedSprite):
             x: float = 0, y: float = 0, z: float = 0,
             blend_src: int = pyglet.gl.GL_SRC_ALPHA,
             blend_dest: int = pyglet.gl.GL_ONE_MINUS_SRC_ALPHA,
-            batch: Optional[pyglet.graphics.Batch] = None,
-            group: Optional[MultiTextureSpriteGroup] = None,
+            batch: pyglet.graphics.Batch | None = None,
+            group: MultiTextureSpriteGroup | None = None,
             subpixel: bool = False,
-            program: pyglet.graphics.shader.ShaderProgram = None
+            program: pyglet.graphics.shader.ShaderProgram = None,
     ) -> None:
 
         self._x = x
@@ -484,7 +489,7 @@ class Ui_MainWindow:
             self.program = pyglet.graphics.shader.ShaderProgram(vertex_, fragment_)
 
             if len(self.images) == 1:
-                self.sprite = pyglet.sprite.AdvancedSprite(
+                self.sprite = pyglet.sprite.Sprite(
                     self.images[0],
                     x=self.SPRITE_POSITION[0], y=self.SPRITE_POSITION[1],
                     group=self.group, batch=self.openGLWidget.batch,
@@ -685,7 +690,6 @@ class PygletWidget(QOpenGLWidget):
 
     def initializeGL(self) -> None:
         """Call anything that needs a context to be created."""
-
         self._projection_matrix = pyglet.math.Mat4()
         self._view_matrix = pyglet.math.Mat4()
 
@@ -702,7 +706,7 @@ class PygletWidget(QOpenGLWidget):
         self.viewport = 0, 0, self.width(), self.height()
 
     @property
-    def viewport(self) -> Tuple[int, int, int, int]:
+    def viewport(self) -> tuple[int, int, int, int]:
         """The Window viewport
 
         The Window viewport, expressed as (x, y, width, height).
@@ -712,7 +716,7 @@ class PygletWidget(QOpenGLWidget):
         return self._viewport
 
     @viewport.setter
-    def viewport(self, values: Tuple[int, int, int, int]) -> None:
+    def viewport(self, values: tuple[int, int, int, int]) -> None:
         self._viewport = values
         pr = 1.0
         x, y, w, h = values

{pyglet-2.1.dev2 → pyglet-2.1.dev4}/contrib/toys/follow_mouse.py

@@ -16,7 +16,17 @@ import sys
 import random
 
 import pyglet
-from pyglet.gl import *
+from pyglet.gl import (
+    glEnable,
+    glBlendFunc,
+    glFlush,
+    Config,
+    GL_BLEND,
+    GL_LINE_SMOOTH,
+    GL_LINES,
+    GL_SRC_ALPHA,
+    GL_ONE_MINUS_SRC_ALPHA,
+)
 
 # open a single-buffered window so we can do cheap accumulation
 config = Config(double_buffer=False)

pyglet-2.1.dev4/doc/_static/css/custom.css

@@ -0,0 +1,29 @@
+/* Import RTD theme before our own changes. */
+@import 'theme.css';
+
+/* CSS to fix wrapping: https://github.com/readthedocs/sphinx_rtd_theme/issues/1529#issuecomment-1918561608 */
+/* Take out pointless vertical whitespace in the signatures. */
+.rst-content dl .sig dl,
+.rst-content dl .sig dd {
+    margin-bottom: 0;
+    margin-top: 0;
+}
+
+/* Make class boxes full-width, with view-source and header links right-aligned. */
+.py.class > .sig.sig-object.py:first-of-type {
+    width: 100%;
+}
+.py.class > .sig.sig-object.py:first-of-type .viewcode-link {
+  display: inline-flex;
+  float: right;
+  margin-right: 1.5em;
+}
+.py.class > .sig.sig-object.py:first-of-type .headerlink {
+  position: absolute;
+  right: 0.5em;
+}
+
+/* Prevent multiple properties from being on the same row. */
+dl.py.property {
+    display: block !important;
+}