110 lines
4.6 KiB
TypeScript
110 lines
4.6 KiB
TypeScript
/**
|
||
* @license
|
||
* Copyright Google LLC All Rights Reserved.
|
||
*
|
||
* Use of this source code is governed by an MIT-style license that can be
|
||
* found in the LICENSE file at https://angular.io/license
|
||
*/
|
||
|
||
import * as ora from 'ora';
|
||
import * as semver from 'semver';
|
||
|
||
import {spawnWithDebugOutput} from '../../utils/child-process';
|
||
import {error, green, info, red} from '../../utils/console';
|
||
import {BuiltPackage} from '../config/index';
|
||
|
||
import {FatalReleaseActionError} from './actions-error';
|
||
|
||
/*
|
||
* ###############################################################
|
||
*
|
||
* This file contains helpers for invoking external `ng-dev` commands. A subset of actions,
|
||
* like building release output or setting aν NPM dist tag for release packages, cannot be
|
||
* performed directly as part of the release tool and need to be delegated to external `ng-dev`
|
||
* commands that exist across arbitrary version branches.
|
||
*
|
||
* In a concrete example: Consider a new patch version is released and that a new release
|
||
* package has been added to the `next` branch. The patch branch will not contain the new
|
||
* release package, so we could not build the release output for it. To work around this, we
|
||
* call the ng-dev build command for the patch version branch and expect it to return a list
|
||
* of built packages that need to be released as part of this release train.
|
||
*
|
||
* ###############################################################
|
||
*/
|
||
|
||
/**
|
||
* Invokes the `ng-dev release set-dist-tag` command in order to set the specified
|
||
* NPM dist tag for all packages in the checked out branch to the given version.
|
||
*/
|
||
export async function invokeSetNpmDistCommand(npmDistTag: string, version: semver.SemVer) {
|
||
try {
|
||
// Note: No progress indicator needed as that is the responsibility of the command.
|
||
await spawnWithDebugOutput(
|
||
'yarn', ['--silent', 'ng-dev', 'release', 'set-dist-tag', npmDistTag, version.format()]);
|
||
info(green(` ✓ Set "${npmDistTag}" NPM dist tag for all packages to v${version}.`));
|
||
} catch (e) {
|
||
error(e);
|
||
error(red(` ✘ An error occurred while setting the NPM dist tag for "${npmDistTag}".`));
|
||
throw new FatalReleaseActionError();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Invokes the `ng-dev release build` command in order to build the release
|
||
* packages for the currently checked out branch.
|
||
*/
|
||
export async function invokeReleaseBuildCommand(): Promise<BuiltPackage[]> {
|
||
const spinner = ora.call(undefined).start('Building release output.');
|
||
try {
|
||
// Since we expect JSON to be printed from the `ng-dev release build` command,
|
||
// we spawn the process in silent mode. We have set up an Ora progress spinner.
|
||
const {stdout} = await spawnWithDebugOutput(
|
||
'yarn', ['--silent', 'ng-dev', 'release', 'build', '--json'], {mode: 'silent'});
|
||
spinner.stop();
|
||
info(green(' ✓ Built release output for all packages.'));
|
||
// The `ng-dev release build` command prints a JSON array to stdout
|
||
// that represents the built release packages and their output paths.
|
||
return JSON.parse(stdout.trim()) as BuiltPackage[];
|
||
} catch (e) {
|
||
spinner.stop();
|
||
error(e);
|
||
error(red(' ✘ An error occurred while building the release packages.'));
|
||
throw new FatalReleaseActionError();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Invokes the `yarn install` command in order to install dependencies for
|
||
* the configured project with the currently checked out revision.
|
||
*/
|
||
export async function invokeYarnInstallCommand(projectDir: string): Promise<void> {
|
||
try {
|
||
// Note: No progress indicator needed as that is the responsibility of the command.
|
||
// TODO: Consider using an Ora spinner instead to ensure minimal console output.
|
||
await spawnWithDebugOutput(
|
||
'yarn', ['install', '--frozen-lockfile', '--non-interactive'], {cwd: projectDir});
|
||
info(green(' ✓ Installed project dependencies.'));
|
||
} catch (e) {
|
||
error(e);
|
||
error(red(' ✘ An error occurred while installing dependencies.'));
|
||
throw new FatalReleaseActionError();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Invokes the `yarn bazel clean` command in order to clean the output tree and ensure new artifacts
|
||
* are created for builds.
|
||
*/
|
||
export async function invokeBazelCleanCommand(projectDir: string): Promise<void> {
|
||
try {
|
||
// Note: No progress indicator needed as that is the responsibility of the command.
|
||
// TODO: Consider using an Ora spinner instead to ensure minimal console output.
|
||
await spawnWithDebugOutput('yarn', ['bazel', 'clean'], {cwd: projectDir});
|
||
info(green(' ✓ Cleaned bazel output tree.'));
|
||
} catch (e) {
|
||
error(e);
|
||
error(red(' ✘ An error occurred while cleaning the bazel output tree.'));
|
||
throw new FatalReleaseActionError();
|
||
}
|
||
}
|