github/puppeteer
0
0
Fork 0
mirror of https://github.com/puppeteer/puppeteer synced 2024-06-14 14:02:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: link to the latest-released API from the README.md (#2449)

Browse Source 
This patch adds a preprocessor command to link to the latest-released
API from the README.md.

Fixes #1923.
This commit is contained in:
Andrey Lushnikov
2018-04-25 18:18:08 -07:00
committed by GitHub
parent 13a41495aa
commit 0820d48f80
4 changed files with 35 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
utils/doclint/cli.js
View File

@@ -37,8 +37,10 @@ async function run() {
// Documentation checks.
{
const apiSource = await Source.readFile(path.join(PROJECT_DIR, 'docs', 'api.md'));
const mdSources = [apiSource];
const mdSources = await Promise.all([
Source.readFile(path.join(PROJECT_DIR, 'docs', 'api.md')),
Source.readFile(path.join(PROJECT_DIR, 'README.md'))
]);
const toc = require('./toc');
messages.push(...await toc(mdSources));

4
utils/doclint/preprocessor/index.js
View File

@@ -19,6 +19,8 @@ const Message = require('../Message');
module.exports = function(sources, version) {
// Release version is everything that doesn't include "-".
const isReleaseVersion = !version.includes('-');
const lastReleasedAPILink = `[API](https://github.com/GoogleChrome/puppeteer/blob/v${version.split('-')[0]}/docs/api.md)`;
const messages = [];
const commands = [];
for (const source of sources) {
@@ -52,6 +54,8 @@ module.exports = function(sources, version) {
newText = isReleaseVersion ? 'v' + version : 'Tip-Of-Tree';
else if (command.name === 'empty-if-release')
newText = isReleaseVersion ? '' : command.originalText;
else if (command.name === 'last-released-api')
newText = lastReleasedAPILink;
if (newText === null)
messages.push(Message.error(`Unknown command 'gen:${command.name}'`));
else if (applyCommand(command, newText))

26
utils/doclint/preprocessor/test.js
View File

@@ -100,6 +100,32 @@ describe('preprocessor', function() {
`);
});
});
describe('gen:empty-if-release', function() {
it('should work with non-release version', function() {
const source = new Source('doc.md', `
<!-- gen:last-released-api -->XXX<!-- gen:stop -->
`);
const messages = preprocessor([source], '1.3.0-post');
expect(messages.length).toBe(1);
expect(messages[0].type).toBe('warning');
expect(messages[0].text).toContain('doc.md');
expect(source.text()).toBe(`
<!-- gen:last-released-api -->[API](https://github.com/GoogleChrome/puppeteer/blob/v1.3.0/docs/api.md)<!-- gen:stop -->
`);
});
it('should work with release version', function() {
const source = new Source('doc.md', `
<!-- gen:last-released-api -->XXX<!-- gen:stop -->
`);
const messages = preprocessor([source], '1.3.0');
expect(messages.length).toBe(1);
expect(messages[0].type).toBe('warning');
expect(messages[0].text).toContain('doc.md');
expect(source.text()).toBe(`
<!-- gen:last-released-api -->[API](https://github.com/GoogleChrome/puppeteer/blob/v1.3.0/docs/api.md)<!-- gen:stop -->
`);
});
});
it('should work with multiple commands', function() {
const source = new Source('doc.md', `
<!-- gen:version -->XXX<!-- gen:stop -->