Merge branch 'master' into add-pre-commit

Author: edwardchalstrey1

.all-contributorsrc

@@ -34,7 +34,7 @@
         "ideas"
       ]
     },
-    {  
+    {
       "login": "edwardchalstrey1",
       "name": "Ed Chalstrey",
       "avatar_url": "https://avatars.githubusercontent.com/u/5486164?v=4",

.github/ISSUE_TEMPLATE/tutorial_request.yml

@@ -0,0 +1,35 @@
+name: Tutorial request
+description: Submit a request for a new tutorial to be added to the Gambit documentation.
+title: "[Tutorial]: "
+labels: ["tutorial", "documentation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this tutorial request!
+  - type: textarea
+    id: describe
+    attributes:
+      label: Describe the tutorial you want to see.
+      description: Go into as much detail as you can regarding the tutorial you would like to see, how long it should be etc.
+      placeholder: "E.g. A step-by-step guide showing how to use PyGambit to compute equilibria for normal and extensive form games..."
+      value: "Add a tutorial demonstrating the core components of the PyGambit API."
+    validations:
+      required: true
+  - type: textarea
+    id: who
+    attributes:
+      label: Who is the tutorial for?
+      description: Explain who the target audience is for this tutorial and what prior knowledge they should have.
+      placeholder: "E.g. Beginners in game theory who know basic Python."
+      value: "Newcomers to game theory and the Gambit software who have basic Python programming skills."
+    validations:
+      required: true
+  - type: textarea
+    id: links
+    attributes:
+      label: Add links to papers and software.
+      description: Add links to any research papers or other resources the author will need to write this tutorial.
+      value: "`[Markdown link text](url)`"
+    validations:
+      required: false

.github/workflows/python.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Set up dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install setuptools build cython pytest pytest-skip-slow wheel lxml numpy scipy
+          pip install setuptools build cython pytest pytest-skip-slow wheel lxml numpy scipy nbformat nbclient ipykernel
       - name: Build source distribution
         run:
           python -m build
@@ -38,7 +38,13 @@ jobs:
           cd dist
           pip install -v pygambit*.tar.gz
       - name: Run tests
-        run: pytest
+        run: |
+          if [ "${{ matrix.python-version }}" = "3.9" ]; then
+            # Python 3.9 on linux skips the notebook execution test (notebooks may require newer kernels/deps)
+            pytest -q -k 'not test_execute_notebook'
+          else
+            pytest
+          fi
 
   macos-13:
     runs-on: macos-13
@@ -56,7 +62,7 @@ jobs:
       - name: Set up dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install cython pytest pytest-skip-slow wheel lxml numpy scipy
+          pip install cython pytest pytest-skip-slow wheel lxml numpy scipy nbformat nbclient ipykernel
       - name: Build extension
         run: |
           python -m pip install -v .
@@ -79,7 +85,7 @@ jobs:
       - name: Set up dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install cython pytest pytest-skip-slow wheel lxml numpy scipy
+          pip install cython pytest pytest-skip-slow wheel lxml numpy scipy nbformat nbclient ipykernel
       - name: Build extension
         run: |
           python -m pip install -v .
@@ -102,7 +108,7 @@ jobs:
       - name: Set up dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install cython pytest pytest-skip-slow wheel lxml numpy scipy
+          pip install cython pytest pytest-skip-slow wheel lxml numpy scipy nbformat nbclient ipykernel
       - name: Build extension
         run: |
           python -m pip install -v .

.gitignore

@@ -38,4 +38,7 @@ gambit
 dist
 .venv
 *.dmg
-Gambit.app/*
+Gambit.app/*
+*.so
+doc/tutorials/games/*.nfg
+doc/tutorials/games/*.efg

.pre-commit-config.yaml

@@ -1,21 +1,21 @@
 repos:
 - repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v4.6.0
+  rev: v6.0.0
   hooks:
     - id: trailing-whitespace
     - id: end-of-file-fixer
     - id: check-yaml
     - id: check-added-large-files
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.6.1
+  rev: v0.14.5
   hooks:
     - id: ruff
 - repo: https://github.com/pycqa/flake8
-  rev: 7.1.0
+  rev: 7.3.0
   hooks:
     - id: flake8
 - repo: https://github.com/MarcoGorelli/cython-lint
-  rev: v0.16.2
+  rev: v0.18.1
   hooks:
     - id: cython-lint
     - id: double-quote-cython-strings

.readthedocs.yml

@@ -11,6 +11,7 @@ build:
     python: "3.13"
   apt_packages:
     - libgmp-dev
+    - pandoc
 
 python:
   install: