Update Python tooling (#616)

https://docs.astral.sh/ruff/faq/t

Author: sonnyp

.github/workflows/build-hardware-controller.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
           cache: 'poetry'
           cache-dependency-path: |
             device-backend/control/poetry.lock
@@ -48,7 +48,7 @@ jobs:
         working-directory: ./device-backend/control
         run: |
           sudo apt-get install -y libcap-dev
-          poetry install --with dev --no-root
+          poetry install --with dev
 
       - name: Run checks
         working-directory: ./device-backend/control

.github/workflows/documentation-build.yml

@@ -60,7 +60,7 @@ jobs:
 
       - name: Install build dependencies
         run: |
-          poetry -C ./documentation/ install --no-root
+          poetry -C ./documentation/ install
 
       - name: Make documentation ${{ matrix.variant }}
         if: matrix.variant != 'default'

.github/workflows/documentation-deploy-beta.yml

@@ -10,11 +10,11 @@ on:
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest
 # queued. But do not cancel in-progress runs - we want these deploymeents to complete.
 concurrency:
-  group: "docs-beta-deploy"
+  group: 'docs-beta-deploy'
   cancel-in-progress: false
 
 env:
-    DESTINATION_OWNER: ${{ github.repository_owner }}
+  DESTINATION_OWNER: ${{ github.repository_owner }}
 
 defaults:
   run:
@@ -50,7 +50,7 @@ jobs:
       - name: Install build dependencies
         run: |
           sudo apt install libjpeg-dev
-          poetry -C ./documentation/ install --with imaging --no-root
+          poetry -C ./documentation/ install --with imaging
 
       - name: Set release channel
         working-directory: documentation

.github/workflows/documentation-deploy-edge.yml

@@ -20,7 +20,7 @@ permissions:
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest
 # queued. But do not cancel in-progress runs - we want these deploymeents to complete.
 concurrency:
-  group: "docs-edge-deploy"
+  group: 'docs-edge-deploy'
   cancel-in-progress: false
 
 defaults:
@@ -55,7 +55,7 @@ jobs:
       - name: Install build dependencies
         run: |
           sudo apt install libjpeg-dev
-          poetry -C ./documentation/ install --with imaging --no-root
+          poetry -C ./documentation/ install --with imaging
 
       - name: Set release channel
         working-directory: documentation

.github/workflows/documentation-deploy-stable.yml

@@ -10,11 +10,11 @@ on:
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest
 # queued. But do not cancel in-progress runs - we want these deploymeents to complete.
 concurrency:
-  group: "docs-stable-deploy"
+  group: 'docs-stable-deploy'
   cancel-in-progress: false
 
 env:
-    DESTINATION_OWNER: ${{ github.repository_owner }}
+  DESTINATION_OWNER: ${{ github.repository_owner }}
 
 defaults:
   run:
@@ -51,7 +51,7 @@ jobs:
         working-directory: documentation
         run: |
           sudo apt install libjpeg-dev
-          poetry install --with imaging --no-root
+          poetry install --with imaging
 
       - name: Build documentation
         env:

device-backend/control/.flake8

@@ -1 +1 @@
-3.9.2
+3.11.2

device-backend/control/.python-version

@@ -8,7 +8,7 @@ Each feature of the hardware is controlled by a separate process. Processes comm
 
 Please note the following particularity of Python processes
 
-> Bear in mind that each spawned process is initialized with a copy of the memory footprint of the master process. And that the constructor code (i.e. stuff inside __init__()) is executed in the master process -- only code inside run() executes in separate processes.
+> Bear in mind that each spawned process is initialized with a copy of the memory footprint of the master process. And that the constructor code (i.e. stuff inside **init**()) is executed in the master process -- only code inside run() executes in separate processes.
 
 https://stackoverflow.com/a/17220739
 
@@ -23,17 +23,20 @@ Please note that for camera we rely on the Raspberry OS packages `python3-picame
 ### Development
 
 To install all dependencies including development tooling, run:
-```
-poetry install --with dev --no-root
+
+```sh
+poetry install --with dev
 ```
 
 Then you can run the code auto-formatter on the project by running:
-```
+
+```sh
 poetry run poe fmt
 ```
 
 And you can run all checks (including code formatting and linting) by running:
-```
+
+```sh
 poetry run poe check
 ```
 
@@ -43,7 +46,7 @@ We recommand using [https://code.visualstudio.com/docs/remote/ssh](https://code.
 
 To use this project, you'll need:
 
-- Python >= 3.9
+- Python >= 3.11.2
 - Poetry 2.1.2
 
 ## Licensing

device-backend/control/README.md

@@ -23,7 +23,8 @@
 
 from loguru import logger  # for logging with multiprocessing
 
-from adafruithat.planktoscope import stepper, light, identity, display
+from adafruithat.planktoscope import stepper, light, identity
+from adafruit.planktoscope.display import Display
 from adafruithat.planktoscope.imager import mqtt as imager
 
 logger.info("Starting the PlanktoScope hardware controller!")
@@ -40,9 +41,7 @@ def handler_stop_signals(signum, _):
 
 def main():
     logger.info("Welcome!")
-    logger.info(
-        "Initialising signals handling and sanitizing the directories (step 1/4)"
-    )
+    logger.info("Initialising signals handling and sanitizing the directories (step 1/4)")
     signal.signal(signal.SIGINT, handler_stop_signals)
     signal.signal(signal.SIGTERM, handler_stop_signals)
 
@@ -90,7 +89,7 @@ def main():
         imager_thread.start()
 
     logger.info("Starting the display module (step 4/4)")
-    display = display.Display()
+    display = Display()
 
     logger.success("Looks like the controller is set up and running, have fun!")
     light.ready()

device-backend/control/adafruithat/main.py

@@ -1,17 +1,17 @@
 # Copyright (C) 2021 Romain Bazile
-# 
+#
 # This file is part of the PlanktoScope software.
-# 
+#
 # PlanktoScope is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 # the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
-# 
+#
 # PlanktoScope is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
-# 
+#
 # You should have received a copy of the GNU General Public License
 # along with PlanktoScope.  If not, see <http://www.gnu.org/licenses/>.