Merge remote-tracking branch 'origin/dev' into feature/1602-update-docs

.azure/azure-ci-build-pipeline.yaml

@@ -6,43 +6,59 @@ trigger:
 - bugfix/*
 - release/*
 
-strategy:
+parameters:
-  matrix:
+  # https://stackoverflow.com/a/70046417
-    UbuntuPython38:
+  - name: matrix
-      python.version: '3.8'
+    type: object
-      imageName: 'ubuntu-latest'
+    default:
-    UbuntuPython310:
+    - job_name: 'UbuntuPython38'
-      python.version: '3.10'
+      py: '3.8'
-      imageName: 'ubuntu-latest'
+      img: 'ubuntu-latest'
-    WindowsPython38:
+      every_time: false
-      python.version: '3.8'
+    - job_name: 'UbuntuPython310'
-      imageName: 'windows-latest'
+      py: '3.10'
-    WindowsPython310:
+      img: 'ubuntu-latest'
-      python.version: '3.10'
+      every_time: true
-      imageName: 'windows-latest'
+    - job_name: 'WindowsPython38'
-    MacOSPython38:
+      py: '3.8'
-      python.version: '3.8'
+      img: 'windows-latest'
-      imageName: 'macOS-latest'
+      every_time: false
-    MacOSPython310:
+    - job_name: 'WindowsPython310'
-      python.version: '3.10'
+      py: '3.10'
-      imageName: 'macOS-latest'
+      img: 'windows-latest'
+      every_time: false
+    - job_name: 'MacOSPython38'
+      py: '3.8'
+      img: 'macOS-latest'
+      every_time: false
+    - job_name: 'MacOSPython310'
+      py: '3.10'
+      img: 'macOS-latest'
+      every_time: false
 
-pool:
+stages:
-  vmImage: $(imageName)
+  - stage: Test
+    jobs:
+    - ${{ each item in parameters.matrix }}:
+      - job: ${{ item.job_name }}
+        pool:
+          vmImage: ${{ item.img }}
 
-steps:
+        condition: or( eq(variables['Build.Reason'], 'PullRequest'), ${{ item.every_time }} )
-- task: UsePythonVersion@0
+
+        steps:
+          - task: UsePythonVersion@0
             inputs:
-    versionSpec: '$(python.version)'
+              versionSpec: ${{ item.py }}
-  displayName: 'Use Python $(python.version)'
+            displayName: 'Use Python ${{ item.py }}'
 
-- script: |
+          - script: |
               python -m pip install pre-commit
               pre-commit install
               pre-commit run --all-files
             displayName: 'Run pre-commits'
 
-- script: |
+          - script: |
               python -m pip install --upgrade pip==23.0.1
               pip install wheel==0.38.4 --upgrade
               pip install setuptools==66 --upgrade
@@ -50,25 +66,25 @@ steps:
               pip install pytest-azurepipelines
             displayName: 'Install build dependencies'
 
-- script: |
+          - script: |
               python -m build
             displayName: 'Build PrimAITE'
 
-- script: |
+          - script: |
               PRIMAITE_WHEEL=$(ls ./dist/primaite*.whl)
               python -m pip install $PRIMAITE_WHEEL[dev]
             displayName: 'Install PrimAITE'
             condition: or(eq( variables['Agent.OS'], 'Linux' ), eq( variables['Agent.OS'], 'Darwin' ))
 
-- script: |
+          - script: |
               forfiles /p dist\ /m *.whl /c "cmd /c python -m pip install @file[dev]"
             displayName: 'Install PrimAITE'
             condition: eq( variables['Agent.OS'], 'Windows_NT' )
 
-- script: |
+          - script: |
               primaite setup
             displayName: 'Perform PrimAITE Setup'
 
-- script: |
+          - script: |
               pytest tests/
             displayName: 'Run tests'