/** * Copyright 2017 Google Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ const { runCommands, ensureReleasedAPILinks } = require('.'); const Source = require('../Source.js'); const expect = require('expect'); describe('doclint preprocessor specs', function () { describe('ensureReleasedAPILinks', function () { it('should work with non-release version', function () { const source = new Source( 'doc.md', ` [API](https://github.com/puppeteer/puppeteer/blob/v1.1.0/docs/api.md#class-page) ` ); const messages = ensureReleasedAPILinks([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(` [API](https://github.com/puppeteer/puppeteer/blob/v1.3.0/docs/api.md#class-page) `); }); it('should work with release version', function () { const source = new Source( 'doc.md', ` [API](https://github.com/puppeteer/puppeteer/blob/v1.1.0/docs/api.md#class-page) ` ); const messages = ensureReleasedAPILinks([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(` [API](https://github.com/puppeteer/puppeteer/blob/v1.3.0/docs/api.md#class-page) `); }); it('should keep main branch links intact', function () { const source = new Source( 'doc.md', ` [API](https://github.com/puppeteer/puppeteer/blob/main/docs/api.md#class-page) ` ); const messages = ensureReleasedAPILinks([source], '1.3.0'); expect(messages.length).toBe(0); expect(source.text()).toBe(` [API](https://github.com/puppeteer/puppeteer/blob/main/docs/api.md#class-page) `); }); }); describe('runCommands', function () { it('should throw for unknown command', function () { const source = new Source( 'doc.md', ` something ` ); const messages = runCommands([source], '1.1.1'); expect(source.hasUpdatedText()).toBe(false); expect(messages.length).toBe(1); expect(messages[0].type).toBe('error'); expect(messages[0].text).toContain('Unknown command'); }); describe('gen:version', function () { it('should work', function () { const source = new Source( 'doc.md', ` Puppeteer XXX ` ); const messages = runCommands([source], '1.2.0'); expect(messages.length).toBe(1); expect(messages[0].type).toBe('warning'); expect(messages[0].text).toContain('doc.md'); expect(source.text()).toBe(` Puppeteer v1.2.0 `); }); it('should work for *-post versions', function () { const source = new Source( 'doc.md', ` Puppeteer XXX ` ); const messages = runCommands([source], '1.2.0-post'); expect(messages.length).toBe(1); expect(messages[0].type).toBe('warning'); expect(messages[0].text).toContain('doc.md'); expect(source.text()).toBe(` Puppeteer Tip-Of-Tree `); }); it('should tolerate different writing', function () { const source = new Source( 'doc.md', `Puppeteer vWHAT ` ); runCommands([source], '1.1.1'); expect(source.text()).toBe( `Puppeteer vv1.1.1` ); }); it('should not tolerate missing gen:stop', function () { const source = new Source('doc.md', ``); const messages = runCommands([source], '1.2.0'); expect(source.hasUpdatedText()).toBe(false); expect(messages.length).toBe(1); expect(messages[0].type).toBe('error'); expect(messages[0].text).toContain(`Failed to find 'gen:stop'`); }); }); describe('gen:empty-if-release', function () { it('should clear text when release version', function () { const source = new Source( 'doc.md', ` XXX ` ); const messages = runCommands([source], '1.1.1'); expect(messages.length).toBe(1); expect(messages[0].type).toBe('warning'); expect(messages[0].text).toContain('doc.md'); expect(source.text()).toBe(` `); }); it('should keep text when non-release version', function () { const source = new Source( 'doc.md', ` XXX ` ); const messages = runCommands([source], '1.1.1-post'); expect(messages.length).toBe(0); expect(source.text()).toBe(` XXX `); }); }); describe('gen:toc', function () { it('should work', () => { const source = new Source( 'doc.md', `XXX ### class: page #### page.$ #### page.$$` ); const messages = runCommands([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(` - [class: page](#class-page) * [page.$](#page) * [page.$$](#page-1) ### class: page #### page.$ #### page.$$`); }); it('should work with code blocks', () => { const source = new Source( 'doc.md', `XXX ### class: page \`\`\`bash # yo comment \`\`\` ` ); const messages = runCommands([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(` - [class: page](#class-page) ### class: page \`\`\`bash # yo comment \`\`\` `); }); it('should work with links in titles', () => { const source = new Source( 'doc.md', `XXX ### some [link](#foobar) here ` ); const messages = runCommands([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(` - [some link here](#some-link-here) ### some [link](#foobar) here `); }); }); it('should work with multiple commands', function () { const source = new Source( 'doc.md', ` XXX YYY ZZZ ` ); const messages = runCommands([source], '1.1.1'); expect(messages.length).toBe(1); expect(messages[0].type).toBe('warning'); expect(messages[0].text).toContain('doc.md'); expect(source.text()).toBe(` v1.1.1 v1.1.1 `); }); }); });