Maintained Version of this Template

.github/workflows/constraints.txt

@@ -1,8 +1,8 @@
-pip==23.0.1
+pip==23.2.1
 cookiecutter==2.1.1
 cutty==0.18.0
 nox==2022.11.21
 nox-poetry==1.0.2
-poetry==1.3.2
+poetry==1.6.1
 pre-commit==3.1.0
-virtualenv==20.14.1
+virtualenv==20.25.0

.github/workflows/docs.yml

@@ -8,13 +8,13 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/[email protected]
         with:
-          python-version: "3.8"
+          python-version: "3.9"
       - run: |
           pip install --constraint=.github/workflows/constraints.txt pip
           pip install --constraint=.github/workflows/constraints.txt nox
       - name: Build documentation
         run: nox --force-color --session=docs
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: docs
           path: docs/_build

.github/workflows/tests.yml

@@ -6,12 +6,13 @@ jobs:
       fail-fast: false
       matrix:
         include:
+          - { python-version: "3.13", os: ubuntu-latest }
+          - { python-version: "3.13", os: windows-latest }
+          - { python-version: "3.13", os: macos-latest }
+          - { python-version: "3.12", os: ubuntu-latest }
+          - { python-version: "3.11", os: ubuntu-latest }
           - { python-version: "3.10", os: ubuntu-latest }
-          - { python-version: "3.10", os: windows-latest }
-          - { python-version: "3.10", os: macos-latest }
           - { python-version: "3.9", os: ubuntu-latest }
-          - { python-version: "3.8", os: ubuntu-latest }
-          - { python-version: "3.7", os: ubuntu-latest }
     name: Python ${{ matrix.python-version }} (${{ matrix.os }})
     runs-on: ${{ matrix.os }}
     steps:

.github/workflows/update-instance.yml

@@ -21,10 +21,10 @@ jobs:
           repository: "cjolowicz/${{ env.PROJECT }}"
           path: ${{ env.PROJECT }}
           token: ${{ secrets.X_GITHUB_TOKEN }}
-      - name: Set up Python 3.10
+      - name: Set up Python 3.13
         uses: actions/[email protected]
         with:
-          python-version: "3.10"
+          python-version: "3.13"
       - name: Install cutty
         working-directory: ${{ env.TEMPLATE }}
         run: |

CONTRIBUTING.md

@@ -32,7 +32,7 @@ Request features on the [Issue Tracker].
 
 ## How to set up your development environment
 
-You need Python 3.7+ and the following tools:
+You need Python 3.9+ and the following tools:
 
 - [Cookiecutter]
 - [Poetry]

README.md

@@ -78,7 +78,7 @@ cookiecutter gh:cjolowicz/cookiecutter-hypermodern-python --checkout=2022.6.3
 - Generate command-line reference with [sphinx-click]
 - Manage project labels with [GitHub Labeler]
 
-The template supports Python 3.7, 3.8, 3.9, and 3.10.
+The template supports Python 3.9, 3.10, 3.11, 3.12, and 3.13.
 
 [autodoc]: https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html
 [bandit]: https://github.com/PyCQA/bandit

docs/conf.py

@@ -1,10 +1,11 @@
 """Sphinx configuration."""
+
 from datetime import datetime
 
 
 project = "Hypermodern Python Cookiecutter"
 author = "Claudio Jolowicz"
-copyright = f"{datetime.now().year}, {author}"
+copyright = f"{datetime.now().year}, {author}"  # noqa: A001
 extensions = ["sphinx.ext.intersphinx", "myst_parser"]
 intersphinx_mapping = {"mypy": ("https://mypy.readthedocs.io/en/stable/", None)}
 language = "en"
@@ -21,6 +22,7 @@
     "https://github.com/cjolowicz/cookiecutter-hypermodern-python/releases/tag/",
     "https://cookiecutter-hypermodern-python.readthedocs.io",
     "https://badgen.net/badge/status/alpha/d8624d",
+    "https://www.gnu.org/software/bash/"
 ]
 myst_enable_extensions = [
     "colon_fence",

docs/guide.md

@@ -98,15 +98,15 @@ python -VV
 py -VV
 ```
 
-Both of these commands should display the latest Python version, 3.10.
+Both of these commands should display the latest Python version, 3.13.
 
 For local testing with multiple Python versions,
-repeat these steps for the latest bugfix releases of Python 3.7+,
+repeat these steps for the latest bugfix releases of Python 3.9+,
 with the following changes:
 
 - Do _not_ enable the option to add Python to the `PATH` environment variable.
 - `py -VV` and `python -VV` should still display the version of the latest stable release.
-- `py -X.Y -VV` (e.g. `py -3.7 -VV`) should display the exact version you just installed.
+- `py -X.Y -VV` (e.g. `py -3.9 -VV`) should display the exact version you just installed.
 
 Note that binary installers are not provided for security releases.
 
@@ -137,26 +137,27 @@ Install the Python build dependencies for your platform,
 using one of the commands listed in the [official instructions][pyenv wiki].
 
 Install the latest point release of every supported Python version.
-This project template supports Python 3.7, 3.8, 3.9, and 3.10.
+This project template supports Python 3.9, 3.10, 3.11, 3.12, and 3.13.
 
 ```console
-$ pyenv install 3.7.12
-$ pyenv install 3.8.12
-$ pyenv install 3.9.10
-$ pyenv install 3.10.2
+$ pyenv install 3.9.13
+$ pyenv install 3.10.11
+$ pyenv install 3.11.8
+$ pyenv install 3.12.10
+$ pyenv install 3.13.3
 ```
 
 After creating your project (see [below](creating-a-project)),
 you can make these Python versions accessible in the project directory,
 using the following command:
 
 ```console
-$ pyenv local 3.10.2 3.9.10 3.8.12 3.7.12
+$ pyenv local 3.13.3 3.12.10 3.11.8 3.10.11 3.9.13
 ```
 
 The first version listed is the one used when you type plain `python`.
 Every version can be used by invoking `python<major.minor>`.
-For example, use `python3.7` to invoke Python 3.7.
+For example, use `python3.9` to invoke Python 3.9.
 
 ### Requirements
 
@@ -182,15 +183,10 @@ Install [Cookiecutter] using pipx:
 $ pipx install cookiecutter
 ```
 
-Install [Poetry] by downloading and running [install-poetry.py]:
-
-```console
-$ python install-poetry.py
-```
-
-Install [Nox] and [nox-poetry] using pipx:
+Install [Poetry], [Nox], and [nox-poetry] using pipx:
 
 ```console
+$ pipx install poetry
 $ pipx install nox
 $ pipx inject nox nox-poetry
 ```
@@ -981,14 +977,15 @@ for every Python version supported by your project,
 and easily switch between them:
 
 ```console
-$ poetry env use 3.7
-$ poetry env use 3.8
 $ poetry env use 3.9
 $ poetry env use 3.10
+$ poetry env use 3.11
+$ poetry env use 3.12
+$ poetry env use 3.13
 ```
 
 Only one Poetry environment can be active at any time.
-Note that `3.10` comes last,
+Note that `3.13` comes last,
 to ensure that the current Python release is the active environment.
 Install your package with `poetry install` into each environment after creating it.
 
@@ -1161,7 +1158,7 @@ For example, the following may be more practical during development
 (this will only run tests and type checks, on the current Python release):
 
 ```console
-$ nox -p 3.10 -rs tests mypy
+$ nox -p 3.13 -rs tests mypy
 ```
 
 Many sessions accept additional options after `--` separator.
@@ -1187,39 +1184,39 @@ The following table gives an overview of the available Nox sessions:
   - Default
 - - [coverage](the-coverage-session)
   - Report coverage with [Coverage.py]
-  - `3.10`
+  - `3.13`
   - (✓)
 - - [docs](the-docs-session)
   - Build and serve [Sphinx] documentation
-  - `3.10`
+  - `3.13`
   -
 - - [docs-build](the-docs-build-session)
   - Build [Sphinx] documentation
-  - `3.10`
+  - `3.13`
   - ✓
 - - [mypy](the-mypy-session)
   - Type-check with [mypy]
-  - `3.7` … `3.10`
+  - `3.9` … `3.13`
   - ✓
 - - [pre-commit](the-pre-commit-session)
   - Lint with [pre-commit]
-  - `3.10`
+  - `3.13`
   - ✓
 - - [safety](the-safety-session)
   - Scan dependencies with [Safety]
-  - `3.10`
+  - `3.13`
   - ✓
 - - [tests](the-tests-session)
   - Run tests with [pytest]
-  - `3.7` … `3.10`
+  - `3.9` … `3.13`
   - ✓
 - - [typeguard](the-typeguard-session)
   - Type-check with [Typeguard]
-  - `3.10`
+  - `3.13`
   - ✓
 - - [xdoctest](the-xdoctest-session)
   - Run examples with [xdoctest]
-  - `3.7` … `3.10`
+  - `3.9` … `3.13`
   - ✓
 
 :::
@@ -1279,7 +1276,7 @@ For example, the following command runs mypy
 using the current stable release of Python:
 
 ```console
-$ nox --session=mypy --python=3.10
+$ nox --session=mypy --python=3.13
 ```
 
 Use the separator `--` to pass additional options and arguments to `mypy`.
@@ -1353,7 +1350,7 @@ For example, the following command runs the test suite
 using the current stable release of Python:
 
 ```console
-$ nox --session=tests --python=3.10
+$ nox --session=tests --python=3.13
 ```
 
 Use the separator `--` to pass additional options to `pytest`.
@@ -1480,7 +1477,7 @@ For example, the following command runs the examples
 using the current stable release of Python:
 
 ```console
-$ nox --session=xdoctest --python=3.10
+$ nox --session=xdoctest --python=3.13
 ```
 
 By default, the Nox session uses the `all` subcommand to run all examples.
@@ -2274,28 +2271,28 @@ as shown in the table below:
   - Python versions
 - - [pre-commit](the-pre-commit-session)
   - Ubuntu
-  - 3.10
+  - 3.13
 - - [safety](the-safety-session)
   - Ubuntu
-  - 3.10
+  - 3.13
 - - [mypy](the-mypy-session)
   - Ubuntu
-  - 3.10, 3.9, 3.8, 3.7
+  - 3.13, 3.12, 3.11, 3.10, 3.9
 - - [tests](the-tests-session)
   - Ubuntu
-  - 3.10, 3.9, 3.8, 3.7
+  - 3.13, 3.12, 3.11, 3.10, 3.9
 - - [tests](the-tests-session)
   - Windows
-  - 3.10
+  - 3.13
 - - [tests](the-tests-session)
   - macOS
-  - 3.10
+  - 3.13
 - - [coverage](the-coverage-session)
   - Ubuntu
-  - 3.10
+  - 3.13
 - - [docs-build](the-docs-build-session)
   - Ubuntu
-  - 3.10
+  - 3.13
 
 :::
 
@@ -2625,7 +2622,7 @@ You can also read the articles on [this blog][hypermodern python blog].
 [flake8-bandit]: https://github.com/tylerwince/flake8-bandit
 [flake8-bugbear codes]: https://github.com/PyCQA/flake8-bugbear#list-of-warnings
 [flake8-bugbear]: https://github.com/PyCQA/flake8-bugbear
-[flake8-docstrings]: https://gitlab.com/pycqa/flake8-docstrings
+[flake8-docstrings]: https://github.com/pycqa/flake8-docstrings
 [flake8-rst-docstrings codes]: https://github.com/peterjc/flake8-rst-docstrings#flake8-validation-codes
 [flake8-rst-docstrings]: https://github.com/peterjc/flake8-rst-docstrings
 [flake8]: http://flake8.pycqa.org
@@ -2653,7 +2650,6 @@ You can also read the articles on [this blog][hypermodern python blog].
 [hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python
 [hypermodern python]: https://medium.com/@cjolowicz/hypermodern-python-d44485d9d769
 [import hook]: https://docs.python.org/3/reference/import.html#import-hooks
-[install-poetry.py]: https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py
 [isort black profile]: https://pycqa.github.io/isort/docs/configuration/black_compatibility.html
 [isort force_single_line]: https://pycqa.github.io/isort/docs/configuration/options.html#force-single-line
 [isort lines_after_imports]: https://pycqa.github.io/isort/docs/configuration/options.html#lines-after-imports
@@ -2672,10 +2668,10 @@ You can also read the articles on [this blog][hypermodern python blog].
 [nox]: https://nox.thea.codes/
 [package metadata]: https://packaging.python.org/en/latest/specifications/core-metadata/
 [pep 257]: http://www.python.org/dev/peps/pep-0257/
-[pep 440]: https://www.python.org/dev/peps/pep-0440/
-[pep 517]: https://www.python.org/dev/peps/pep-0517/
-[pep 518]: https://www.python.org/dev/peps/pep-0518/
-[pep 561]: https://www.python.org/dev/peps/pep-0561/
+[pep 440]: https://peps.python.org/pep-0440/
+[pep 517]: https://peps.python.org/pep-0517/
+[pep 518]: https://peps.python.org/pep-0518/
+[pep 561]: https://peps.python.org/pep-0561/
 [pep 8]: http://www.python.org/dev/peps/pep-0008/
 [pep8-naming codes]: https://github.com/pycqa/pep8-naming#pep-8-naming-conventions
 [pep8-naming]: https://github.com/pycqa/pep8-naming
@@ -2711,7 +2707,7 @@ You can also read the articles on [this blog][hypermodern python blog].
 [pypa/gh-action-pypi-publish]: https://github.com/pypa/gh-action-pypi-publish
 [pypi]: https://pypi.org/
 [pyproject.toml]: https://python-poetry.org/docs/pyproject/
-[pytest layout]: https://docs.pytest.org/en/latest/explanation/goodpractices.html#choosing-a-test-layout-import-rules
+[pytest layout]: https://docs.pytest.org/en/latest/explanation/goodpractices.html#choosing-a-test-layout
 [pytest]: https://docs.pytest.org/en/latest/
 [python build]: https://python-poetry.org/docs/cli/#build
 [python package]: https://docs.python.org/3/tutorial/modules.html#packages
@@ -2746,6 +2742,6 @@ You can also read the articles on [this blog][hypermodern python blog].
 [versions and constraints]: https://python-poetry.org/docs/dependency-specification/
 [virtual environment]: https://docs.python.org/3/tutorial/venv.html
 [virtualenv]: https://virtualenv.pypa.io/
-[wheel]: https://www.python.org/dev/peps/pep-0427/
+[wheel]: https://peps.python.org/pep-0427/
 [xdoctest]: https://github.com/Erotemic/xdoctest
 [yaml]: https://yaml.org/

docs/quickstart.md

@@ -8,22 +8,17 @@ Install [Cookiecutter]:
 $ pipx install cookiecutter
 ```
 
-Install [Poetry] by downloading and running [install-poetry.py]:
-
-```console
-$ python install-poetry.py
-```
-
-Install [Nox] and [nox-poetry]:
+Install [Poetry], [Nox], and [nox-poetry]:
 
 ```console
+$ pipx install poetry
 $ pipx install nox
 $ pipx inject nox nox-poetry
 ```
 
 [pipx] is preferred, but you can also install with `pip install --user`.
 
-It is recommended to set up Python 3.7, 3.8, 3.9, 3.10 using [pyenv].
+It is recommended to set up Python 3.9, 3.10, 3.11, 3.12, and 3.13 using [pyenv].
 
 ## Creating a project
 
@@ -159,7 +154,6 @@ by applying labels to them, like this:
 [codecov]: https://codecov.io/
 [cookiecutter]: https://github.com/audreyr/cookiecutter
 [github]: https://github.com/
-[install-poetry.py]: https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py
 [nox]: https://nox.thea.codes/
 [nox-poetry]: https://nox-poetry.readthedocs.io/
 [pipx]: https://pipxproject.github.io/pipx/