Adding with_debug and with_multisite helpers (#639)

* Adding with_debug and with_multisite helpers

* CHANGELOG

Author: srtfisher

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## v1.5.4 - 2025-03-06
 
+### Added
+
+- Added `with_debug()` and `with_multisite()` methods to the installation manager.
+
 ### Fixed
 
 - Fix the `Post::for()`/`Term::for()` methods to properly set the post

src/mantle/testing/class-installation-manager.php

@@ -265,6 +265,38 @@ public function with_url( ?string $home = null, ?string $site = null, bool $set_
 		return $this;
 	}
 
+	/**
+	 * Enable or disable the debug mode.
+	 *
+	 * @param bool $enable Whether to enable debug mode.
+	 */
+	public function with_debug( bool $enable = true ): static {
+		return $this->before(
+			fn () => putenv( 'MANTLE_TESTING_DEBUG=' . ( $enable ? '1' : '0' ) ), // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.runtime_configuration_putenv
+		);
+	}
+
+	/**
+	 * Enable or disable multisite mode.
+	 *
+	 * This is commonly set on the CI matrix but made available here as well.
+	 *
+	 * @param bool $enable Whether to enable multisite.
+	 */
+	public function with_multisite( bool $enable = true ): static {
+		return $this->before(
+			function () use ( $enable ): void {
+				if ( $enable ) {
+					putenv( 'WP_MULTISITE=1' ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.runtime_configuration_putenv
+					putenv( 'WP_TESTS_MULTISITE=1' ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.runtime_configuration_putenv
+				} else {
+					putenv( 'WP_MULTISITE=0' ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.runtime_configuration_putenv
+					putenv( 'WP_TESTS_MULTISITE=0' ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.runtime_configuration_putenv
+				}
+			},
+		);
+	}
+
 	/**
 	 * Install the Mantle Testing Framework.
 	 *

src/mantle/testing/class-utils.php

@@ -433,6 +433,10 @@ public static function is_debug_mode(): bool {
 			return true;
 		}
 
+		if ( self::env_bool( 'MANTLE_TESTING_DEBUG', false ) ) {
+			return true;
+		}
+
 		return ! empty(
 			array_intersect(
 				(array) ( $_SERVER['argv'] ?? [] ), // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized