pyglet-gamemaker 1.0.0__tar.gz

pyglet_gamemaker-1.0.0/.github/workflows/build-pipeline.yml

@@ -0,0 +1,50 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: CI build
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+    - uses: actions/checkout@v6
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+      
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+
+    - name: Run Ruff
+      uses: astral-sh/ruff-action@v1
+      with:
+        args: "check --output-format=github"
+        src: "."
+      
+    #- name: Lint with flake8
+    #  run: |
+    #    # stop the build if there are Python syntax errors or undefined names
+    #    flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+    #    # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+    #    flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+      
+    #- name: Test with pytest
+    #  run: |
+    #    pytest

pyglet_gamemaker-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,70 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: PyPI Upload
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      # url: https://pypi.org/p/pyglet-gamemaker
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+      url: https://pypi.org/project/pyglet_gamemaker/${{ github.event.release.name }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

pyglet_gamemaker-1.0.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__
+.vscode
+.venv
+_version.py

pyglet_gamemaker-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [Steven Robles]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyglet_gamemaker-1.0.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: pyglet-gamemaker
+Version: 1.0.0
+Summary: pyglet wrapper for making games.
+Project-URL: Homepage, https://github.com/Badnameee/pyglet-gamemaker
+Project-URL: Issues, https://github.com/Badnameee/pyglet-gamemaker/issues
+Author-email: Steven Robles <stevenrrobles13@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# 📦 pyglet-gamemaker
+
+<!-- (add your badges here) -->
+
+<!-- > *Your documentation is a direct reflection of your software, so hold it to the same standards.* -->
+
+
+## ℹ️ Overview
+
+<!-- A paragraph explaining your work, who you are, and why you made it. -->
+
+**pyglet-gamemaker** is an extension of Pyglet that simplifies the process of making games! This project began when I became frustrated at the boilerplate I had to write all the time, and I wanted a cleaner system to quickly add features.
+
+
+## 🌟 Features
+
+- Hitboxes
+  - Fully working convex polygon collision
+  - Includes circles
+- Spritesheets:
+  - Automatically loaded
+  - Labelable to allow for indexing by string
+- Widgets:
+  - Dynamic anchoring for changing size
+  - Uses spritesheets instead of individual images
+- Scenes:
+  - Enabling and disabling handled automatically
+  - Menus:
+    - Easily create visuals + widgets
+    - Widget positions relative to window size
+- Main Window class handles switching of scenes
+
+### ✍️ Authors
+
+I'm [Steven Robles](https://github.com/Badnameee) and I am a high school student with a *small?* passion for making games.
+
+
+## 🚀 Usage
+
+<!-- *Show off what your software looks like in action! Try to limit it to one-liners if possible and don't delve into API specifics.* -->
+
+A simple program to render an empty Menu with button detection:
+```py
+>>> import pyglet_gamemaker as pgm
+>>> from pyglet_gamemaker.types import Color
+>>> 
+>>> 
+>>> class Menu(pgm.Menu):
+>>>     # Create widgets here
+>>>     def create_widgets(self): ...
+>>>     # Code that runs when button is pressed down
+>>>     def on_half_click(self, button): ...
+>>>     # Code that runs when button is fully clicked and released
+>>>     def on_full_click(self, button): ...
+>>>     # Code that runs when scene is enabled
+>>>     def enable(self): ...
+>>>     # Code that runs when scene is disabled
+>>>     def disable(self): ...
+>>> 
+>>> 
+>>> scene = Menu('Test')
+>>> game = pgm.Window((640, 480))
+>>> game.add_scene('Test', scene)
+>>> game.run()
+```
+
+Creating a spritesheet
+```py
+>>> # Create a sprite sheet with image assets
+>>> #   This image, found in /test, has 3 images (bottom to top):
+>>> #   Unpressed, Hover, and Pressed
+>>> self.sheet = pgm.sprite.SpriteSheet('test/Default Button.png', rows=3, cols=1)
+```
+
+The following should go in `Menu.create_widgets()`:
+
+- Creating text
+```py
+>>> self.create_text(
+>>>     'Text', 'Test',
+>>>     ('center', 'center'), color=pgm.types.Color.BLACK
+>>> )
+```
+
+- Creating a button
+```py
+>>> self.create_button(
+>>>     'Button', self.sheet, 0,
+>>>     ('center', 'center'),
+>>>     # Event handlers defined in empty Menu class above
+>>>     on_half_click=self.on_half_click, on_full_click=self.on_full_click
+>>> )
+```
+
+- Creating a text and button in one
+```py
+>>> # A textbutton combines text and a button
+>>> #   Hover enlarge makes text larger when hovering
+>>> #   Works well with using larger hover sprite for button
+>>> self.create_text_button(
+>>>     'TextButton', 'Text',
+>>>     self.sheet, 0,
+>>>     ('center', 'center'), ('center', 'center'),
+>>>     # Event handlers defined in empty Menu class above
+>>>     on_half_click=self.on_half_click, on_full_click=self.on_full_click
+>>> )
+```
+
+<img src="/media/demo.gif" width="50%" height="50%"/>
+
+
+## ⬇️ Installation
+
+Simple, understandable installation instructions!
+
+```bash
+pip install pyglet-gamemaker
+```
+
+<!-- And be sure to specify any other minimum requirements like Python versions or operating systems. -->
+Works in Python >=3.10
+
+<!-- *You may be inclined to add development instructions here, don't.* -->
+
+
+## 💭 Feedback and Contributing
+
+<!--Add a link to the Discussions tab in your repo and invite users to open issues for bugs/feature requests. -->
+
+To request features or report bugs, open an issue [here](https://github.com/Badnameee/pyglet-gamemaker/issues).
+
+[Contact me directly](mailto:stevenrrobles13@gmail.com)
+
+<!-- This is also a great place to invite others to contribute in any ways that make sense for your project. Point people to your DEVELOPMENT and/or CONTRIBUTING guides if you have them. -->

pyglet_gamemaker-1.0.0/README.md

@@ -0,0 +1,134 @@
+# 📦 pyglet-gamemaker
+
+<!-- (add your badges here) -->
+
+<!-- > *Your documentation is a direct reflection of your software, so hold it to the same standards.* -->
+
+
+## ℹ️ Overview
+
+<!-- A paragraph explaining your work, who you are, and why you made it. -->
+
+**pyglet-gamemaker** is an extension of Pyglet that simplifies the process of making games! This project began when I became frustrated at the boilerplate I had to write all the time, and I wanted a cleaner system to quickly add features.
+
+
+## 🌟 Features
+
+- Hitboxes
+  - Fully working convex polygon collision
+  - Includes circles
+- Spritesheets:
+  - Automatically loaded
+  - Labelable to allow for indexing by string
+- Widgets:
+  - Dynamic anchoring for changing size
+  - Uses spritesheets instead of individual images
+- Scenes:
+  - Enabling and disabling handled automatically
+  - Menus:
+    - Easily create visuals + widgets
+    - Widget positions relative to window size
+- Main Window class handles switching of scenes
+
+### ✍️ Authors
+
+I'm [Steven Robles](https://github.com/Badnameee) and I am a high school student with a *small?* passion for making games.
+
+
+## 🚀 Usage
+
+<!-- *Show off what your software looks like in action! Try to limit it to one-liners if possible and don't delve into API specifics.* -->
+
+A simple program to render an empty Menu with button detection:
+```py
+>>> import pyglet_gamemaker as pgm
+>>> from pyglet_gamemaker.types import Color
+>>> 
+>>> 
+>>> class Menu(pgm.Menu):
+>>>     # Create widgets here
+>>>     def create_widgets(self): ...
+>>>     # Code that runs when button is pressed down
+>>>     def on_half_click(self, button): ...
+>>>     # Code that runs when button is fully clicked and released
+>>>     def on_full_click(self, button): ...
+>>>     # Code that runs when scene is enabled
+>>>     def enable(self): ...
+>>>     # Code that runs when scene is disabled
+>>>     def disable(self): ...
+>>> 
+>>> 
+>>> scene = Menu('Test')
+>>> game = pgm.Window((640, 480))
+>>> game.add_scene('Test', scene)
+>>> game.run()
+```
+
+Creating a spritesheet
+```py
+>>> # Create a sprite sheet with image assets
+>>> #   This image, found in /test, has 3 images (bottom to top):
+>>> #   Unpressed, Hover, and Pressed
+>>> self.sheet = pgm.sprite.SpriteSheet('test/Default Button.png', rows=3, cols=1)
+```
+
+The following should go in `Menu.create_widgets()`:
+
+- Creating text
+```py
+>>> self.create_text(
+>>>     'Text', 'Test',
+>>>     ('center', 'center'), color=pgm.types.Color.BLACK
+>>> )
+```
+
+- Creating a button
+```py
+>>> self.create_button(
+>>>     'Button', self.sheet, 0,
+>>>     ('center', 'center'),
+>>>     # Event handlers defined in empty Menu class above
+>>>     on_half_click=self.on_half_click, on_full_click=self.on_full_click
+>>> )
+```
+
+- Creating a text and button in one
+```py
+>>> # A textbutton combines text and a button
+>>> #   Hover enlarge makes text larger when hovering
+>>> #   Works well with using larger hover sprite for button
+>>> self.create_text_button(
+>>>     'TextButton', 'Text',
+>>>     self.sheet, 0,
+>>>     ('center', 'center'), ('center', 'center'),
+>>>     # Event handlers defined in empty Menu class above
+>>>     on_half_click=self.on_half_click, on_full_click=self.on_full_click
+>>> )
+```
+
+<img src="/media/demo.gif" width="50%" height="50%"/>
+
+
+## ⬇️ Installation
+
+Simple, understandable installation instructions!
+
+```bash
+pip install pyglet-gamemaker
+```
+
+<!-- And be sure to specify any other minimum requirements like Python versions or operating systems. -->
+Works in Python >=3.10
+
+<!-- *You may be inclined to add development instructions here, don't.* -->
+
+
+## 💭 Feedback and Contributing
+
+<!--Add a link to the Discussions tab in your repo and invite users to open issues for bugs/feature requests. -->
+
+To request features or report bugs, open an issue [here](https://github.com/Badnameee/pyglet-gamemaker/issues).
+
+[Contact me directly](mailto:stevenrrobles13@gmail.com)
+
+<!-- This is also a great place to invite others to contribute in any ways that make sense for your project. Point people to your DEVELOPMENT and/or CONTRIBUTING guides if you have them. -->

pyglet_gamemaker-1.0.0/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = None

pyglet_gamemaker-1.0.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling >= 1.27", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "_version.py"
+
+[project]
+name = "pyglet-gamemaker"
+dynamic = ["version"]
+authors = [
+	{ name="Steven Robles", email="stevenrrobles13@gmail.com" }
+]
+description = "pyglet wrapper for making games."
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+	"Programming Language :: Python :: 3.10",
+	"Programming Language :: Python :: 3.11",
+	"Programming Language :: Python :: 3.12",
+	"Programming Language :: Python :: 3.13",
+	"Programming Language :: Python :: 3.14",
+	"Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://github.com/Badnameee/pyglet-gamemaker"
+Issues = "https://github.com/Badnameee/pyglet-gamemaker/issues"
+
+[tool.mypy]
+python_version = "3.14"
+exclude = [
+	"^test/.*$",
+	"^run_tests\\.py$",
+	"^run_demo\\.py$"
+]
+
+[tool.ruff]
+exclude = ["**/__init__.py"]
+
+[tool.ruff.format]
+indent-style = "tab"
+quote-style = "single"
+
+[tool.ruff.lint]
+ignore = ["F403", "F405"]

pyglet_gamemaker-1.0.0/requirements.txt

@@ -0,0 +1,6 @@
+mypy==1.18.2
+mypy_extensions==1.1.0
+pathspec==0.12.1
+pyglet==2.1.10
+ruff==0.14.10
+typing_extensions==4.15.0

pyglet_gamemaker-1.0.0/run_demo.py

@@ -0,0 +1,2 @@
+import test.demo
+test.demo

pyglet_gamemaker-1.0.0/run_tests.py

@@ -0,0 +1,21 @@
+import pyglet
+
+# Holds all imports for tests
+tests = [
+	'sprite_spritesheet',
+	'gui_button',
+	'gui_text',
+	'gui_text_button',
+	'shapes_hitbox',
+	'shapes_rect',
+	'shapes_circle',
+	'menu',
+	'window',
+]
+
+pyglet.resource.path = ['test']
+pyglet.resource.reindex()
+
+for test_num, test in enumerate(tests, 1):
+	print(f'\n-----------------------------\nStarting test #{test_num}: "{test}"\n\n')
+	exec(f'import test.{test}')  # Run actual test

pyglet_gamemaker-1.0.0/src/__init__.py

@@ -0,0 +1,4 @@
+from .menu import Menu
+from .scene import Scene
+from .window import Window
+from . import sprite, types

pyglet_gamemaker-1.0.0/src/gui/__init__.py

@@ -0,0 +1,3 @@
+from .button import Button
+from .text import Text
+from .text_button import TextButton