Merge pull request #88 from JuliaAstro/parallel-test-runner

Switch from TestItemRunner --> ParallelTestRunner

Author: icweaver

.github/workflows/CI.yml

@@ -15,6 +15,8 @@ jobs:
   test:
     name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }}
     runs-on: ${{ matrix.os }}
+    env:
+      JULIA_NUM_THREADS: auto
     strategy:
       fail-fast: false
       matrix:

Project.toml

@@ -1,7 +1,7 @@
 name = "Photometry"
 uuid = "af68cb61-81ac-52ed-8703-edc140936be4"
-authors = ["Miles Lucas <mdlucas@hawaii.edu>"]
 version = "0.9.6"
+authors = ["Miles Lucas <mdlucas@hawaii.edu>"]
 
 [deps]
 ImageFiltering = "6a3955dd-da59-5b1f-98d4-e7296123deb5"
@@ -16,7 +16,6 @@ Rotations = "6038ab10-8711-5258-84ad-4b1120ba62dc"
 StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
 Statistics = "10745b16-79ce-11e8-11f9-7d13ad32a3b2"
 StatsBase = "2913bbd2-ae8a-5f71-8c99-4fb6c76f3a91"
-TestItems = "1c621080-faea-4a02-84b6-bbd5e436b8fe"
 Transducers = "28d57a85-8fef-5791-bfe6-a80928e7c999"
 TypedTables = "9d95f2ec-7b3d-5a63-8d20-e2491e220bb9"
 
@@ -33,7 +32,6 @@ Rotations = "0.13,1"
 StaticArrays = "0.12,1"
 Statistics = "1"
 StatsBase = "0.28,0.29,0.30,0.31,0.32,0.33, 0.34"
-TestItems = "1.0.0"
 Transducers = "0.4"
 TypedTables = "1"
 julia = "1.10"

README.md

@@ -44,6 +44,68 @@ Table with 4 columns and 2 rows:
 
 Please see the to-do list above for project ideas as well as any open issues! If you add new functionality, please add appropriate documentation and testing. In addition, please increment the minor version of the package to reflect the new changes!
 
+Tests are run with [ParallelTestRunner.jl](https://github.com/JuliaTesting/ParallelTestRunner.jl), which hooks into the standard `Pkg.test` harness for more granular control. See below for some brief usage examples run from the package root directory:
+
+```julia-repl
+julia --proj
+
+julia> using Pkg
+```
+
+**List available testsets:**
+
+```julia-repl
+julia> Pkg.test("Photometry"; test_args=`--list`);
+# ...
+     Testing Running tests...
+Available tests:
+ - aperture/circular
+ - aperture/elliptical
+ - aperture/overlap
+ - aperture/photometry
+ - aperture/plotting
+ - aperture/rectangle
+ - backgroud/background
+ - backgroud/estimators
+ - backgroud/interpolators
+ - detection/detection
+     Testing Photometry tests passed
+```
+
+**Run a subset of testsets in verbose mode, and enable default threading:**
+
+```julia-repl
+julia> Pkg.test("Photometry"; test_args=`--verbose aperture`, julia_args=`--threads=auto`);
+# ...
+     Testing Running tests...
+Running 3 tests in parallel. If this is too many, specify the `--jobs=N` argument to the tests, or set the `JULIA_CPU_THREADS` environment variable.
+                          │          │ ──────────────── CPU ──────────────── │
+Test             (Worker) │ Time (s) │ GC (s) │ GC % │ Alloc (MB) │ RSS (MB) │
+aperture/photometry   (1) │        started at 2025-10-21T16:36:40.959
+aperture/overlap      (2) │        started at 2025-10-21T16:36:40.959
+aperture/plotting     (3) │        started at 2025-10-21T16:36:40.959
+aperture/plotting     (3) │     6.33 │   0.59 │  9.3 │     638.40 │   733.98 │
+aperture/circular     (3) │        started at 2025-10-21T16:36:49.971
+aperture/overlap      (2) │     8.83 │   0.61 │  6.9 │     744.02 │   733.98 │
+aperture/elliptical   (2) │        started at 2025-10-21T16:36:52.293
+aperture/circular     (3) │     1.61 │   0.00 │  0.0 │     160.19 │   733.98 │
+aperture/rectangle    (3) │        started at 2025-10-21T16:36:52.571
+aperture/elliptical   (2) │     0.74 │   0.00 │  0.0 │      79.68 │   733.98 │
+aperture/rectangle    (3) │     1.56 │   0.00 │  0.0 │     142.79 │   734.75 │
+aperture/photometry   (1) │    19.37 │   0.94 │  4.8 │    2712.83 │   821.66 │
+
+Test Summary:           | Pass  Total   Time
+  Overall               | 9478   9478  24.1s
+    aperture/plotting   |   27     27   6.3s
+    aperture/overlap    | 9226   9226   8.8s
+    aperture/circular   |   21     21   1.6s
+    aperture/elliptical |   20     20   0.7s
+    aperture/rectangle  |   12     12   1.6s
+    aperture/photometry |  172    172  19.4s
+    SUCCESS
+     Testing Photometry tests passed
+```
+
 ## License
 
 The work derived from `astropy/photutils` is BSD 3-clause and the work derived from `kbarbary/sep` is BSD 3-clause. All other work is considered MIT expat. Therefore this work as a whole is BSD 3-clause. [`LICENSE`](LICENSE) contains all licenses and any files using derived work are noted at the top of the file.

src/Photometry.jl

@@ -1,6 +1,5 @@
 module Photometry
 
-using TestItems
 using Reexport
 
 include("aperture/Aperture.jl")