feat: allow setting prs for local testing (#68)

Co-authored-by: Valentin Kharin <[email protected]>

Author: tdejager

.github/workflows/CI.yml

@@ -35,13 +35,8 @@ jobs:
           cache: true
           cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}
 
-      - name: Download pixi artifacts
-        run: pixi run download-artifacts pixi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Download pixi-build-backends artifacts
-        run: pixi run download-artifacts pixi-build-backends
+      - name: Download artifacts
+        run: pixi run download-artifacts
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
@@ -74,15 +69,9 @@ jobs:
           cache: true
           cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}
 
-      - name: Download pixi artifacts
-        working-directory: ${{ env.PIXI_WORKSPACE }}
-        run: pixi run download-artifacts pixi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Download pixi-build-backends artifacts
+      - name: Download artifacts
         working-directory: ${{ env.PIXI_WORKSPACE }}
-        run: pixi run download-artifacts pixi-build-backends
+        run: pixi run download-artifacts
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
@@ -106,13 +95,8 @@ jobs:
           cache: true
           cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}
 
-      - name: Download pixi artifacts
-        run: pixi run download-artifacts pixi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Download pixi-build-backends artifacts
-        run: pixi run download-artifacts pixi-build-backends
+      - name: Download artifacts
+        run: pixi run download-artifacts
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 

README.md

@@ -5,9 +5,23 @@ This repo contains the testsuite that is used by both [Pixi] CI and [pixi-build-
 
 ## Local development
 
-First make sure that you have both the [Pixi] and [pixi-build-backends] repositories checked out locally.
+The tests can use the pre-built binaries produced by the Pixi and pixi-build-backends CI workflows. Download the latest artifacts for your platform:
 
-Then, create a `.env` file at the repository root with the paths to your checked out repositories filled in.
+```shell
+pixi run download-artifacts
+```
+
+The binaries are stored in `artifacts/`, alongside a `download-metadata.json` file that records which branch or PR each artifact originated from. When running locally the script will reuse the active `gh auth` session; if `gh` is unavailable, set `GITHUB_TOKEN` or pass `--token`. Use `--repo pixi` or `--repo pixi-build-backends` to fetch artifacts for a single project.
+
+With the artifacts in place you can run the fast subset of the tests (or any other Pixi task):
+
+```shell
+pixi run test
+```
+
+### Using local builds instead of artifacts
+
+If you prefer to use local checkouts, create a `.env` file with the paths to your repositories:
 
 ```shell
 PIXI_REPO="/path/to/pixi-repository"
@@ -17,37 +31,28 @@ PIXI_BIN_DIR="${PIXI_REPO}/target/pixi/release"
 BUILD_BACKENDS_BIN_DIR="${BUILD_BACKENDS_REPO}/target/pixi/release"
 ```
 
-You can build the executables by running the following Pixi task.
-It will also make sure that your repositories are up-to-date:
+Then build the binaries with:
 
 ```shell
 pixi run build-repos
 ```
 
-Finally, you can run the fast subset of the tests with the following task.
-Also, check out the other Pixi tasks to run more tests on your local machine:
-
-```shell
-pixi run test
-```
-
-## Testing PR combinations in CI
+## Testing PR combinations
 
 To test a combination of PRs from this testsuite with PRs from [Pixi] or [pixi-build-backends]:
 
-1. Create a `.env.ci` file with PR numbers:
+1. Create a `.env.ci` or modify your local `.env` file with PR numbers:
    ```shell
    # Test with specific PR from pixi repository
    PIXI_PR_NUMBER="123"
-   
-   # Test with specific PR from pixi-build-backends repository  
+
+   # Test with specific PR from pixi-build-backends repository
    BUILD_BACKENDS_PR_NUMBER="456"
    ```
-2. The CI will download artifacts from these PRs instead of main branch
+2. `pixi run download-artifacts` (locally or in CI) will download artifacts from these PRs instead of main
 3. **Important**: Remove `.env.ci` before merging to main (CI will prevent merge if present)
 
 This allows you to test how your testsuite changes work with specific PRs from the other repositories.
 
-
 [Pixi]: https://github.com/prefix-dev/pixi
 [pixi-build-backends]: https://github.com/prefix-dev/pixi-build-backends