@wordpress/env 4.5.0 → 4.7.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 4.7.0 (2022-05-18)
+
+### Enhancement
+-   Added SSH protocol support for git sources
+
 ## 4.2.0 (2022-01-27)
 
 ### Enhancement

package/README.md

@@ -460,12 +460,13 @@ _Note: the port number environment variables (`WP_ENV_PORT` and `WP_ENV_TESTS_PO
 
 Several types of strings can be passed into the `core`, `plugins`, `themes`, and `mappings` fields.
 
-| Type              | Format                        | Example(s)                                               |
-| ----------------- | ----------------------------- | -------------------------------------------------------- |
-| Relative path     | `.<path>\|~<path>`            | `"./a/directory"`, `"../a/directory"`, `"~/a/directory"` |
-| Absolute path     | `/<path>\|<letter>:\<path>`   | `"/a/directory"`, `"C:\\a\\directory"`                   |
-| GitHub repository | `<owner>/<repo>[#<ref>]`      | `"WordPress/WordPress"`, `"WordPress/gutenberg#trunk"`   |
-| ZIP File          | `http[s]://<host>/<path>.zip` | `"https://wordpress.org/wordpress-5.4-beta2.zip"`        |
+| Type              | Format                                       | Example(s)                                               |
+| ----------------- | -------------------------------------------- | -------------------------------------------------------- |
+| Relative path     | `.<path>\|~<path>`                           | `"./a/directory"`, `"../a/directory"`, `"~/a/directory"` |
+| Absolute path     | `/<path>\|<letter>:\<path>`                  | `"/a/directory"`, `"C:\\a\\directory"`                   |
+| GitHub repository | `<owner>/<repo>[#<ref>]`                     | `"WordPress/WordPress"`, `"WordPress/gutenberg#trunk"`   |
+| SSH repository    | `ssh://user@host/<owner>/<repo>.git[#<ref>]` | `"ssh://git@github.com/WordPress/WordPress.git"`         |
+| ZIP File          | `http[s]://<host>/<path>.zip`                | `"https://wordpress.org/wordpress-5.4-beta2.zip"`        |
 
 Remote sources will be downloaded into a temporary directory located in `~/.wp-env`.
 
@@ -534,9 +535,9 @@ This is useful for plugin development.
 }
 ```
 
-#### Latest development WordPress + current directory as a plugin
+### Latest development WordPress + current directory as a plugin
 
-This is useful for plugin development when upstream Core changes need to be tested.
+This is useful for plugin development when upstream Core changes need to be tested. This can also be set via the environment variable `WP_ENV_CORE`.
 
 ```json
 {

package/lib/config/config.js

@@ -13,6 +13,7 @@ const detectDirectoryType = require( './detect-directory-type' );
 const { validateConfig, ValidationError } = require( './validate-config' );
 const readRawConfigFile = require( './read-raw-config-file' );
 const parseConfig = require( './parse-config' );
+const { includeTestsPath, parseSourceString } = parseConfig;
 const md5 = require( '../md5' );
 
 /**
@@ -256,6 +257,18 @@ function withOverrides( config ) {
 		getNumberFromEnvVariable( 'WP_ENV_TESTS_PORT' ) ||
 		config.env.tests.port;
 
+	// Override WordPress core with environment variable.
+	if ( process.env.WP_ENV_CORE ) {
+		const coreSource = includeTestsPath(
+			parseSourceString( process.env.WP_ENV_CORE, {
+				workDirectoryPath: config.workDirectoryPath,
+			} ),
+			{ workDirectoryPath: config.workDirectoryPath }
+		);
+		config.env.development.coreSource = coreSource;
+		config.env.tests.coreSource = coreSource;
+	}
+
 	// Override PHP version with environment variable.
 	config.env.development.phpVersion =
 		process.env.WP_ENV_PHP_VERSION || config.env.development.phpVersion;

package/lib/config/parse-config.js

@@ -114,6 +114,33 @@ function parseSourceString( sourceString, { workDirectoryPath } ) {
 		};
 	}
 
+	// SSH URLs (git)
+	const supportedProtocols = [ 'ssh:', 'git+ssh:' ];
+	try {
+		const sshUrl = new URL( sourceString );
+		if ( supportedProtocols.includes( sshUrl.protocol ) ) {
+			const pathElements = sshUrl.pathname
+				.split( '/' )
+				.filter( ( e ) => !! e );
+			const basename = pathElements
+				.slice( -1 )[ 0 ]
+				.replace( /\.git/, '' );
+			const workingPath = path.resolve(
+				workDirectoryPath,
+				...pathElements.slice( 0, -1 ),
+				basename
+			);
+			return {
+				type: 'git',
+				url: sshUrl.href.split( '#' )[ 0 ],
+				ref: sshUrl.hash.slice( 1 ) || 'master',
+				path: workingPath,
+				clonePath: workingPath,
+				basename,
+			};
+		}
+	} catch ( err ) {}
+
 	const gitHubFields = sourceString.match(
 		/^([^\/]+)\/([^#\/]+)(\/([^#]+))?(?:#(.+))?$/
 	);
@@ -136,6 +163,7 @@ function parseSourceString( sourceString, { workDirectoryPath } ) {
 		`Invalid or unrecognized source: "${ sourceString }".`
 	);
 }
+module.exports.parseSourceString = parseSourceString;
 
 /**
  * Given a source object, returns a new source object with the testsPath
@@ -160,3 +188,4 @@ function includeTestsPath( source, { workDirectoryPath } ) {
 		),
 	};
 }
+module.exports.includeTestsPath = includeTestsPath;

package/lib/config/test/config.js

@@ -4,6 +4,7 @@
  */
 const { readFile, stat } = require( 'fs' ).promises;
 const os = require( 'os' );
+const { join, resolve } = require( 'path' );
 
 /**
  * Internal dependencies
@@ -101,13 +102,17 @@ describe( 'readConfig', () => {
 			process.env.WP_ENV_HOME = 'here/is/a/path';
 			const configWith = await readConfig( '.wp-env.json' );
 			expect(
-				configWith.workDirectoryPath.includes( 'here/is/a/path' )
+				configWith.workDirectoryPath.includes(
+					join( 'here', 'is', 'a', 'path' )
+				)
 			).toBe( true );
 
 			process.env.WP_ENV_HOME = undefined;
 			const configWithout = await readConfig( '.wp-env.json' );
 			expect(
-				configWithout.workDirectoryPath.includes( 'here/is/a/path' )
+				configWithout.workDirectoryPath.includes(
+					join( 'here', 'is', 'a', 'path' )
+				)
 			).toBe( false );
 
 			process.env.WP_ENV_HOME = oldEnvHome;
@@ -126,13 +131,17 @@ describe( 'readConfig', () => {
 			process.env.WP_ENV_HOME = 'here/is/a/path';
 			const configWith = await readConfig( '.wp-env.json' );
 			expect(
-				configWith.workDirectoryPath.includes( 'here/is/a/path' )
+				configWith.workDirectoryPath.includes(
+					join( 'here', 'is', 'a', 'path' )
+				)
 			).toBe( true );
 
 			process.env.WP_ENV_HOME = undefined;
 			const configWithout = await readConfig( '.wp-env.json' );
 			expect(
-				configWithout.workDirectoryPath.includes( 'here/is/a/path' )
+				configWithout.workDirectoryPath.includes(
+					join( 'here', 'is', 'a', 'path' )
+				)
 			).toBe( false );
 
 			process.env.WP_ENV_HOME = oldEnvHome;
@@ -242,26 +251,31 @@ describe( 'readConfig', () => {
 			readFile.mockImplementation( () =>
 				Promise.resolve(
 					JSON.stringify( {
-						plugins: [ './relative', '../parent', '~/home' ],
+						plugins: [
+							'./relative',
+							'../parent',
+							`${ os.homedir() }/home`,
+						],
 					} )
 				)
 			);
 			const config = await readConfig( '.wp-env.json' );
+
 			expect( config.env.development ).toMatchObject( {
 				pluginSources: [
 					{
 						type: 'local',
-						path: expect.stringMatching( /^\/.*relative$/ ),
+						path: expect.stringMatching( /^(\/||\\).*relative$/ ),
 						basename: 'relative',
 					},
 					{
 						type: 'local',
-						path: expect.stringMatching( /^\/.*parent$/ ),
+						path: expect.stringMatching( /^(\/||\\).*parent$/ ),
 						basename: 'parent',
 					},
 					{
 						type: 'local',
-						path: expect.stringMatching( /^\/.*home$/ ),
+						path: expect.stringMatching( /^(\/||\\).*home$/ ),
 						basename: 'home',
 					},
 				],
@@ -270,17 +284,17 @@ describe( 'readConfig', () => {
 				pluginSources: [
 					{
 						type: 'local',
-						path: expect.stringMatching( /^\/.*relative$/ ),
+						path: expect.stringMatching( /^(\/||\\).*relative$/ ),
 						basename: 'relative',
 					},
 					{
 						type: 'local',
-						path: expect.stringMatching( /^\/.*parent$/ ),
+						path: expect.stringMatching( /^(\/||\\).*parent$/ ),
 						basename: 'parent',
 					},
 					{
 						type: 'local',
-						path: expect.stringMatching( /^\/.*home$/ ),
+						path: expect.stringMatching( /^(\/||\\).*home$/ ),
 						basename: 'home',
 					},
 				],
@@ -310,28 +324,28 @@ describe( 'readConfig', () => {
 			expect( config.env.development.pluginSources ).toEqual( [
 				{
 					type: 'local',
-					path: expect.stringMatching( /^\/.*test1a$/ ),
+					path: expect.stringMatching( /^(\/||\\).*test1a$/ ),
 					basename: 'test1a',
 				},
 			] );
 			expect( config.env.development.themeSources ).toEqual( [
 				{
 					type: 'local',
-					path: expect.stringMatching( /^\/.*test2a$/ ),
+					path: expect.stringMatching( /^(\/||\\).*test2a$/ ),
 					basename: 'test2a',
 				},
 			] );
 			expect( config.env.tests.pluginSources ).toEqual( [
 				{
 					type: 'local',
-					path: expect.stringMatching( /^\/.*test1b$/ ),
+					path: expect.stringMatching( /^(\/||\\).*test1b$/ ),
 					basename: 'test1b',
 				},
 			] );
 			expect( config.env.tests.themeSources ).toEqual( [
 				{
 					type: 'local',
-					path: expect.stringMatching( /^\/.*test2b$/ ),
+					path: expect.stringMatching( /^(\/||\\).*test2b$/ ),
 					basename: 'test2b',
 				},
 			] );
@@ -345,15 +359,19 @@ describe( 'readConfig', () => {
 			expect( config.env.development ).toMatchObject( {
 				coreSource: {
 					type: 'local',
-					path: expect.stringMatching( /^\/.*relative$/ ),
-					testsPath: expect.stringMatching( /^\/.*tests-relative$/ ),
+					path: expect.stringMatching( /^(\/||\\).*relative$/ ),
+					testsPath: expect.stringMatching(
+						/^(\/||\\).*tests-relative$/
+					),
 				},
 			} );
 			expect( config.env.tests ).toMatchObject( {
 				coreSource: {
 					type: 'local',
-					path: expect.stringMatching( /^\/.*relative$/ ),
-					testsPath: expect.stringMatching( /^\/.*tests-relative$/ ),
+					path: expect.stringMatching( /^(\/||\\).*relative$/ ),
+					testsPath: expect.stringMatching(
+						/^(\/||\\).*tests-relative$/
+					),
 				},
 			} );
 		} );
@@ -378,21 +396,21 @@ describe( 'readConfig', () => {
 						type: 'git',
 						url: 'https://github.com/WordPress/gutenberg.git',
 						ref: 'master',
-						path: expect.stringMatching( /^\/.*gutenberg$/ ),
+						path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 						basename: 'gutenberg',
 					},
 					{
 						type: 'git',
 						url: 'https://github.com/WordPress/gutenberg.git',
 						ref: 'trunk',
-						path: expect.stringMatching( /^\/.*gutenberg$/ ),
+						path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 						basename: 'gutenberg',
 					},
 					{
 						type: 'git',
 						url: 'https://github.com/WordPress/gutenberg.git',
 						ref: '5.0',
-						path: expect.stringMatching( /^\/.*gutenberg$/ ),
+						path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 						basename: 'gutenberg',
 					},
 					{
@@ -401,7 +419,7 @@ describe( 'readConfig', () => {
 							'https://github.com/WordPress/theme-experiments.git',
 						ref: 'tt1-blocks@0.4.3',
 						path: expect.stringMatching(
-							/^\/.*theme-experiments\/tt1-blocks$/
+							/^(\/||\\).*theme-experiments(\/||\\)tt1-blocks$/
 						),
 						basename: 'tt1-blocks',
 					},
@@ -431,28 +449,32 @@ describe( 'readConfig', () => {
 						type: 'zip',
 						url:
 							'https://downloads.wordpress.org/plugin/gutenberg.zip',
-						path: expect.stringMatching( /^\/.*gutenberg$/ ),
+						path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 						basename: 'gutenberg',
 					},
 					{
 						type: 'zip',
 						url:
 							'https://downloads.wordpress.org/plugin/gutenberg.8.1.0.zip',
-						path: expect.stringMatching( /^\/.*gutenberg$/ ),
+						path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 						basename: 'gutenberg',
 					},
 					{
 						type: 'zip',
 						url:
 							'https://downloads.wordpress.org/theme/twentytwenty.zip',
-						path: expect.stringMatching( /^\/.*twentytwenty$/ ),
+						path: expect.stringMatching(
+							/^(\/||\\).*twentytwenty$/
+						),
 						basename: 'twentytwenty',
 					},
 					{
 						type: 'zip',
 						url:
 							'https://downloads.wordpress.org/theme/twentytwenty.1.3.zip',
-						path: expect.stringMatching( /^\/.*twentytwenty$/ ),
+						path: expect.stringMatching(
+							/^(\/||\\).*twentytwenty$/
+						),
 						basename: 'twentytwenty',
 					},
 				],
@@ -482,34 +504,42 @@ describe( 'readConfig', () => {
 						type: 'zip',
 						url:
 							'https://www.example.com/test/path/to/gutenberg.zip',
-						path: expect.stringMatching( /^\/.*gutenberg$/ ),
+						path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 						basename: 'gutenberg',
 					},
 					{
 						type: 'zip',
 						url:
 							'https://www.example.com/test/path/to/gutenberg.8.1.0.zip',
-						path: expect.stringMatching( /^\/.*gutenberg.8.1.0$/ ),
+						path: expect.stringMatching(
+							/^(\/||\\).*gutenberg.8.1.0$/
+						),
 						basename: 'gutenberg.8.1.0',
 					},
 					{
 						type: 'zip',
 						url:
 							'https://www.example.com/test/path/to/twentytwenty.zip',
-						path: expect.stringMatching( /^\/.*twentytwenty$/ ),
+						path: expect.stringMatching(
+							/^(\/||\\).*twentytwenty$/
+						),
 						basename: 'twentytwenty',
 					},
 					{
 						type: 'zip',
 						url:
 							'https://www.example.com/test/path/to/twentytwenty.1.3.zip',
-						path: expect.stringMatching( /^\/.*twentytwenty.1.3$/ ),
+						path: expect.stringMatching(
+							/^(\/||\\).*twentytwenty.1.3$/
+						),
 						basename: 'twentytwenty.1.3',
 					},
 					{
 						type: 'zip',
 						url: 'https://example.com/twentytwenty.1.3.zip',
-						path: expect.stringMatching( /^\/.*twentytwenty.1.3$/ ),
+						path: expect.stringMatching(
+							/^(\/||\\).*twentytwenty.1.3$/
+						),
 						basename: 'twentytwenty.1.3',
 					},
 				],
@@ -550,12 +580,12 @@ describe( 'readConfig', () => {
 			const matchObj = {
 				test: {
 					type: 'local',
-					path: expect.stringMatching( /^\/.*relative$/ ),
+					path: expect.stringMatching( /^(\/||\\).*relative$/ ),
 					basename: 'relative',
 				},
 				test2: {
 					type: 'git',
-					path: expect.stringMatching( /^\/.*gutenberg$/ ),
+					path: expect.stringMatching( /^(\/||\\).*gutenberg$/ ),
 					basename: 'gutenberg',
 				},
 			};
@@ -653,24 +683,25 @@ describe( 'readConfig', () => {
 			expect( config.env.development.mappings ).toEqual( {
 				test1: {
 					basename: 'test1',
-					path: '/test1',
+					// resolve is required to remove drive letters on Windows.
+					path: resolve( '/test1' ),
 					type: 'local',
 				},
 				test3: {
 					basename: 'test3',
-					path: '/test3',
+					path: resolve( '/test3' ),
 					type: 'local',
 				},
 			} );
 			expect( config.env.tests.mappings ).toEqual( {
 				test1: {
 					basename: 'test1',
-					path: '/test1',
+					path: resolve( '/test1' ),
 					type: 'local',
 				},
 				test2: {
 					basename: 'test2',
-					path: '/test2',
+					path: resolve( '/test2' ),
 					type: 'local',
 				},
 			} );
@@ -702,14 +733,14 @@ describe( 'readConfig', () => {
 			expect( config.env.development.mappings ).toEqual( {
 				test: {
 					basename: 'test3',
-					path: '/test3',
+					path: resolve( '/test3' ),
 					type: 'local',
 				},
 			} );
 			expect( config.env.tests.mappings ).toEqual( {
 				test: {
 					basename: 'test2',
-					path: '/test2',
+					path: resolve( '/test2' ),
 					type: 'local',
 				},
 			} );

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/env",
-	"version": "4.5.0",
+	"version": "4.7.0",
 	"description": "A zero-config, self contained local WordPress environment for development and testing.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -51,5 +51,5 @@
 	"scripts": {
 		"test": "echo \"Error: run tests from root\" && exit 1"
 	},
-	"gitHead": "11eb1241e63c9240018323551c6753f8a5fa96f9"
+	"gitHead": "198fa129cf1af8dc615918987ea6795cd40ab7df"
 }