338 lines
9.6 KiB
JavaScript
338 lines
9.6 KiB
JavaScript
/* eslint-disable no-console */
|
|
const os = require( 'os' );
|
|
const fs = require( 'fs' );
|
|
const path = require( 'path' );
|
|
const SimpleGit = require( 'simple-git' );
|
|
const chalk = require( 'chalk' );
|
|
|
|
const formats = {
|
|
title: chalk.bold,
|
|
error: chalk.bold.red,
|
|
warning: chalk.bold.keyword( 'orange' ),
|
|
success: chalk.bold.green,
|
|
};
|
|
const {
|
|
runShellScript,
|
|
askForConfirmation,
|
|
getFilesFromDir,
|
|
logAtIndent,
|
|
sanitizeBranchName,
|
|
} = require( './utils' );
|
|
const config = require( './config' );
|
|
const { calculateDelta } = require( './calculate-delta.ts' );
|
|
const { processPerformanceReports } = require( './process-reports.ts' );
|
|
|
|
const ARTIFACTS_PATH =
|
|
process.env.WP_ARTIFACTS_PATH || path.join( process.cwd(), 'artifacts' );
|
|
|
|
/**
|
|
* @typedef WPPerformanceCommandOptions
|
|
*
|
|
* @property {boolean=} ci Run on CI.
|
|
* @property {number=} rounds Run each test suite this many times for each branch.
|
|
* @property {string=} testsBranch The branch whose performance test files will be used for testing.
|
|
* @property {boolean=} skipBenchmarking Skip benchmarking and get to report processing (reports supplied from outside).
|
|
* @property {boolean=} delta Check the difference in performance between branches in percentage.
|
|
* @property {string=} wpVersion The WordPress version to be used as the base install for testing.
|
|
*/
|
|
|
|
/**
|
|
* Runs the performance tests on the current branch.
|
|
*
|
|
* @param {string} testSuite Name of the tests set.
|
|
* @param {string} testRunnerDir Path to the performance tests' clone.
|
|
* @param {string} runKey Unique identifier for the test run.
|
|
*/
|
|
async function runTestSuite( testSuite, testRunnerDir, runKey ) {
|
|
await runShellScript(
|
|
`${ config.getTestCommand( testRunnerDir ) } ${ testSuite }`,
|
|
testRunnerDir,
|
|
{
|
|
...process.env,
|
|
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1',
|
|
WP_ARTIFACTS_PATH: ARTIFACTS_PATH,
|
|
RESULTS_ID: runKey,
|
|
}
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Runs the performances tests on an array of branches and output the result.
|
|
*
|
|
* @param {string[]} branches Branches to compare
|
|
* @param {WPPerformanceCommandOptions} options Command options.
|
|
*/
|
|
async function runPerformanceTests( branches, options ) {
|
|
const runningInCI = !! process.env.CI || !! options.ci;
|
|
const skipBenchmarking = !! options.skipBenchmarking;
|
|
const delta = !! options.delta;
|
|
const TEST_ROUNDS = options.rounds || 1;
|
|
|
|
// The default value doesn't work because commander provides an array.
|
|
if ( branches.length === 0 ) {
|
|
branches = [ 'trunk' ];
|
|
}
|
|
|
|
console.log( formats.title( '\n💃 Performance Tests 🕺' ) );
|
|
console.log(
|
|
'\nWelcome! This tool runs the performance tests on multiple branches and displays a comparison table.'
|
|
);
|
|
|
|
if ( ! runningInCI ) {
|
|
console.log(
|
|
formats.warning(
|
|
'\nIn order to run the tests, the tool is going to load a WordPress testing environment.' +
|
|
'\nMake sure to disable your own environment and testing ports before continuing.\n'
|
|
)
|
|
);
|
|
|
|
await askForConfirmation( 'Ready to go? ' );
|
|
}
|
|
|
|
if ( skipBenchmarking ) {
|
|
// When benchmarking is skipped, it's expected that artifacts folder contains reports for the branches.
|
|
// If so, we'll process reports and pick test suites as per current state of codebase.
|
|
const testSuites = getFilesFromDir(
|
|
path.resolve( __dirname, '../..' ) + config.testsPath
|
|
).map( ( file ) => {
|
|
logAtIndent( 1, 'Found:', formats.success( file ) );
|
|
return path.basename( file, '.spec.js' );
|
|
} );
|
|
|
|
await processPerformanceReports( testSuites, branches );
|
|
if ( delta ) {
|
|
calculateDelta( testSuites, branches );
|
|
}
|
|
return;
|
|
}
|
|
|
|
logAtIndent( 0, 'Setting up' );
|
|
|
|
/**
|
|
* @type {string[]} git refs against which to run tests;
|
|
* could be commit SHA, branch name, tag, etc...
|
|
*/
|
|
if ( branches.length < 2 ) {
|
|
throw new Error( `Need at least two git refs to run` );
|
|
}
|
|
|
|
const baseDir = path.join( os.tmpdir(), 'wp-performance-tests' );
|
|
if ( fs.existsSync( baseDir ) ) {
|
|
logAtIndent( 1, 'Removing existing files' );
|
|
fs.rmSync( baseDir, { recursive: true } );
|
|
}
|
|
|
|
logAtIndent( 1, 'Creating base directory:', formats.success( baseDir ) );
|
|
fs.mkdirSync( baseDir );
|
|
|
|
logAtIndent( 1, 'Setting up repository' );
|
|
const sourceDir = path.join( baseDir, 'source' );
|
|
|
|
logAtIndent( 2, 'Creating directory:', formats.success( sourceDir ) );
|
|
fs.mkdirSync( sourceDir );
|
|
|
|
const sourceGit = SimpleGit( sourceDir );
|
|
logAtIndent(
|
|
2,
|
|
'Initializing:',
|
|
formats.success( config.gitRepositoryURL )
|
|
);
|
|
await sourceGit
|
|
.raw( 'init' )
|
|
.raw( 'remote', 'add', 'origin', config.gitRepositoryURL );
|
|
|
|
for ( const [ i, branch ] of branches.entries() ) {
|
|
logAtIndent(
|
|
2,
|
|
`Fetching environment branch (${ i + 1 } of ${ branches.length }):`,
|
|
formats.success( branch )
|
|
);
|
|
await sourceGit.raw( 'fetch', '--depth=1', 'origin', branch );
|
|
}
|
|
|
|
const testRunnerBranch = options.testsBranch || branches[ 0 ];
|
|
if ( options.testsBranch && ! branches.includes( options.testsBranch ) ) {
|
|
logAtIndent(
|
|
2,
|
|
'Fetching test runner branch:',
|
|
formats.success( options.testsBranch )
|
|
);
|
|
await sourceGit.raw(
|
|
'fetch',
|
|
'--depth=1',
|
|
'origin',
|
|
options.testsBranch
|
|
);
|
|
} else {
|
|
logAtIndent(
|
|
2,
|
|
'Using test runner branch:',
|
|
formats.success( testRunnerBranch )
|
|
);
|
|
}
|
|
|
|
logAtIndent( 1, 'Setting up test runner' );
|
|
|
|
const testRunnerDir = path.join( baseDir + '/tests' );
|
|
|
|
logAtIndent( 2, 'Copying source to:', formats.success( testRunnerDir ) );
|
|
await runShellScript( `cp -R ${ sourceDir } ${ testRunnerDir }` );
|
|
|
|
logAtIndent(
|
|
2,
|
|
'Checking out branch:',
|
|
formats.success( testRunnerBranch )
|
|
);
|
|
await SimpleGit( testRunnerDir ).raw( 'checkout', testRunnerBranch );
|
|
|
|
logAtIndent( 2, 'Installing dependencies and building' );
|
|
await runShellScript(
|
|
`bash -c "source $HOME/.nvm/nvm.sh && nvm install && ${ config.getSetupTestRunner(
|
|
testRunnerDir
|
|
) }"`,
|
|
testRunnerDir
|
|
);
|
|
|
|
logAtIndent( 1, 'Setting up test environments' );
|
|
|
|
const envsDir = path.join( baseDir, 'environments' );
|
|
logAtIndent( 2, 'Creating parent directory:', formats.success( envsDir ) );
|
|
fs.mkdirSync( envsDir );
|
|
|
|
let wpZipUrl = null;
|
|
if ( options.wpVersion ) {
|
|
// In order to match the topology of ZIP files at wp.org, remap .0
|
|
// patch versions to major versions:
|
|
//
|
|
// 5.7 -> 5.7 (unchanged)
|
|
// 5.7.0 -> 5.7 (changed)
|
|
// 5.7.2 -> 5.7.2 (unchanged)
|
|
const zipVersion = options.wpVersion.replace( /^(\d+\.\d+).0/, '$1' );
|
|
wpZipUrl = `https://wordpress.org/wordpress-${ zipVersion }.zip`;
|
|
}
|
|
|
|
const branchDirs = {};
|
|
for ( const branch of branches ) {
|
|
logAtIndent( 2, 'Branch:', formats.success( branch ) );
|
|
const sanitizedBranchName = sanitizeBranchName( branch );
|
|
const envDir = path.join( envsDir, sanitizedBranchName );
|
|
|
|
logAtIndent( 3, 'Creating directory:', formats.success( envDir ) );
|
|
fs.mkdirSync( envDir );
|
|
branchDirs[ branch ] = envDir;
|
|
const buildDir = path.join( envDir, 'plugin' );
|
|
|
|
logAtIndent( 3, 'Copying source to:', formats.success( buildDir ) );
|
|
await runShellScript( `cp -R ${ sourceDir } ${ buildDir }` );
|
|
|
|
logAtIndent( 3, 'Checking out:', formats.success( branch ) );
|
|
await SimpleGit( buildDir ).raw( 'checkout', branch );
|
|
|
|
logAtIndent( 3, 'Installing dependencies and building' );
|
|
await runShellScript(
|
|
`bash -c "source $HOME/.nvm/nvm.sh && nvm install && ${ config.getSetupCommand(
|
|
buildDir
|
|
) }"`,
|
|
buildDir
|
|
);
|
|
|
|
const wpEnvConfigPath = path.join( envDir, '.wp-env.json' );
|
|
|
|
logAtIndent(
|
|
3,
|
|
'Saving wp-env config to:',
|
|
formats.success( wpEnvConfigPath )
|
|
);
|
|
|
|
fs.writeFileSync(
|
|
wpEnvConfigPath,
|
|
JSON.stringify(
|
|
{
|
|
config: {
|
|
WP_DEBUG: false,
|
|
SCRIPT_DEBUG: false,
|
|
},
|
|
core: wpZipUrl || 'WordPress/WordPress',
|
|
plugins: [ buildDir + config.pluginPath ],
|
|
themes: [
|
|
// Ideally this should be a fixed version of the theme.
|
|
// And it should be enabled in the tests suite.
|
|
'https://downloads.wordpress.org/theme/twentynineteen.zip',
|
|
],
|
|
env: {
|
|
tests: {
|
|
port: 8086,
|
|
},
|
|
},
|
|
},
|
|
null,
|
|
2
|
|
),
|
|
'utf8'
|
|
);
|
|
}
|
|
|
|
logAtIndent( 0, 'Looking for test files' );
|
|
|
|
const testSuites = getFilesFromDir(
|
|
path.join( testRunnerDir, config.testsPath )
|
|
).map( ( file ) => {
|
|
logAtIndent( 1, 'Found:', formats.success( file ) );
|
|
return path.basename( file, '.spec.js' );
|
|
} );
|
|
|
|
logAtIndent( 0, 'Running tests' );
|
|
|
|
if ( wpZipUrl ) {
|
|
logAtIndent(
|
|
1,
|
|
'Using:',
|
|
formats.success( `WordPress v${ options.wpVersion }` )
|
|
);
|
|
} else {
|
|
logAtIndent( 1, 'Using:', formats.success( 'WordPress trunk' ) );
|
|
}
|
|
|
|
// TODO: change this to tools/compare-perf/node_modules/.bin/wp-env
|
|
const wpEnvPath = path.join(
|
|
testRunnerDir,
|
|
'plugins/woocommerce/node_modules/.bin/wp-env'
|
|
);
|
|
|
|
for ( const testSuite of testSuites ) {
|
|
for ( let i = 1; i <= TEST_ROUNDS; i++ ) {
|
|
logAtIndent(
|
|
1,
|
|
// prettier-ignore
|
|
`Suite: ${ formats.success( testSuite ) } (round ${ i } of ${ TEST_ROUNDS })`
|
|
);
|
|
|
|
for ( const branch of branches ) {
|
|
logAtIndent( 2, 'Branch:', formats.success( branch ) );
|
|
|
|
const sanitizedBranchName = sanitizeBranchName( branch );
|
|
const runKey = `${ testSuite }_${ sanitizedBranchName }_round-${ i }`;
|
|
const envDir = branchDirs[ branch ];
|
|
|
|
logAtIndent( 3, 'Starting environment' );
|
|
await runShellScript( `${ wpEnvPath } start`, envDir );
|
|
|
|
logAtIndent( 3, 'Running tests' );
|
|
await runTestSuite( testSuite, testRunnerDir, runKey );
|
|
|
|
logAtIndent( 3, 'Stopping environment' );
|
|
await runShellScript( `${ wpEnvPath } stop`, envDir );
|
|
}
|
|
}
|
|
}
|
|
|
|
await processPerformanceReports( testSuites, branches );
|
|
if ( delta ) {
|
|
calculateDelta( testSuites, branches );
|
|
}
|
|
}
|
|
|
|
module.exports = {
|
|
runPerformanceTests,
|
|
};
|