Add run-fast-tests.ps1 and document test environment variables

- Add PowerShell version of run-fast-tests for Windows
- Add --keep-outputs/-k flag to run-tests.ps1 (matches bash version from ed683a3)
- Document run-fast-tests.sh environment variables with detailed comments
- Add comprehensive test environment variables section to README.md

Environment variables documented:
- QUARTO_TESTS_NO_CONFIG - Skip configure-test-env
- QUARTO_TESTS_FORCE_NO_VENV - Skip .venv activation
- QUARTO_TEST_KEEP_OUTPUTS - Keep test artifacts (new flag support in PS1)
- QUARTO_TEST_VERBOSE - Verbose output
- QUARTO_TESTS_NO_CHECK - Legacy/unused variable

Changes bring feature parity between bash and PowerShell test runners.

Author: cderv

tests/README.md

@@ -140,20 +140,80 @@ Tests are run using `run-tests.sh` on UNIX, and `run-tests.ps1` on Windows.
 ./run-tests.ps1 smoke/extensions/extension-render-doc.test.ts
 ```
 
-#### Prevent configuration for dependencies (R, Julia, Python, ...)
+#### Test environment variables
 
-Those files will run `configure-test-env` scripts to check for requirements and set up dependencies (except on Github Action as this is done in the workflow file directly).
-You can prevent test configuration locally by setting `QUARTO_TESTS_NO_CONFIG` environment variable to a non-empty value.
+The test scripts support several environment variables to control their behavior:
+
+**QUARTO_TESTS_NO_CONFIG**
+- Skip running `configure-test-env` scripts
+- Useful for faster test runs when environment is already configured
+- Tests will still activate `.venv` if present
 
 ```bash
 QUARTO_TESTS_NO_CONFIG="true" ./run-tests.sh
 ```
 
 ```powershell
-$env:QUARTO_TESTS_NO_CONFIG=$true
+$env:QUARTO_TESTS_NO_CONFIG="true"
+./run-tests.ps1
+```
+
+**QUARTO_TESTS_FORCE_NO_VENV** (replaces deprecated `QUARTO_TESTS_FORCE_NO_PIPENV`)
+- Skip activating the `.venv` virtual environment
+- Tests will use system Python packages instead of UV-managed dependencies
+- Use with caution: Python tests may fail if dependencies aren't in system Python
+
+```bash
+QUARTO_TESTS_FORCE_NO_VENV="true" ./run-tests.sh
+```
+
+```powershell
+$env:QUARTO_TESTS_FORCE_NO_VENV="true"
 ./run-tests.ps1
 ```
 
+**Quick test runs with run-fast-tests scripts**
+
+For convenience, `run-fast-tests.sh` and `run-fast-tests.ps1` are provided to skip environment configuration:
+
+```bash
+# Linux/macOS
+./run-fast-tests.sh
+
+# Windows
+./run-fast-tests.ps1
+```
+
+These scripts set `QUARTO_TESTS_NO_CONFIG` automatically. Use after running `configure-test-env` at least once.
+
+**QUARTO_TEST_KEEP_OUTPUTS** (or use `--keep-outputs`/`-k` flag)
+- Keep test output artifacts instead of cleaning them up
+- Useful for debugging test failures or inspecting generated files
+- Can be set via environment variable or command-line flag
+
+```bash
+# Using flag
+./run-tests.sh --keep-outputs
+./run-tests.sh -k
+
+# Using environment variable
+QUARTO_TEST_KEEP_OUTPUTS="true" ./run-tests.sh
+```
+
+```powershell
+# Using flag
+./run-tests.ps1 --keep-outputs
+./run-tests.ps1 -k
+
+# Using environment variable
+$env:QUARTO_TEST_KEEP_OUTPUTS="true"
+./run-tests.ps1
+```
+
+**Other environment variables**
+- `QUARTO_TEST_VERBOSE` - Enable verbose test output
+- `QUARTO_TESTS_NO_CHECK` - Not currently used (legacy variable)
+
 #### About smoke-all tests
 
 `docs/smoke-all/` is a specific folder to run some tests written directly within `.qmd`, `.md` or `.ipynb` files (but files starting with `_` will be ignored). They are run through the `smoke/smoke-all.tests.ts` script. To ease running smoke-all tests, `run-tests.sh` has a special behavior where it will run `./smoke/smoke-all.tests.ts` when passed a `.qmd`, `.md` or `.ipynb` file, not starting with `_`.

tests/run-fast-tests.ps1

@@ -0,0 +1,11 @@
+# Run tests without reconfiguring the environment (faster for repeated test runs)
+#
+# Environment variables set:
+#   QUARTO_TESTS_NO_CONFIG - Skip running configure-test-env.ps1
+#                            (don't reinstall/update R, Python, Julia dependencies)
+#
+# Note: This still activates .venv if present, so Python tests use correct dependencies.
+#       Only use after running configure-test-env.ps1 at least once to set up environment.
+
+$env:QUARTO_TESTS_NO_CONFIG="true"
+& .\run-tests.ps1 @args

tests/run-fast-tests.sh

@@ -1,3 +1,16 @@
 #!/usr/bin/env bash
 
-QUARTO_TESTS_FORCE_NO_PIPENV=true QUARTO_TESTS_NO_CONFIG=true QUARTO_TESTS_NO_CHECK=true ./run-tests.sh $*
+# Run tests without reconfiguring the environment (faster for repeated test runs)
+#
+# Environment variables set:
+#   QUARTO_TESTS_FORCE_NO_VENV - Skip activating .venv virtual environment
+#                                 (tests use system Python packages instead)
+#   QUARTO_TESTS_NO_CONFIG - Skip running configure-test-env.sh
+#                            (don't reinstall/update R, Python, Julia dependencies)
+#   QUARTO_TESTS_NO_CHECK - Not currently used by run-tests.sh
+#                           (kept for backward compatibility in case checked elsewhere)
+#
+# Note: Only use after running configure-test-env.sh at least once to set up environment.
+#       Consider removing QUARTO_TESTS_FORCE_NO_VENV if Python tests require .venv packages.
+
+QUARTO_TESTS_FORCE_NO_VENV=true QUARTO_TESTS_NO_CONFIG=true QUARTO_TESTS_NO_CHECK=true ./run-tests.sh $*

tests/run-tests.ps1

@@ -80,39 +80,62 @@ if ( $MyInvocation.Line -eq "" ) {
   # when script is ran from a child process using -F
   # e.g pwsh -F ./run-tests.ps1 smoke/smoke-all.test.ts -- docs\smoke-all\2023\02\08\4272.qmd
   $customArgs = $MyInvocation.UnboundArguments
+} elseif ($MyInvocation.InvocationName -eq '&') {
+  # when script is called via call operator from another script
+  # e.g & .\run-tests.ps1 @args
+  # Use UnboundArguments directly as it contains the actual arguments passed
+  $customArgs = $MyInvocation.UnboundArguments
 } elseif ($MyInvocation.Line -match "^[.] '[^']*'") {
   # when script is ran from a child process using -command
   # e.g pwsh -command ". 'run-tests.ps1' smoke/smoke-all.test.ts -- docs\smoke-all\2023\02\08\4272.qmd"
   # This is what happens on GHA when using 'run: |' and 'shell: pwsh'
   $argList = ($MyInvocation.Line -replace "^[.] '[^']*'\s*" -split '[;|]')[0].Trim()
   # Extract the argument list from the invocation command line.
-  
+
   # Use Invoke-Expression with a Write-Output call to parse the raw argument list,
   # performing evaluation and splitting it into an array:
-  $customArgs = $argList ? @(Invoke-Expression "Write-Output -- $argList") : @()    
+  $customArgs = $argList ? @(Invoke-Expression "Write-Output -- $argList") : @()
 } else {
   # When script is called from main process
   # e.g ./run-tests.ps1 smoke/smoke-all.test.ts -- docs\smoke-all\2023\02\08\4272.qmd
   $argList = ($MyInvocation.Line -replace ('^.*' + [regex]::Escape($MyInvocation.InvocationName)) -split '[;|]')[0].Trim()
   # Extract the argument list from the invocation command line.
-  
+
   # Use Invoke-Expression with a Write-Output call to parse the raw argument list,
   # performing evaluation and splitting it into an array:
-  $customArgs = $argList ? @(Invoke-Expression "Write-Output -- $argList") : @()    
+  $customArgs = $argList ? @(Invoke-Expression "Write-Output -- $argList") : @()
+}
+
+# Check if keep-outputs mode is enabled and filter it from arguments
+$KEEP_OUTPUTS = $false
+$FILTERED_CUSTOM_ARGS = @()
+foreach ($arg in $customArgs) {
+  if ($arg -eq "--keep-outputs" -or $arg -eq "-k") {
+    $KEEP_OUTPUTS = $true
+  } else {
+    $FILTERED_CUSTOM_ARGS += $arg
+  }
+}
+$customArgs = $FILTERED_CUSTOM_ARGS
+
+if ($KEEP_OUTPUTS) {
+  $env:QUARTO_TEST_KEEP_OUTPUTS = "true"
+  Write-Host "> Keep outputs mode enabled - test artifacts will not be deleted"
 }
 
 ## Short version syntax to run smoke-all.test.ts
 ## Only use if different than ./run-test.ps1 ./smoke/smoke-all.test.ts
 If ($customArgs[0] -notlike "*smoke-all.test.ts") {
-  
+
   $SMOKE_ALL_TEST_FILE="./smoke/smoke-all.test.ts"
   # Check file argument
   $SMOKE_ALL_FILES=@()
   $TESTS_TO_RUN=@()
 
   ForEach ($file in $customArgs) {
     $filename=$(Split-Path -Path $file -Leaf)
-    If ($filename -match "^^[^_].*[.]qmd$" -Or $filename -match "^[^_].*[.]ipynb$" -Or $filename -match "^[^_].*[.]md$") {
+
+    If ($filename -match "^[^_].*[.]qmd$" -Or $filename -match "^[^_].*[.]ipynb$" -Or $filename -match "^[^_].*[.]md$") {
       $SMOKE_ALL_FILES+=$file
     } elseif ($file -Like "*.ts") {
       $TESTS_TO_RUN+=$file