Refactor CPU instruction tests and enhance development setup

.devcontainer/devcontainer.json

@@ -1,51 +1,52 @@
 {
-  "image": "mcr.microsoft.com/devcontainers/base:debian",
+  "name": "Python",
+  "image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
   "features": {
-    "ghcr.io/devcontainers/features/python:1": {
-      "installTools": true,
-      "version": "3.12"
-    },
-    "ghcr.io/devcontainers/features/github-cli:1": {
-      "installDirectlyFromGitHubRelease": true,
-      "version": "latest"
-    },
-    "ghcr.io/devcontainers-contrib/features/flake8:2": {
-      "version": "latest",
-      "plugins": "flake8-annotations flake8-annotations-complexity flake8-bugbear flake8-deprecated flake8-docstrings flake8-isort flake8-print flake8-pylint flake8-builtins flake8-pytest-style flake8-todo"
-    },
-    "ghcr.io/devcontainers-contrib/features/yamllint:2": {
-      "version": "latest"
-    },
-    "ghcr.io/devcontainers-contrib/features/tox:2": {
-      "version": "latest"
-    },
-    "ghcr.io/hspaans/devcontainer-features/pytest:1": {
-      "version": "latest"
-    }
+      "ghcr.io/devcontainers/features/github-cli:1": {},
+      "ghcr.io/devcontainers-extra/features/yamllint:2": {},
+      "ghcr.io/devcontainers-extra/features/tox:2": {},
+      "ghcr.io/hspaans/devcontainer-features/pyupgrade:2": {},
+      "ghcr.io/hspaans/devcontainer-features/pymarkdownlnt:2": {},
+      "ghcr.io/hspaans/devcontainer-features/rstcheck:2": {},
+      "ghcr.io/devcontainers-extra/features/flake8:2": {
+        "version": "latest",
+        "plugins": "flake8-black flake8-bugbear flake8-deprecated flake8-docstrings flake8-typing-imports flake8-isort flake8-print flake8-pylint flake8-builtins flake8-pytest-style"
+      }
   },
   "customizations": {
-    "vscode": {
-      "extensions": [
-        "EditorConfig.EditorConfig",
-        "github.vscode-github-actions",
-        "ms-python.autopep8",
-        "ms-python.flake8",
-        "ms-python.vscode-pylance",
-        "ms-python.python"
-      ],
-      "[python]": {
-        "editor.defaultFormatter": "ms-python.autopep8",
-        "editor.formatOnSave": true
-      },
-      "settings": {
-        "python.formatting.provider": "flake8",
-        "python.testing.pytestArgs": [
-          "tests"
-        ],
-        "python.testing.unittestEnabled": false,
-        "python.testing.pytestEnabled": true,
-        "python.analysis.inlayHints.pytestParameters": true
+      "vscode": {
+          "extensions": [
+            "EditorConfig.EditorConfig",
+            "github.vscode-github-actions",
+            "ms-python.vscode-pylance",
+            "ms-python.python",
+            "ms-python.autopep8",
+            "ms-python.flake8",
+            "ms-python.black-formatter"
+          ],
+          "[python]": {
+              "editor.defaultFormatter": "ms-python.autopep8",
+              "editor.formatOnSave": true
+          },
+          "settings": {
+              "flake8.importStrategy": "fromEnvironment",
+              "python.formatting.provider": "flake8",
+              "python.testing.pytestArgs": [
+                  "tests"
+              ],
+              "python.testing.unittestEnabled": false,
+              "python.testing.pytestEnabled": true,
+              "python.analysis.inlayHints.pytestParameters": true
+          },
+          "mcp": {
+              "servers": {
+                  "github": {
+                      "type": "http",
+                      "url": "https://api.githubcopilot.com/mcp/"
+                  }
+              }
+          }
       }
-    }
-  }
+  },
+  "postCreateCommand": "python -m pip install --upgrade pip && python -m pip install --user -e . --group dev"
 }

.flake8

@@ -0,0 +1,12 @@
+[flake8]
+max-line-length = 127
+ignore =
+    E221,
+    E241,
+    F401,
+    E501,
+    PLC301,
+    PLC302,
+    PLR913,
+    PLR917,
+    PLW511,

.github/workflows/ci.yml

@@ -14,19 +14,15 @@ permissions:
 
 jobs:
   tox:
-    name: Test on Python ${{ matrix.py }} - ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}-latest
+    name: Test on Python ${{ matrix.py }}
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        os:
-          - Ubuntu
         py:
+          - "3.13"
           - "3.12"
           - "3.11"
-          - "3.10"
-          - "3.9"
-          - "3.8"
     steps:
       - name: Setup python for test ${{ matrix.py }}
         uses: actions/setup-python@v6
@@ -37,7 +33,9 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Install tox-gh
-        run: python -m pip install tox-gh
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install tox-gh
 
       - name: Setup test suite
         run: tox r -vv --notest

.github/workflows/codeql.yml

@@ -40,6 +40,14 @@ jobs:
       actions: read
       contents: read
 
+    # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift'
+    # Use `c-cpp` to analyze code written in C, C++ or both
+    # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+    # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+    # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+    # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+    # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+    # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
     strategy:
       fail-fast: false
       matrix:
@@ -48,14 +56,7 @@ jobs:
             build-mode: none
           - language: python
             build-mode: none
-          # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift'
-          # Use `c-cpp` to analyze code written in C, C++ or both
-          # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
-          # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
-          # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
-          # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
-          # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
-          # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4

.gitignore

@@ -70,6 +70,7 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+_build/
 
 # PyBuilder
 target/

.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+    "flake8.importStrategy": "fromEnvironment",
+    "python.testing.pytestEnabled": true
+}

.vscode/tasks.json

@@ -0,0 +1,30 @@
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Run Tox",
+      "type": "shell",
+      "command": "tox",
+      "group": {
+        "kind": "test",
+        "isDefault": true
+      }
+    },
+    {
+      "label": "Run Sphinx",
+      "type": "shell",
+      "command": "sphinx-build -b html docs/source docs/build/html",
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      }
+    },
+    {
+      "label": "Run documentation webserver",
+      "type": "shell",
+      "command": "sphinx-autobuild docs _build"
+    },
+  ]
+}

.yamllint.yml

@@ -10,3 +10,12 @@ rules:
     level: error
   line-length: disable
   truthy: disable
+
+ignore:
+  - .tox/
+  - .venv/
+  - .eggs/
+  - .git/
+  - .mypy_cache/
+  - .pytest_cache/
+  - .coverage