Backports release 1.12

.buildkite/runtests.yml

@@ -16,8 +16,7 @@ steps:
           version: "nightly"
           arch: "i686"
     command: |
-      julia --color=yes --project=.ci -e 'using Pkg; Pkg.instantiate()'
-      julia --color=yes --project=.ci .ci/create_sysimage_and_run_tests.jl
+      julia --color=yes --code-coverage=@ .ci/run_tests.jl
     agents:
       queue: "julia"
       os: "linux"
@@ -40,8 +39,7 @@ steps:
       - JuliaCI/julia#v1:
           version: "nightly"
     command: |
-      julia --color=yes --project=.ci --code-coverage=@ -e 'using Pkg; Pkg.instantiate()'
-      julia --color=yes --project=.ci --code-coverage=@ .ci/create_sysimage_and_run_tests.jl
+      julia --color=yes --code-coverage=@ .ci/run_tests.jl
     agents:
       queue: "julia"
       os: "linux"
@@ -55,8 +53,7 @@ steps:
       - JuliaCI/julia-coverage#v1:
           codecov: true
     command: |
-      julia --color=yes --project=.ci --code-coverage=@ -e 'using Pkg; Pkg.instantiate()'
-      julia --color=yes --project=.ci --code-coverage=@ .ci/create_sysimage_and_run_tests.jl
+      julia --color=yes --code-coverage=@ .ci/run_tests.jl
     agents:
       queue: "julia"
       os: "macos"
@@ -69,8 +66,7 @@ steps:
       - JuliaCI/julia-coverage#v1:
           codecov: true
     command: |
-      julia --color=yes --project=.ci --code-coverage=@ -e 'using Pkg; Pkg.instantiate()'
-      julia --color=yes --project=.ci --code-coverage=@ .ci/create_sysimage_and_run_tests.jl
+      julia --color=yes --code-coverage=@ .ci/run_tests.jl
     agents:
       queue: "julia"
       os: "windows"

.ci/run_tests.jl

@@ -0,0 +1,10 @@
+if haskey(ENV, "BUILDKITE")
+    ncores = Sys.CPU_THREADS
+else
+    ncores = ceil(Int, Sys.CPU_THREADS / 2)
+end
+
+proj = abspath(joinpath(@__DIR__, ".."))
+cmd = """Base.runtests(["LinearAlgebra"]; propagate_project=true, ncores=$ncores)"""
+run(addenv(`$(Base.julia_cmd()) --project=$proj --compiled-modules=existing -e $cmd`,
+    "JULIA_NUM_THREADS" => 1, "JULIA_PRUNE_OLD_LA" => true))

.github/workflows/ci.yml

@@ -21,9 +21,8 @@ jobs:
           version: 'nightly'
       - name: Generate docs
         run: |
-          julia --color=yes --project=.ci -e 'using Pkg; Pkg.instantiate()'
           julia --color=yes --project=docs -e 'using Pkg; Pkg.instantiate()'
-          julia --color=yes --project=.ci .ci/create_sysimage_and_run_docs.jl
+          julia --color=yes --project=docs --compiled-modules=existing docs/make.jl
         env:
           DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -37,10 +37,37 @@ This package performs some type piracy and is also included in the sysimage, whi
 To use a development version of this package, you can choose one of the following methods:
 
 1. **Change the UUID in the project file and load the package:**
-   This approach will produce warnings and may lead to method ambiguities between the development version and the one in the sysimage, but it can be used for basic experimentation.
+
+   Change the UUID line in `Project.toml` as
+   ```diff
+   - uuid = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
+   + uuid = "27e2e46d-f89d-539d-b4ee-838fcccc9c8e"
+   ```
+
+   Start `julia` as
+   ```console
+   JULIA_PRUNE_OLD_LA=true julia +nightly --compiled-modules=existing --project
+   ```
+   where it is assumed that one is already within the `LinearAlgebra` directory (otherwise, adjust
+   the project path accordingly). The `julia +nightly` command above assumes that `juliaup` is being used
+   to launch `julia`, but one may substitute this with the path to the julia executable.
+
+   Within the `julia` session, load the `LinearAlgebra` module after pruning the one in the sysimage. This may be done as
+   ```julia
+   include("test/prune_old_LA.jl") && using LinearAlgebra
+   ```
+
+   Note that loading the test files in the REPL will automatically carry out the pruning to ensure that the development version of the package is used in the tests.
+
+   If you are contributing to the repo using this method, it may be convenient to ignore the local changes to `Project.toml` by running
+   ```console
+   git update-index --skip-worktree Project.toml
+   ```
 
 2. **Build Julia with the custom `LinearAlgebra` commit:**
-   Modify the commit in `stdlib/LinearAlgebra.version` and build Julia.
+
+   Modify the commit in [`stdlib/LinearAlgebra.version`](https://github.com/JuliaLang/julia/blob/master/stdlib/LinearAlgebra.version) and build Julia. This requires one to push the development branch
+   to `GitHub` or an equivalent platform.
 
 3. **Build a custom sysimage with the new `LinearAlgebra`:**
    - Install `PackageCompiler`.

docs/make.jl

@@ -1,3 +1,7 @@
+withenv("JULIA_PRUNE_OLD_LA" => "true") do
+    include("../test/prune_old_LA.jl")
+end
+
 using LinearAlgebra
 using Documenter: DocMeta, makedocs, deploydocs, HTML