[Feat] Deprecate Python 3.8, add Python 3.12 + update CI/CD

.github/workflows/build-publish.yml

@@ -19,9 +19,6 @@ jobs:
         strategy:
             matrix:
                 include:
-                    - os: ubuntu-latest
-                      python: 38
-                      platform: manylinux_x86_64
                     - os: ubuntu-latest
                       python: 39
                       platform: manylinux_x86_64
@@ -35,6 +32,7 @@ jobs:
                       python: 312
                       platform: manylinux_x86_64
 
+
         steps:
             - uses: actions/checkout@v4
             - name: Set up Python

.github/workflows/docs-test.yml

@@ -12,7 +12,7 @@ permissions:
 
 jobs:
     docs-test:
-        runs-on: ubuntu-latest
+        runs-on: ubuntu-22.04
         strategy:
             matrix:
                 group: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

.github/workflows/linux-test.yml

@@ -12,10 +12,10 @@ permissions:
 
 jobs:
     linux-test:
-        runs-on: ubuntu-latest
+        runs-on: ubuntu-22.04
         strategy:
             matrix:
-                python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+                python-version: ['3.9', '3.10', '3.11', '3.12']
         steps:
             - uses: actions/checkout@v4
             - name: Set up Python ${{ matrix.python-version }}

.github/workflows/linux-tutorials-test.yml

@@ -12,12 +12,12 @@ permissions:
 
 jobs:
     tutorial-test:
-        runs-on: ubuntu-latest
+        runs-on: ubuntu-22.04
         strategy:
             fail-fast: false
 
             matrix:
-                python-version: ['3.8', '3.9', '3.10', '3.11']
+                python-version: ['3.9', '3.10', '3.11', '3.12']
                 tutorial: [Tianshou, CustomEnvironment, CleanRL, SB3/kaz, SB3/waterworld, SB3/test]  # TODO: fix tutorials and add back Ray, fix SB3/connect_four tutorial
         steps:
             - uses: actions/checkout@v4
@@ -31,14 +31,15 @@ jobs:
                   export PATH=/path/to/parallel:$PATH
                   export root_dir=$(pwd)
                   cd tutorials/${{ matrix.tutorial }}
-                  pip install -r requirements.txt
-                  pip uninstall -y pettingzoo
+                  grep -ivE "pettingzoo" requirements.txt > _requirements.txt
+                  pip install -r _requirements.txt
+                  pip install -e $root_dir[all]
                   pip install -e $root_dir[testing]
                   AutoROM -v
                   for f in *.py; do xvfb-run -a -s "-screen 0 1024x768x24" python "$f"; done
 
     agilerl-tutorial-test:
-        runs-on: ubuntu-latest
+        runs-on: ubuntu-22.04
         strategy:
             fail-fast: false
             matrix:
@@ -56,8 +57,9 @@ jobs:
                   export PATH=/path/to/parallel:$PATH
                   export root_dir=$(pwd)
                   cd tutorials/${{ matrix.tutorial }}
-                  pip install -r requirements.txt
-                  pip uninstall -y pettingzoo
+                  grep -ivE "pettingzoo" requirements.txt > _requirements.txt
+                  pip install -r _requirements.txt
+                  pip install -e $root_dir[all]
                   pip install -e $root_dir[testing]
                   AutoROM -v
                   for f in *.py; do xvfb-run -a -s "-screen 0 1024x768x24" python "$f"; done

.github/workflows/macos-test.yml

@@ -15,7 +15,7 @@ jobs:
             matrix:
             # Big Sur, Monterey
                 os: [macos-11, macos-12]
-                python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+                python-version: ['3.9', '3.10', '3.11', '3.12']
         steps:
             - uses: actions/checkout@v4
             - name: Set up Python ${{ matrix.python-version }}

.gitignore

@@ -84,6 +84,7 @@ ipython_config.py
 
 # MacOS specific
 */.DS_Store
+.DS_Store
 
 # pyenv
 #   For a library or package, you might want to ignore these files since the code is

README.md

@@ -26,7 +26,7 @@ This does not include dependencies for all families of environments (some enviro
 
 To install the dependencies for one family, use `pip install 'pettingzoo[atari]'`, or use `pip install 'pettingzoo[all]'` to install all dependencies.
 
-We support Python 3.8, 3.9, 3.10 and 3.11 on Linux and macOS. We will accept PRs related to Windows, but do not officially support it.
+We support and maintain PettingZoo for Python 3.9, 3.10, 3.11, and 3.12 on Linux and macOS. We will accept PRs related to Windows, but do not officially support it.
 
 Note: Some Linux distributions may require manual installation of `cmake`, `swig`, or `zlib1g-dev` (e.g., `sudo apt install cmake swig zlib1g-dev`)
 

docs/content/basic_usage.md

@@ -11,7 +11,7 @@ This does not include dependencies for all families of environments (some enviro
 
 To install the dependencies for one family, use `pip install 'pettingzoo[atari]'`, or use `pip install 'pettingzoo[all]'` to install all dependencies.
 
-We support Python 3.8, 3.9, 3.10 and 3.11 on Linux and macOS. We will accept PRs related to Windows, but do not officially support it.
+We support and maintain PettingZoo for Python 3.9, 3.10, 3.11, and 3.12 on Linux and macOS. We will accept PRs related to Windows, but do not officially support it.
 
 ## Initializing Environments
 

docs/tutorials/agilerl/index.md

@@ -12,6 +12,13 @@ AgileRL is a deep reinforcement learning framework focused on streamlining train
 
 For more information about AgileRL and what else the library has to offer, check out the [documentation](https://agilerl.readthedocs.io/en/latest/) and [GitHub repo](https://github.com/agilerl/agilerl).
 
+```{eval-rst}
+.. warning::
+
+   AgileRL only supports versions of python <3.12.
+
+```
+
 ## Examples using PettingZoo
 
 * [MADDPG for co-operation: simple speaker listener environment](https://agilerl.readthedocs.io/en/latest/multi_agent_training/index.html)

pyproject.toml

@@ -8,15 +8,14 @@ build-backend = "setuptools.build_meta"
 name = "pettingzoo"
 description = "Gymnasium for multi-agent reinforcement learning."
 readme = "README.md"
-requires-python = ">= 3.8"
+requires-python = ">= 3.9, <3.13"
 authors = [{ name = "Farama Foundation", email = "[email protected]" }]
 license = { text = "MIT License" }
 keywords = ["Reinforcement Learning", "game", "RL", "AI", "gymnasium"]
 classifiers = [
     "Development Status :: 4 - Beta",  # change to `5 - Production/Stable` when ready
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",

tutorials/AgileRL/requirements.txt

@@ -1,4 +1,4 @@
-agilerl==0.1.22; python_version >= '3.9'
+agilerl==0.1.22; python_version >= '3.9' and python_version < '3.12'
 pettingzoo[classic,atari,mpe]>=1.23.1
 SuperSuit>=3.9.0
 torch>=2.0.1
@@ -9,4 +9,3 @@ gymnasium>=0.28.1
 imageio>=2.31.1
 Pillow>=9.5.0
 PyYAML>=5.4.1
-wandb>=0.13.10

tutorials/CustomEnvironment/requirements.txt

@@ -1 +1,2 @@
-pettingzoo==1.24.0
+numpy>=1.21.0
+pettingzoo>=1.24.0