Bump pyglet to 2.1.dev7 (#2412)

* Bump pyglet to 2.1.dev7

* Only import Framebuffer when TYPE_CHECKING

* Run ./make.py format

* Use Optional[Framebuffer] instead of | None

* Add doc run fix suggested by Ben

* Document why we now set sys.is_pyglet_doc_run

* Explain the issue

* Add link to the reporting ticket

* Add link to the commit which fixed it

* Try @DragonMoffon's suggestion to try | None again

* Remove unused import

Author: pushfoo

arcade/camera/camera_2d.py

@@ -18,13 +18,13 @@
     project_orthographic,
     unproject_orthographic,
 )
-from arcade.gl import Framebuffer
 from arcade.types import LBWH, LRBT, XYWH, Point, Rect
 from arcade.types.vector_like import Point2
 from arcade.window_commands import get_window
 
 if TYPE_CHECKING:
     from arcade.application import Window
+    from arcade.gl import Framebuffer
 
 __all__ = ["Camera2D"]
 

doc/conf.py

@@ -11,6 +11,13 @@
 import sphinx.transforms
 import sys
 
+# As of pyglet==2.1.dev7, this is no longer set in pyglet/__init__.py
+# because Jupyter / IPython always load Sphinx into sys.modules. See
+# the following for more info:
+# 1. The ticket: https://github.com/pyglet/pyglet/issues/1215
+# 2. The commit: https://github.com/pyglet/pyglet/commit/97076c3a33a7d368cc9c9e44ca67769b6a16a905
+sys.is_pyglet_doc_run = True
+
 # --- Pre-processing Tasks
 
 # Make thumbnails for the example code screenshots

pyproject.toml

@@ -23,7 +23,7 @@ dependencies = [
     # at the cost of slow download and constant pip install -I -e .[dev]    
     # "pyglet@git+https://github.com/pyglet/pyglet.git@development#egg=pyglet",
     # Expected future dev preview release on PyPI (not yet released)
-    'pyglet==2.1.dev6',
+    'pyglet==2.1.dev7',
     "pillow~=10.4.0",
     "pymunk~=6.8.1",
     "pytiled-parser~=2.2.5",