mirror of
https://github.com/nodejs/node.git
synced 2025-05-09 14:32:49 +00:00
7cbb4b0e6e
PR-URL: https://github.com/nodejs/node/pull/11489 Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl> Reviewed-By: Sam Roberts <vieuxtech@gmail.com> Reviewed-By: Roman Reiss <me@silverwind.io> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Italo A. Casas <me@italoacasas.com>
46 lines
1.0 KiB
JavaScript
46 lines
1.0 KiB
JavaScript
'use strict';
|
|
|
|
const yaml = require('js-yaml');
|
|
|
|
function isYAMLBlock(text) {
|
|
return !!text.match(/^<!-- YAML/);
|
|
}
|
|
|
|
exports.isYAMLBlock = isYAMLBlock;
|
|
|
|
function arrify(value) {
|
|
return Array.isArray(value) ? value : [value];
|
|
}
|
|
|
|
function extractAndParseYAML(text) {
|
|
text = text.trim();
|
|
|
|
text = text.replace(/^<!-- YAML/, '')
|
|
.replace(/-->$/, '');
|
|
|
|
// js-yaml.safeLoad() throws on error
|
|
const meta = yaml.safeLoad(text);
|
|
|
|
const added = meta.added || meta.Added;
|
|
if (added) {
|
|
// Since semver-minors can trickle down to previous major versions,
|
|
// features may have been added in multiple versions.
|
|
meta.added = arrify(added);
|
|
}
|
|
|
|
const deprecated = meta.deprecated || meta.Deprecated;
|
|
if (deprecated) {
|
|
// Treat deprecated like added for consistency.
|
|
meta.deprecated = arrify(deprecated);
|
|
}
|
|
|
|
meta.changes = meta.changes || [];
|
|
meta.changes.forEach((entry) => {
|
|
entry.description = entry.description.replace(/^\^\s*/, '');
|
|
});
|
|
|
|
return meta;
|
|
}
|
|
|
|
exports.extractAndParseYAML = extractAndParseYAML;
|