signal-desktop/scripts/generate-acknowledgments.js
2021-01-27 14:39:09 -08:00

134 lines
3.6 KiB
JavaScript

// Copyright 2020 Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only
/* eslint-disable no-console */
const assert = require('assert');
const fs = require('fs');
const { join } = require('path');
const pMap = require('p-map');
const prettier = require('prettier');
const {
dependencies = {},
optionalDependencies = {},
} = require('../package.json');
const SKIPPED_DEPENDENCIES = new Set([
'ringrtc',
'zkgroup',
'libsignal-client',
]);
const rootDir = join(__dirname, '..');
const nodeModulesPath = join(rootDir, 'node_modules');
const destinationPath = join(rootDir, 'ACKNOWLEDGMENTS.md');
function isLicenseFileName(fileName) {
return /^licen[s|c]e/i.test(fileName);
}
async function getMarkdownForDependency(dependencyName) {
let licenseBody;
// fs-xattr is an optional dependency that may fail to install (on Windows, most
// commonly), so we have a special case for it here. We may need to do something
// similar for new optionalDependencies in the future.
if (dependencyName === 'fs-xattr') {
licenseBody = 'License: MIT';
} else {
const dependencyRootPath = join(nodeModulesPath, dependencyName);
const licenseFileName = (
await fs.promises.readdir(dependencyRootPath)
).find(isLicenseFileName);
if (licenseFileName) {
const licenseFilePath = join(dependencyRootPath, licenseFileName);
licenseBody = (
await fs.promises.readFile(licenseFilePath, 'utf8')
).trim();
} else {
const packageJsonPath = join(dependencyRootPath, 'package.json');
const { license } = JSON.parse(
await fs.promises.readFile(packageJsonPath)
);
if (!license) {
throw new Error(`Could not find license for ${dependencyName}`);
}
licenseBody = `License: ${license}`;
}
}
return [
`## ${dependencyName}`,
'',
...licenseBody.split(/\r?\n/).map(line => {
const trimmed = line.trim();
if (trimmed) {
return ` ${trimmed}`;
}
return trimmed;
}),
].join('\n');
}
function licenseComment() {
const fileCreatedYear = 2020;
const currentYear = new Date().getFullYear();
const yearRange =
fileCreatedYear === currentYear
? fileCreatedYear
: `${fileCreatedYear}-${currentYear}`;
return [
`<!-- Copyright ${yearRange} Signal Messenger, LLC -->`,
'<!-- SPDX-License-Identifier: AGPL-3.0-only -->',
].join('\n');
}
async function main() {
assert.deepStrictEqual(
Object.keys(optionalDependencies),
['fs-xattr'],
'Unexpected optionalDependencies when generating acknowledgments file. To ensure that this file is generated deterministically, make sure to special-case it the acknowledgments generation script.'
);
const dependencyNames = [
...Object.keys(dependencies),
...Object.keys(optionalDependencies),
]
.filter(name => !SKIPPED_DEPENDENCIES.has(name))
.sort();
const markdownsForDependency = await pMap(
dependencyNames,
getMarkdownForDependency,
// Without this, we may run into "too many open files" errors.
{
concurrency: 100,
timeout: 1000 * 60 * 2,
}
);
const unformattedOutput = [
licenseComment(),
'# Acknowledgments',
'',
'Signal Desktop makes use of the following open source projects.',
'',
markdownsForDependency.join('\n\n'),
].join('\n');
const prettierConfig = await prettier.resolveConfig(destinationPath);
const output = prettier.format(unformattedOutput, {
...prettierConfig,
filepath: destinationPath,
});
await fs.promises.writeFile(destinationPath, output);
}
main().catch(err => {
console.error(err);
process.exit(1);
});