2018-03-01 13:41:35 -05:00
|
|
|
/**
|
|
|
|
* @license
|
|
|
|
* Copyright Google Inc. 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
|
|
|
|
*/
|
|
|
|
|
2018-03-02 17:19:01 -05:00
|
|
|
import {createPatch} from 'diff';
|
|
|
|
import * as fs from 'fs';
|
|
|
|
import * as path from 'path';
|
|
|
|
import {SerializationOptions, publicApi} from './serializer';
|
|
|
|
|
|
|
|
export {SerializationOptions, publicApi} from './serializer';
|
|
|
|
|
|
|
|
export function generateGoldenFile(
|
|
|
|
entrypoint: string, outFile: string, options: SerializationOptions = {}): void {
|
|
|
|
const output = publicApi(entrypoint, options);
|
2020-02-25 16:05:49 -05:00
|
|
|
|
2020-03-17 14:11:16 -04:00
|
|
|
// BUILD_WORKSPACE_DIRECTORY environment variable is only available during bazel
|
|
|
|
// run executions. This workspace directory allows us to generate golden files directly
|
|
|
|
// in the source file tree rather than via a symlink.
|
|
|
|
if (process.env['BUILD_WORKSPACE_DIRECTORY']) {
|
|
|
|
outFile = path.join(process.env['BUILD_WORKSPACE_DIRECTORY'], outFile);
|
|
|
|
}
|
|
|
|
|
2018-03-02 17:19:01 -05:00
|
|
|
ensureDirectory(path.dirname(outFile));
|
|
|
|
fs.writeFileSync(outFile, output);
|
|
|
|
}
|
|
|
|
|
|
|
|
export function verifyAgainstGoldenFile(
|
|
|
|
entrypoint: string, goldenFile: string, options: SerializationOptions = {}): string {
|
|
|
|
const actual = publicApi(entrypoint, options);
|
2020-02-25 16:05:49 -05:00
|
|
|
const expected = fs.existsSync(goldenFile) ? fs.readFileSync(goldenFile).toString() : '';
|
2018-03-02 17:19:01 -05:00
|
|
|
|
|
|
|
if (actual === expected) {
|
|
|
|
return '';
|
|
|
|
} else {
|
2020-03-17 14:11:16 -04:00
|
|
|
const patch = createPatch(goldenFile, expected, actual, 'Golden file', 'Generated API');
|
2018-03-02 17:19:01 -05:00
|
|
|
|
|
|
|
// Remove the header of the patch
|
|
|
|
const start = patch.indexOf('\n', patch.indexOf('\n') + 1) + 1;
|
|
|
|
|
|
|
|
return patch.substring(start);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
function ensureDirectory(dir: string) {
|
|
|
|
if (!fs.existsSync(dir)) {
|
|
|
|
ensureDirectory(path.dirname(dir));
|
|
|
|
fs.mkdirSync(dir);
|
|
|
|
}
|
|
|
|
}
|
2020-02-25 16:05:49 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Determine if the provided path is a directory.
|
|
|
|
*/
|
|
|
|
function isDirectory(dirPath: string) {
|
|
|
|
try {
|
2020-02-26 12:09:35 -05:00
|
|
|
return fs.lstatSync(dirPath).isDirectory();
|
2020-02-25 16:05:49 -05:00
|
|
|
} catch {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets an array of paths to the typings files for each of the recursively discovered
|
|
|
|
* package.json
|
|
|
|
* files from the directory provided.
|
|
|
|
*/
|
|
|
|
export function discoverAllEntrypoints(dirPath: string) {
|
|
|
|
// Determine all of the package.json files
|
|
|
|
const packageJsons: string[] = [];
|
|
|
|
const entryPoints: string[] = [];
|
|
|
|
const findPackageJsonsInDir = (nextPath: string) => {
|
|
|
|
for (const file of fs.readdirSync(nextPath)) {
|
|
|
|
const fullPath = path.join(nextPath, file);
|
|
|
|
if (isDirectory(fullPath)) {
|
|
|
|
findPackageJsonsInDir(fullPath);
|
|
|
|
} else {
|
|
|
|
if (file === 'package.json') {
|
|
|
|
packageJsons.push(fullPath);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
findPackageJsonsInDir(dirPath);
|
|
|
|
|
|
|
|
// Get all typings file locations from package.json files
|
|
|
|
for (const packageJson of packageJsons) {
|
|
|
|
const packageJsonObj = JSON.parse(fs.readFileSync(packageJson, {encoding: 'utf8'}));
|
|
|
|
const typings = packageJsonObj.typings;
|
|
|
|
if (typings) {
|
|
|
|
entryPoints.push(path.join(path.dirname(packageJson), typings));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return entryPoints;
|
|
|
|
}
|