Add WP installation with version step

Co-authored-by: swissspidy <[email protected]>

Author: Copilot

features/testing.feature

@@ -62,3 +62,21 @@ Feature: Test that WP-CLI loads.
       """
       sqlite
       """
+
+  Scenario: WP installation with specific version
+    Given a WP installation with version "6.4.2"
+
+    When I run `wp core version`
+    Then STDOUT should be:
+      """
+      6.4.2
+      """
+
+  Scenario: WP installation in subdirectory with specific version
+    Given a WP installation in 'wordpress' with version "6.3.1"
+
+    When I run `wp core version --path=wordpress`
+    Then STDOUT should be:
+      """
+      6.3.1
+      """

src/Context/FeatureContext.php

@@ -622,9 +622,9 @@ private static function configure_sqlite( $dir ): void {
 	 * We cache the results of `wp core download` to improve test performance.
 	 * Ideally, we'd cache at the HTTP layer for more reliable tests.
 	 */
-	private static function cache_wp_files(): void {
-		$wp_version             = getenv( 'WP_VERSION' );
-		$wp_version_suffix      = ( false !== $wp_version ) ? "-$wp_version" : '';
+	private static function cache_wp_files( $version = '' ): void {
+		$wp_version             = $version ?: getenv( 'WP_VERSION' );
+		$wp_version_suffix      = ( false !== $wp_version && '' !== $wp_version ) ? "-$wp_version" : '';
 		self::$cache_dir        = sys_get_temp_dir() . '/wp-cli-test-core-download-cache' . $wp_version_suffix;
 		self::$sqlite_cache_dir = sys_get_temp_dir() . '/wp-cli-test-sqlite-integration-cache';
 
@@ -1289,9 +1289,9 @@ public function add_line_to_wp_config( &$wp_config_code, $line ): void {
 	/**
 	 * @param string $subdir
 	 */
-	public function download_wp( $subdir = '' ): void {
+	public function download_wp( $subdir = '', $version = '' ): void {
 		if ( ! self::$cache_dir ) {
-			self::cache_wp_files();
+			self::cache_wp_files( $version );
 
 			$result = Process::create( Utils\esc_cmd( 'wp core version --debug --path=%s', self::$cache_dir ), null, self::get_process_env_variables() )->run_check();
 			echo "[Debug messages]\n";
@@ -1365,10 +1365,11 @@ public function create_config( $subdir = '', $extra_php = false ): void {
 
 	/**
 	 * @param string $subdir
+	 * @param string $version
 	 */
-	public function install_wp( $subdir = '' ): void {
-		$wp_version              = getenv( 'WP_VERSION' );
-		$wp_version_suffix       = ( false !== $wp_version ) ? "-$wp_version" : '';
+	public function install_wp( $subdir = '', $version = '' ): void {
+		$wp_version              = $version ?: getenv( 'WP_VERSION' );
+		$wp_version_suffix       = ( false !== $wp_version && '' !== $wp_version ) ? "-$wp_version" : '';
 		self::$install_cache_dir = sys_get_temp_dir() . '/wp-cli-test-core-install-cache' . $wp_version_suffix;
 		if ( ! file_exists( self::$install_cache_dir ) ) {
 			mkdir( self::$install_cache_dir );
@@ -1383,7 +1384,7 @@ public function install_wp( $subdir = '' ): void {
 			$this->create_db();
 		}
 		$this->create_run_dir();
-		$this->download_wp( $subdir );
+		$this->download_wp( $subdir, $version );
 		$this->create_config( $subdir, $config_extra_php );
 
 		$install_args = [

src/Context/GivenStepDefinitions.php

@@ -401,6 +401,29 @@ public function given_a_wp_installation(): void {
 		$this->install_wp();
 	}
 
+	/**
+	 * Installs WordPress with a specific version.
+	 *
+	 * ```
+	 * Scenario: My example scenario
+	 *   Given a WP installation with version "6.4.2"
+	 *   ...
+	 *
+	 * Scenario: My other scenario
+	 *   Given a WP install with version "6.3.1"
+	 *   ...
+	 * ```
+	 *
+	 * @access public
+	 *
+	 * @Given a WP install(ation) with version :version
+	 *
+	 * @param string $version
+	 */
+	public function given_a_wp_installation_with_version( $version ): void {
+		$this->install_wp( '', $version );
+	}
+
 	/**
 	 * Installs WordPress in a given directory.
 	 *
@@ -424,6 +447,30 @@ public function given_a_wp_installation_in_a_specific_folder( $subdir ): void {
 		$this->install_wp( $subdir );
 	}
 
+	/**
+	 * Installs WordPress in a given directory with a specific version.
+	 *
+	 * ```
+	 * Scenario: My example scenario
+	 *   Given a WP installation in 'foo' with version "6.4.2"
+	 *   ...
+	 *
+	 * Scenario: My other scenario
+	 *   Given a WP install in 'bar' with version "6.3.1"
+	 *   ...
+	 * ```
+	 *
+	 * @access public
+	 *
+	 * @Given a WP install(ation) in :subdir with version :version
+	 *
+	 * @param string $subdir
+	 * @param string $version
+	 */
+	public function given_a_wp_installation_in_a_specific_folder_with_version( $subdir, $version ): void {
+		$this->install_wp( $subdir, $version );
+	}
+
 	/**
 	 * Installs WordPress with Composer.
 	 *