Pyglet 2.0 migration (#43)

* Modernize CI, update dependencies, and add security policy

Replaces Travis CI with GitHub Actions workflows, adds CodeQL analysis, and introduces Dependabot configuration for automated dependency updates. Updates Python support to 3.8+ in setup.py and pyproject.toml, modernizes pre-commit hooks, and expands .gitignore for better cross-platform and tool coverage. Adds SECURITY.md and .python-version, removes .travis.yml, and makes minor docstring and formatting improvements throughout the codebase.

* Update build config and linting, fix widget style dict

Added build-system section to pyproject.toml for setuptools and wheel. Updated GitHub Actions workflow to install setuptools separately. Modified tox.ini to include setuptools as a dependency. Improved .pylintrc init-hook and disabled too-many-positional-arguments warning. Fixed style dict usage in widgets.py for pyglet text document.

* Refactor drawing to use pyglet.shapes and improve macOS support

Replaces low-level pyglet.graphics drawing calls with pyglet.shapes primitives for lines, circles, and rectangles in graphics and widgets modules. Adds platform-specific handling for PyObjC dependencies and pyglet options for better compatibility on macOS, including PyPy support. Updates setup.py to install PyObjC only on CPython/macOS, and improves documentation for macOS and PyPy users.

* Update type annotations and suppress type warning

Changed the return type of TilingGui.on_resize to Literal[True] for more precise typing. Added a type: ignore comment when instantiating TilingGui in main.py to suppress a type checker warning.

* Update UI colors and font sizes for improved appearance

Increased the top bar height and font sizes in the menu for better readability. Updated text box and background colors in the menu for a lighter appearance. Standardized color usage in tplot by applying scale_to_01 to all color constants.

* Increase UI dimensions and improve widget scaling

Updated initial window and UI bar sizes for a larger interface. Increased font sizes in menu components for better readability. Improved text and button image positioning and scaling in widgets for more consistent appearance. Fixed a typo in ButtonGrid's rect assignment and adjusted padding.

* Exit on PyPy/macOS due to pyglet incompatibility

Replace disabling of pyglet's shadow window with an explicit warning and exit when running on PyPy with macOS, as this configuration is not supported. This prevents users from encountering subtle runtime issues.

* Cast width and height to float for scaling

Explicitly cast button width and height to float when calculating scale factors to ensure correct aspect ratio scaling and avoid integer division issues.

* Improve sprite scaling for Button widget

Updated the Button widget to handle both AbstractImage and Animation types when scaling sprites. The code now checks for width and height attributes on the image, falling back to sprite dimensions if necessary, ensuring correct scaling for different image types.

* Refactor color conversion logic and cleanup dependencies

Moved RGB-to-RGBA color conversion into a new Color.scale_to_255 method and updated all usages in graphics.py and widgets.py to use this utility. Removed platform-specific dependencies from setup.py for a simpler install_requires.

* Clarify PyPy incompatibility with macOS GUI frameworks

Expanded comments to document the fundamental incompatibility between PyPy's ctypes and macOS GUI frameworks, affecting all major Python GUI libraries. Updated runtime check to print a more explicit error and exit if PyPy is detected on macOS, advising users to use CPython or try PyPy on other platforms.

Author: ulfarsson

.editorconfig

@@ -12,4 +12,4 @@ indent_size = 4
 indent_size = 2
 
 [*.{md,rst}]
-trim_trailing_whitespace = false
+trim_trailing_whitespace = false

.flake8

@@ -1,3 +1,3 @@
 [flake8]
 max-line-length = 88
-extend-ignore = E203
+extend-ignore = E203

.gitattribute

@@ -18,4 +18,4 @@ LICENSE         text    eol=lf
 .gitignore      text    eol=lf
 .gitattribute   text    eol=lf
 .flake8         text    eol=lf
-.pylintrc       text    eol=lf
+.pylintrc       text    eol=lf

.github/dependabot.yml

@@ -0,0 +1,33 @@
+version: 2
+updates:
+  # Enable version updates for Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "PermutaTriangle"
+    assignees:
+      - "PermutaTriangle"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:00"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "PermutaTriangle"
+    assignees:
+      - "PermutaTriangle"
+    commit-message:
+      prefix: "ci"
+      include: "scope"

.github/workflows/codeql.yml

@@ -0,0 +1,40 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master, develop ]
+  pull_request:
+    branches: [ master ]
+  schedule:
+    - cron: '30 2 * * 1'  # Weekly on Mondays at 02:30 UTC
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.github/workflows/test.yml

@@ -9,22 +9,21 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - python: 3.8
+          # Linting and type checking (run on Python 3.11)
+          - python: "3.11"
             toxenv: flake8
             os: ubuntu-latest
-          - python: 3.8
+          - python: "3.11"
             toxenv: mypy
             os: ubuntu-latest
-          - python: 3.8
+          - python: "3.11"
             toxenv: pylint
             os: ubuntu-latest
-          - python: 3.8
+          - python: "3.11"
             toxenv: black
             os: ubuntu-latest
 
-          - python: 3.7
-            toxenv: py37
-            os: ubuntu-latest
+          # Python version testing (Linux)
           - python: 3.8
             toxenv: py38
             os: ubuntu-latest
@@ -34,28 +33,47 @@ jobs:
           - python: "3.10"
             toxenv: py310
             os: ubuntu-latest
-          - python: pypy-3.7
-            toxenv: pypy37
+          - python: "3.11"
+            toxenv: py311
+            os: ubuntu-latest
+          - python: "3.12"
+            toxenv: py312
+            os: ubuntu-latest
+          - python: "3.13"
+            toxenv: py313
+            os: ubuntu-latest
+          - python: pypy-3.8
+            toxenv: pypy38
+            os: ubuntu-latest
+          - python: pypy-3.9
+            toxenv: pypy39
+            os: ubuntu-latest
+          - python: pypy-3.10
+            toxenv: pypy310
             os: ubuntu-latest
 
-          - python: 3.8
-            toxenv: py38
+          # Cross-platform testing (Python 3.11)
+          - python: "3.11"
+            toxenv: py311
             os: macos-latest
-          - python: 3.8
-            toxenv: py38
+          - python: "3.11"
+            toxenv: py311
             os: windows-latest
 
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
         with:
-          python-version: ${{  matrix.python }}
+          python-version: ${{ matrix.python }}
+          allow-prereleases: true
       - name: install dependencies
-        run: python -m pip install --upgrade pip tox
+        run: |
+          python -m pip install --upgrade pip setuptools
+          python -m pip install tox
       - name: run
         env:
           TOXENV: ${{ matrix.toxenv }}
         run: tox
       - name: setup
-        run: python setup.py install
+        run: python setup.py install

.gitignore

@@ -86,8 +86,8 @@ target/
 profile_default/
 ipython_config.py
 
-# pyenv
-.python-version
+# pyenv (but we want to track our .python-version file)
+# .python-version
 
 # pipenv
 #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
@@ -142,4 +142,63 @@ dmypy.json
 .vscode/
 
 # Program's output
-tilingsgui/exports/
+tilingsgui/exports/
+exports/
+
+# macOS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Windows
+*.stackdump
+
+# Linux
+*~
+
+# Temporary/backup files
+*.tmp
+*.temp
+*.bak
+*.swp
+*.swo
+*~
+
+# IDE specific files (additional)
+.idea/
+*.iml
+*.ipr
+*.iws
+.vscode/settings.json
+.vscode/launch.json
+.vscode/tasks.json
+
+# Pre-commit
+.pre-commit-config.yaml.bak
+
+# Ruff cache (modern Python linter)
+.ruff_cache/
+
+# Modern type checkers
+.pyright/
+
+# Coverage.py
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Duplicate files (with version numbers or " 2" suffix)
+*" 2".*
+* 2.*
+
+# Temporary export files
+*.json.tmp
+tilings_export.json
+
+# Development files that shouldn't be committed
+hamstur.py
+2025-MODERNIZATION-PLAN.md

.isort.cfg

@@ -5,4 +5,4 @@ multi_line_output=3
 include_trailing_comma=True
 force_grid_wrap=0
 use_parentheses=True
-line_length=88
+line_length=88

.pre-commit-config.yaml

@@ -1,5 +1,21 @@
 repos:
   - repo: https://github.com/psf/black
-    rev: 22.10.0
+    rev: 24.8.0
     hooks:
-      - id: black
+      - id: black
+        language_version: python3.11
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.1.1
+    hooks:
+      - id: flake8
+        additional_dependencies: [flake8-isort]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict

.pylintrc

@@ -1,8 +1,8 @@
 [MASTER]
 
 ignore-patterns=test_.*?py
-init-hook="from pylint.config import find_pylintrc; import os, sys; sys.path.append(os.path.dirname(find_pylintrc())+'/tilingsgui')"
+init-hook="import os, sys; sys.path.append(os.path.join(os.path.dirname(__file__), 'tilingsgui'))"
 max-args=10
 max-module-lines=1200
-disable=too-few-public-methods,too-many-lines
-good-names=r,c,x,y,h,w,i,j,k,n,x1,x2,y1,y2,g,b,dx,dy
+disable=too-few-public-methods,too-many-lines,too-many-positional-arguments
+good-names=r,c,x,y,h,w,i,j,k,n,x1,x2,y1,y2,g,b,dx,dy