Merge tag '2027.0.0a6' into led-buffer

Author: auscompgeek

.github/workflows/dist.yml

@@ -112,9 +112,9 @@ jobs:
       max-parallel: ${{ fromJSON(needs.setup_concurrency.outputs.max-parallel).v }}
       fail-fast: true
       matrix:
-        os: ["ubuntu-22.04", "ubuntu-22.04-arm", "macos-14", "windows-2022"]
+        os: ["ubuntu-24.04", "ubuntu-24.04-arm", "macos-14", "windows-2022"]
         include:
-        - os: ubuntu-22.04-arm
+        - os: ubuntu-24.04-arm
           container: python:3.13-bookworm
 
     container: ${{ matrix.container }}
@@ -125,7 +125,7 @@ jobs:
         fetch-depth: 0
 
     - name: Install python
-      if: matrix.os != 'ubuntu-22.04-arm'
+      if: matrix.os != 'ubuntu-24.04-arm'
       uses: actions/setup-python@v5
       with:
         python-version: '3.13'
@@ -157,27 +157,26 @@ jobs:
       fail-fast: true
       matrix:
         os:
-        - "ubuntu-22.04"
+        - "ubuntu-24.04"
         - "macos-15-intel" # x86_64
         - "macos-14" # arm64
         - "windows-2022"
         python_version:
-        - '3.10'
         - '3.11'
         - '3.12'
         - '3.13'
         - '3.14'
         include:
-        - os: ubuntu-22.04-arm
+        - os: ubuntu-24.04-arm
           python_version: '3.11'
           container: python:3.11-bookworm
-        - os: ubuntu-22.04-arm
+        - os: ubuntu-24.04-arm
           python_version: '3.12'
           container: python:3.12-bookworm
-        - os: ubuntu-22.04-arm
+        - os: ubuntu-24.04-arm
           python_version: '3.13'
           container: python:3.13-bookworm
-        - os: ubuntu-22.04-arm
+        - os: ubuntu-24.04-arm
           python_version: '3.14'
           container: python:3.14-bookworm
 
@@ -189,7 +188,7 @@ jobs:
         fetch-depth: 0
 
     - name: Install python
-      if: matrix.os != 'ubuntu-22.04-arm'
+      if: matrix.os != 'ubuntu-24.04-arm'
       uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python_version }}
@@ -212,7 +211,7 @@ jobs:
 
     - name: Install libgl
       run: apt-get update && apt-get install -y libgl1
-      if: matrix.os == 'ubuntu-22.04-arm'
+      if: matrix.os == 'ubuntu-24.04-arm'
 
     - name: Setup MSVC
       uses: bus1/cabuild/action/msdevshell@e22aba57d6e74891d059d66501b6b5aed8123c4d  # v1
@@ -262,6 +261,10 @@ jobs:
       run: |
         python -m devtools ci install-test-pure-wheels
 
+    - name: Test examples
+      run: |
+        python -m devtools test-examples
+
     - name: Ensure all headers are accounted for
       run: |
         python -m devtools ci scan-headers
@@ -276,7 +279,7 @@ jobs:
         path: dist
 
   #
-  # Build roboRIO/raspbian wheels
+  # Build robot/raspbian wheels
   #
 
   cross-other:
@@ -286,10 +289,8 @@ jobs:
       max-parallel: ${{ fromJSON(needs.setup_concurrency.outputs.max-parallel).v }}
       matrix:
         os:
-        - container: wpilib/roborio-cross-ubuntu:2026-22.04-py314
-          name: roborio
-        - container: wpilib/raspbian-cross-ubuntu:2026-bookworm-22.04-py314
-          name: raspbian
+        - container: wpilib/systemcore-cross-ubuntu:2026-24.04-py314
+          name: systemcore
 
     container:
       image: "${{ matrix.os.container }}"
@@ -300,7 +301,7 @@ jobs:
         fetch-depth: 0
 
     - name: Setup cross environment for meson
-      uses: robotpy/build-actions/setup-cross-meson@semiwrap
+      uses: robotpy/build-actions/setup-cross-meson@v2027
 
     - name: Install deps
       shell: bash
@@ -324,22 +325,9 @@ jobs:
       max-parallel: ${{ fromJSON(needs.setup_concurrency.outputs.max-parallel).v }}
       matrix:
         os:
-        - container: wpilib/roborio-cross-ubuntu:2026-22.04-py314
-          name: roborio
-          base: roborio
-
-        - container: wpilib/raspbian-cross-ubuntu:2026-bookworm-22.04-py311
-          name: raspbian-py311
-          base: raspbian
-        - container: wpilib/raspbian-cross-ubuntu:2026-bookworm-22.04-py312
-          name: raspbian-py312
-          base: raspbian
-        - container: wpilib/raspbian-cross-ubuntu:2026-bookworm-22.04-py313
-          name: raspbian-py313
-          base: raspbian
-        - container: wpilib/raspbian-cross-ubuntu:2026-bookworm-22.04-py314
-          name: raspbian-py314
-          base: raspbian
+        - container: wpilib/systemcore-cross-ubuntu:2026-24.04-py314
+          name: systemcore
+          base: systemcore
 
     container:
       image: "${{ matrix.os.container }}"
@@ -355,7 +343,7 @@ jobs:
         path: dist-other
 
     - name: Setup cross environment for meson
-      uses: robotpy/build-actions/setup-cross-meson@semiwrap
+      uses: robotpy/build-actions/setup-cross-meson@v2027
 
     - run: apt-get update
     - name: Setup ccache
@@ -401,7 +389,7 @@ jobs:
         verify-metadata: false
         user: ${{ secrets.WPI_ARTIFACTORY_USERNAME }}
         password: ${{ secrets.WPI_ARTIFACTORY_TOKEN }}
-        repository-url: https://wpilib.jfrog.io/artifactory/api/pypi/wpilib-python-release-2026-local
+        repository-url: https://wpilib.jfrog.io/artifactory/api/pypi/wpilib-python-release-2027-local
 
   publish-rpyrepo-other:
     runs-on: ubuntu-latest
@@ -421,7 +409,7 @@ jobs:
         skip-existing: true     # native packages can be uploaded multiple times
         user: ${{ secrets.WPI_ARTIFACTORY_USERNAME }}
         password: ${{ secrets.WPI_ARTIFACTORY_TOKEN }}
-        repository-url: https://wpilib.jfrog.io/artifactory/api/pypi/wpilib-python-release-2026-local
+        repository-url: https://wpilib.jfrog.io/artifactory/api/pypi/wpilib-python-release-2027-local
 
   publish-pypi:
     runs-on: ubuntu-latest

.readthedocs.yml

@@ -4,13 +4,13 @@ sphinx:
   configuration: docs/conf.py
 
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
-    python: "3.11"
+    python: "3.14"
   jobs:
     post_install:
     - python -m robotpy_sphinx.download_and_install robotpy mostrobotpy main dist pypi-other-Linux-X64
-    - python -m robotpy_sphinx.download_and_install robotpy mostrobotpy main dist pypi-meson-Linux-X64-3.11
+    - python -m robotpy_sphinx.download_and_install robotpy mostrobotpy main dist pypi-meson-Linux-X64-3.14
     - python -m robotpy_sphinx.download_and_install robotpy mostrobotpy main dist pypi-pure
     post_build:
     - mkdir --parents _readthedocs/htmlzip

devtools/__main__.py

@@ -6,6 +6,7 @@
 
 from .ctx import Context
 from . import ci
+from . import examples
 from . import update_pyproject
 
 #
@@ -33,6 +34,7 @@ def main(ctx: click.Context, verbose: bool):
 
 
 main.add_command(ci.ci)
+main.add_command(examples.test_examples)
 main.add_command(update_pyproject.update_pyproject)
 
 

devtools/config.py

@@ -24,6 +24,10 @@ class Parameters:
     wpilib_bin_version: str
     wpilib_bin_url: str
 
+    mrclib_bin_version: str
+    mrclib_bin_url: str
+    mrclib_artifacts: T.Set[str]
+
     #: renames [project.entry-points.KEY*] to [project.entry-points.VALUE]
     entrypoints: T.Dict[str, str]
 

devtools/examples.py

@@ -0,0 +1,105 @@
+import dataclasses
+import os
+import pathlib
+import subprocess
+import sys
+import typing as T
+
+import click
+import tomlkit
+
+from .util import parse_input, run_cmd
+
+
+def _validate_example_list(root: pathlib.Path, expected_dirs: T.Sequence[str]) -> None:
+    expected = sorted(f"{name}/robot.py" for name in expected_dirs)
+    actual = sorted(p.relative_to(root).as_posix() for p in root.rglob("robot.py"))
+
+    if expected == actual:
+        return
+
+    missing = sorted(set(expected) - set(actual))
+    extra = sorted(set(actual) - set(expected))
+    for path in missing:
+        print(f"Missing: {path}")
+    for path in extra:
+        print(f"Extra: {path}")
+
+    if not os.environ.get("FORCE_ANYWAYS"):
+        print("ERROR: Not every robot.py file is in the list of tests!")
+        sys.exit(1)
+
+
+@dataclasses.dataclass
+class ExamplesTests:
+    base: T.List[str]
+    ignored: T.List[str]
+
+
+@dataclasses.dataclass
+class ExamplesConfig:
+    tests: ExamplesTests
+
+
+def _load_tests_config(config_path: pathlib.Path) -> ExamplesConfig:
+    try:
+        data = tomlkit.parse(config_path.read_text(encoding="utf-8"))
+    except FileNotFoundError:
+        raise click.ClickException(f"Missing tests config: {config_path}")
+    except Exception as exc:
+        raise click.ClickException(f"Invalid tests config: {config_path}: {exc}")
+
+    try:
+        return parse_input(data, ExamplesConfig, config_path)
+    except Exception as exc:
+        raise click.ClickException(str(exc))
+
+
+@click.command(name="test-examples")
+@click.argument("test_name", required=False)
+@click.option("-x", "--exitfirst", is_flag=True, help="Exit on first failed test.")
+def test_examples(test_name: str | None, exitfirst: bool) -> None:
+    """Run tests on robot examples."""
+    root = pathlib.Path(__file__).parent.parent / "examples" / "robot"
+    config_path = root / "examples.toml"
+
+    cfg = _load_tests_config(config_path)
+    base_tests = cfg.tests.base
+    ignored_tests = cfg.tests.ignored
+
+    every_tests = [*base_tests, *ignored_tests]
+    _validate_example_list(root, every_tests)
+
+    tests_to_run = base_tests
+    if test_name:
+        if test_name not in every_tests:
+            raise click.BadParameter(f"unknown example {test_name}")
+        tests_to_run = [test_name]
+
+    failed_tests = []
+
+    for example_name in tests_to_run:
+        test_dir = root / example_name
+        print(test_dir.resolve())
+        try:
+            run_cmd(
+                sys.executable,
+                "-m",
+                "robotpy",
+                "test",
+                "--builtin",
+                cwd=test_dir,
+            )
+        except subprocess.CalledProcessError:
+            print(f"Test in {test_dir.resolve()} failed")
+            failed_tests.append(example_name)
+            if exitfirst:
+                break
+
+    if failed_tests:
+        print("Failed tests:")
+        for name in failed_tests:
+            print(f"- {name}")
+        sys.exit(1)
+
+    print("All tests successful!")

devtools/subproject.py

@@ -2,10 +2,10 @@
 import shutil
 import sys
 import tempfile
+import tomllib
 import typing as T
 
 from packaging.requirements import Requirement
-import tomli
 
 from .config import SubprojectConfig
 from .util import run_cmd
@@ -24,9 +24,9 @@ def __init__(
         self.pyproject_path = self.path / "pyproject.toml"
         self.name = path.name
 
-        # Use tomli here because it's faster and we just need the data
+        # Use tomllib here because it's faster and we just need the data
         with open(self.pyproject_path, "rb") as fp:
-            self.pyproject_data = tomli.load(fp)
+            self.pyproject_data = tomllib.load(fp)
 
         self.build_requires = [
             Requirement(req) for req in self.pyproject_data["build-system"]["requires"]
@@ -175,7 +175,9 @@ def build_wheel(
     }
 
     def _fix_wheel_name(self, wheel_path: pathlib.Path) -> str:
-        if sys.platform == "linux":
+        if self.ctx.is_robot:
+            name = wheel_path.name
+        elif sys.platform == "linux":
             name = self._fix_linux_wheel_name(wheel_path)
         else:
             name = wheel_path.name