Use Python 3.12.3

... and other changes:

- update dependencies version in pyproject.toml
- recreate the poetry.lock file
- update the Python version in:
  - the Vagrant files
  - the devcontainer file
  - the GH workflows
- update the documentation with the new Python
  version and also pin the Poetry version
- update the examples in the bug and issue templates

Author: markgreene74

.devcontainer/devcontainer.json

@@ -1,6 +1,6 @@
 {
-  "name": "python-template-3-11",
-  "image": "mcr.microsoft.com/devcontainers/python:3.11-bullseye",
+  "name": "python-template-3-12",
+  "image": "mcr.microsoft.com/devcontainers/python:3.12-bookworm",
 
   "features": {
     "ghcr.io/devcontainers/features/common-utils:2": {

.github/ISSUE_TEMPLATE/issue-bug.yml

@@ -47,15 +47,11 @@ body:
     label: Environment
     description: |
       examples:
-        - **OS**: Ubuntu 20.04
-        - **Python version**: 3.10.11
-        - **slack-bolt**: 1.17.1
-        - **slack-sdk**: 3.21.1
+        - **OS**: Ubuntu 22.04
+        - **Python version**: 3.12.3
     value: |
         - OS:
         - Python version:
-        - slack-bolt:
-        - slack-sdk:
     render: markdown
   validations:
     required: false

.github/ISSUE_TEMPLATE/issue-feature.yml

@@ -30,8 +30,8 @@ body:
     label: Environment
     description: |
       examples:
-        - **OS**: Ubuntu 20.04
-        - **Python version**: 3.10.11
+        - **OS**: Ubuntu 22.04
+        - **Python version**: 3.12.3
     value: |
         - OS:
         - Python version:

.github/workflows/python-run-tests.yml

@@ -1,7 +1,7 @@
 # This workflow will install Python dependencies, run tests and lint with a single version of Python
 # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
 
-name: "Run tests and lint (Python 3.11)"
+name: "Run tests and lint (Python 3.12)"
 
 on:
   push:
@@ -14,7 +14,7 @@ permissions:
   contents: read
 
 env:
-  POETRY_VERSION: 1.7.0
+  POETRY_VERSION: 1.8.3
   POETRY_HOME: /opt/poetry
 
 jobs:
@@ -24,10 +24,10 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - name: Set up Python 3.11
+    - name: Set up Python 3.12
       uses: actions/setup-python@v4
       with:
-        python-version: "3.11"
+        python-version: "3.12"
     - name: Cache pip dependencies
       id: cache-pip
       uses: actions/cache@v3

README.md

@@ -1,6 +1,6 @@
-# markgreene74/python-template [![Run tests and lint (Python 3.11)](https://github.com/markgreene74/python-template/actions/workflows/python-run-tests.yml/badge.svg?branch=main)](https://github.com/markgreene74/python-template/actions/workflows/python-run-tests.yml)
+# markgreene74/python-template [![Run tests and lint (Python 3.12)](https://github.com/markgreene74/python-template/actions/workflows/python-run-tests.yml/badge.svg?branch=main)](https://github.com/markgreene74/python-template/actions/workflows/python-run-tests.yml)
 
-Simple template for Python `3.11` with `pyenv`/`pyenv-virtualenv` and `poetry`.
+Simple template for Python `3.12` with `pyenv`/`pyenv-virtualenv` and `poetry`.
 
 - [quickstart](#quickstart)
 - [pyenv/pyenv-virtualenv](#pyenvpyenv-virtualenv)
@@ -20,17 +20,17 @@ Simple template for Python `3.11` with `pyenv`/`pyenv-virtualenv` and `poetry`.
 TODO
 - make sure `pyenv` is installed
 - make sure `pyenv-virtualenv` is installed
-- install python `3.11`, for example `3.11.6`
+- install python `3.12`, for example `3.12.3`
   ```bash
-  pyenv install 3.11.6
+  pyenv install 3.12.3
   ```
 - create a virtual environment
   ```bash
-  pyenv virtualenv 3.11.6 python-template-3-11
+  pyenv virtualenv 3.12.3 python-template-3-12
   ```
 - activate the virtual environment
   ```bash
-  pyenv activate python-template-3-11
+  pyenv activate python-template-3-12
   ```
 - make sure `pip` and `setuptools` are up-to-date
   ```bash
@@ -41,7 +41,7 @@ TODO
 
 - install poetry
   ```bash
-  pip install --upgrade poetry
+  pip install --upgrade poetry==1.8.3
   ```
 - install the application runtime dependencies
   ```bash

poetry.lock

@@ -1,22 +1,22 @@
 [tool.poetry]
 name = "python-template"
-version = "0.1.0"
-description = "A simple template for Python >=3.11"
+version = "0.2.0"
+description = "A simple template for Python >=3.12"
 authors = ["markgreene74 <markgreene74@users.noreply.github.com>"]
 license = "MIT"
 readme = "README.md"
 
 [tool.poetry.dependencies]
-python = "^3.11"
+python = "^3.12"
 
 
 [tool.poetry.group.test.dependencies]
-pytest = "^7.4.3"
+pytest = "^8.2.0"
 
 
 [tool.poetry.group.dev.dependencies]
-black = "^24.3.0"
-pre-commit = "^3.5.0"
+black = "^24.4.2"
+pre-commit = "^3.7.1"
 
 [build-system]
 requires = ["poetry-core"]

pyproject.toml

@@ -5,7 +5,7 @@ export VM_USER=vagrant
 export VM_USER_HOME=/home/${VM_USER}
 export PYENV_ROOT=${VM_USER_HOME}/.pyenv
 
-export PYTHON_VERSION="3.11.6"
+export PYTHON_VERSION="3.12.3"
 
 ### helper functions
 

vagrant/Vagrant-bootstrap.sh

@@ -1,4 +1,4 @@
-vm_name = "python-3-11-6"
+vm_name = "python-3-12-3"
 
 Vagrant.configure("2") do |config|
   config.vm.provider :virtualbox
@@ -16,7 +16,7 @@ Vagrant.configure("2") do |config|
   config.vm.hostname = vm_name
   config.vm.define vm_name
 
-  config.vm.post_up_message = "Debian 11 (bullseye), Python 3.11, pyenv+pyenv-virtualenv (optional), docker."
+  config.vm.post_up_message = "Debian 11 (bullseye), Python 3.12, pyenv+pyenv-virtualenv (optional), docker."
 
   config.vm.provision "base", type: "shell", path: "Vagrant-bootstrap.sh"
   config.vm.provision "custom", type: "shell", inline: "echo placeholder"