@wordpress/env 5.16.0 → 7.0.0

package/lib/config/test/add-or-replace-port.js

@@ -0,0 +1,81 @@
+'use strict';
+/**
+ * Internal dependencies
+ */
+const addOrReplacePort = require( '../add-or-replace-port.js' );
+
+describe( 'addOrReplacePort', () => {
+	afterEach( () => {
+		jest.clearAllMocks();
+	} );
+
+	it( 'should add or replace port with various inputs', () => {
+		const testMap = [
+			// Addition
+			{ in: 'test', expect: 'test:101' },
+			{ in: 'test/test?test#test', expect: 'test:101/test?test#test' },
+			{ in: 'http://test.com', expect: 'http://test.com:101' },
+			{
+				in: 'http://test.com/test?test#test',
+				expect: 'http://test.com:101/test?test#test',
+			},
+			{ in: 'ssh://test.com', expect: 'ssh://test.com:101' },
+			{ in: 'test.com', expect: 'test.com:101' },
+
+			// Replacement
+			{ in: 'test:99', expect: 'test:101' },
+			{ in: 'test:99/test?test#test', expect: 'test:101/test?test#test' },
+			{ in: 'http://test.com:99', expect: 'http://test.com:101' },
+			{
+				in: 'http://test.com:99/test?test#test',
+				expect: 'http://test.com:101/test?test#test',
+			},
+			{ in: 'ssh://test.com:99', expect: 'ssh://test.com:101' },
+			{ in: 'test.com:99', expect: 'test.com:101' },
+		];
+
+		for ( const test of testMap ) {
+			const result = addOrReplacePort( test.in, '101' );
+			expect( result ).toEqual( test.expect );
+		}
+	} );
+
+	it( 'should support number ports', () => {
+		const testMap = [ { in: 'test', expect: 'test:104' } ];
+
+		for ( const test of testMap ) {
+			const result = addOrReplacePort( test.in, 104, false );
+			expect( result ).toEqual( test.expect );
+		}
+	} );
+
+	it( 'should not add default HTTP port', () => {
+		const testMap = [ { in: 'test', expect: 'test' } ];
+
+		for ( const test of testMap ) {
+			const result = addOrReplacePort( test.in, 80, false );
+			expect( result ).toEqual( test.expect );
+		}
+	} );
+
+	it( 'should not add default HTTPS port', () => {
+		const testMap = [ { in: 'test', expect: 'test' } ];
+
+		for ( const test of testMap ) {
+			const result = addOrReplacePort( test.in, 443, false );
+			expect( result ).toEqual( test.expect );
+		}
+	} );
+
+	it( 'should do nothing if port is present but replacement is not requested', () => {
+		const testMap = [
+			{ in: 'test', expect: 'test:103' },
+			{ in: 'test:99', expect: 'test:99' },
+		];
+
+		for ( const test of testMap ) {
+			const result = addOrReplacePort( test.in, '103', false );
+			expect( result ).toEqual( test.expect );
+		}
+	} );
+} );

package/lib/config/test/config-integration.js

@@ -0,0 +1,143 @@
+'use strict';
+/* eslint-disable jest/no-conditional-expect */
+/**
+ * External dependencies
+ */
+const path = require( 'path' );
+const { readFile } = require( 'fs' ).promises;
+
+/**
+ * Internal dependencies
+ */
+const loadConfig = require( '../load-config' );
+const detectDirectoryType = require( '../detect-directory-type' );
+
+jest.mock( 'fs', () => ( {
+	promises: {
+		readFile: jest.fn(),
+		stat: jest.fn().mockResolvedValue( true ),
+	},
+} ) );
+
+// This mocks a small response with a format matching the stable-check API.
+// It makes getLatestWordPressVersion resolve to "100.0.0".
+jest.mock( 'got', () =>
+	jest.fn( ( url ) => ( {
+		json: () => {
+			if ( url === 'https://api.wordpress.org/core/stable-check/1.0/' ) {
+				return Promise.resolve( {
+					'1.0': 'insecure',
+					'99.1.1': 'outdated',
+					'100.0.0': 'latest',
+					'100.0.1': 'fancy',
+				} );
+			}
+		},
+	} ) )
+);
+
+jest.mock( '../detect-directory-type', () => jest.fn() );
+
+describe( 'Config Integration', () => {
+	beforeEach( () => {
+		process.env.WP_ENV_HOME = '/cache';
+		detectDirectoryType.mockResolvedValue( null );
+	} );
+
+	afterEach( () => {
+		delete process.env.WP_ENV_HOME;
+		delete process.env.WP_ENV_PORT;
+		delete process.env.WP_ENV_TESTS_PORT;
+		delete process.env.WP_ENV_AFTER_SETUP;
+	} );
+
+	it( 'should use default configuration', async () => {
+		readFile.mockImplementation( async () => {
+			throw { code: 'ENOENT' };
+		} );
+
+		const config = await loadConfig( '/test/gutenberg' );
+
+		expect( config.env.development.port ).toEqual( 8888 );
+		expect( config.env.tests.port ).toEqual( 8889 );
+		expect( config ).toMatchSnapshot();
+	} );
+
+	it( 'should load local configuration file', async () => {
+		readFile.mockImplementation( async ( fileName ) => {
+			if ( fileName === '/test/gutenberg/.wp-env.json' ) {
+				return JSON.stringify( {
+					core: 'WordPress/WordPress#trunk',
+					port: 123,
+					afterSetup: 'test',
+				} );
+			}
+
+			throw { code: 'ENOENT' };
+		} );
+
+		const config = await loadConfig( path.resolve( '/test/gutenberg' ) );
+
+		expect( config.env.development.port ).toEqual( 123 );
+		expect( config.env.tests.port ).toEqual( 8889 );
+		expect( config ).toMatchSnapshot();
+	} );
+
+	it( 'should load local and override configuration files', async () => {
+		readFile.mockImplementation( async ( fileName ) => {
+			if ( fileName === '/test/gutenberg/.wp-env.json' ) {
+				return JSON.stringify( {
+					core: 'WordPress/WordPress#trunk',
+					port: 123,
+					testsPort: 456,
+				} );
+			}
+
+			if ( fileName === '/test/gutenberg/.wp-env.override.json' ) {
+				return JSON.stringify( {
+					port: 999,
+				} );
+			}
+
+			throw { code: 'ENOENT' };
+		} );
+
+		const config = await loadConfig( path.resolve( '/test/gutenberg' ) );
+
+		expect( config.env.development.port ).toEqual( 999 );
+		expect( config.env.tests.port ).toEqual( 456 );
+		expect( config ).toMatchSnapshot();
+	} );
+
+	it( 'should use environment variables over local and override configuration files', async () => {
+		process.env.WP_ENV_PORT = 12345;
+		process.env.WP_ENV_TESTS_PORT = 61234;
+		process.env.WP_ENV_AFTER_SETUP = 'test';
+
+		readFile.mockImplementation( async ( fileName ) => {
+			if ( fileName === '/test/gutenberg/.wp-env.json' ) {
+				return JSON.stringify( {
+					core: 'WordPress/WordPress#trunk',
+					port: 123,
+					testsPort: 456,
+					afterSetup: 'local',
+				} );
+			}
+
+			if ( fileName === '/test/gutenberg/.wp-env.override.json' ) {
+				return JSON.stringify( {
+					port: 999,
+				} );
+			}
+
+			throw { code: 'ENOENT' };
+		} );
+
+		const config = await loadConfig( path.resolve( '/test/gutenberg' ) );
+
+		expect( config.env.development.port ).toEqual( 12345 );
+		expect( config.env.tests.port ).toEqual( 61234 );
+		expect( config ).toMatchSnapshot();
+	} );
+} );
+/* eslint-enable jest/no-conditional-expect */

package/lib/config/test/get-cache-directory.js

@@ -0,0 +1,57 @@
+'use strict';
+/* eslint-disable jest/no-conditional-expect */
+/**
+ * External dependencies
+ */
+const { stat } = require( 'fs' ).promises;
+const { homedir } = require( 'os' );
+
+/**
+ * Internal dependencies
+ */
+const getCacheDirectory = require( '../get-cache-directory' );
+
+jest.mock( 'fs', () => ( {
+	promises: {
+		stat: jest.fn(),
+	},
+} ) );
+jest.mock( 'os', () => ( {
+	homedir: jest.fn(),
+} ) );
+
+describe( 'getCacheDirectory', () => {
+	afterEach( () => {
+		delete process.env.WP_ENV_HOME;
+	} );
+
+	it( 'uses WP_ENV_HOME for cache directory when set', async () => {
+		process.env.WP_ENV_HOME = '/test';
+
+		const parsed = await getCacheDirectory();
+
+		expect( homedir ).not.toHaveBeenCalled();
+		expect( parsed ).toEqual( '/test' );
+	} );
+
+	it( 'uses hidden home directory for cache', async () => {
+		stat.mockRejectedValue( false );
+		homedir.mockReturnValue( '/home/test' );
+
+		const parsed = await getCacheDirectory();
+
+		expect( homedir ).toHaveBeenCalled();
+		expect( parsed ).toEqual( '/home/test/.wp-env' );
+	} );
+
+	it( 'uses non-hidden cache directory when using Snap-installed Docker', async () => {
+		stat.mockResolvedValue( true );
+		homedir.mockReturnValue( '/home/test' );
+
+		const parsed = await getCacheDirectory();
+
+		expect( homedir ).toHaveBeenCalled();
+		expect( parsed ).toEqual( '/home/test/wp-env' );
+	} );
+} );
+/* eslint-enable jest/no-conditional-expect */

package/lib/config/test/merge-configs.js

@@ -0,0 +1,111 @@
+'use strict';
+/**
+ * Internal dependencies
+ */
+const mergeConfigs = require( '../merge-configs' );
+
+describe( 'mergeConfigs', () => {
+	it( 'should merge configs without environments', () => {
+		const merged = mergeConfigs(
+			{
+				port: 8888,
+				coreSource: {
+					type: 'local',
+					path: '/home/test',
+				},
+				config: {
+					WP_TEST: 'test',
+				},
+			},
+			{
+				port: 8889,
+				config: {
+					WP_TEST_2: 'test-2',
+				},
+			}
+		);
+
+		expect( merged ).toEqual( {
+			port: 8889,
+			coreSource: {
+				type: 'local',
+				path: '/home/test',
+			},
+			config: {
+				WP_TEST: 'test',
+				WP_TEST_2: 'test-2',
+			},
+		} );
+	} );
+
+	it( 'should merge configs with environments', () => {
+		const merged = mergeConfigs(
+			{
+				port: 8888,
+				coreSource: {
+					type: 'local',
+					path: '/home/test',
+				},
+				config: {
+					WP_TEST: 'test',
+				},
+				env: {
+					development: {
+						config: {
+							WP_TEST_3: 'test-3',
+						},
+					},
+					tests: {
+						config: {
+							WP_TEST_4: 'test-4',
+						},
+					},
+				},
+			},
+			{
+				port: 8889,
+				config: {
+					WP_TEST_2: 'test-2',
+				},
+				env: {
+					development: {
+						config: {
+							WP_TEST_5: 'test-5',
+						},
+					},
+					tests: {
+						config: {
+							WP_TEST_6: 'test-6',
+						},
+					},
+				},
+			}
+		);
+
+		expect( merged ).toEqual( {
+			port: 8889,
+			coreSource: {
+				type: 'local',
+				path: '/home/test',
+			},
+			config: {
+				WP_TEST: 'test',
+				WP_TEST_2: 'test-2',
+			},
+			env: {
+				development: {
+					config: {
+						WP_TEST_3: 'test-3',
+						WP_TEST_5: 'test-5',
+					},
+				},
+				tests: {
+					config: {
+						WP_TEST_4: 'test-4',
+						WP_TEST_6: 'test-6',
+					},
+				},
+			},
+		} );
+	} );
+} );