dfa88f8...main · typeable/remark-validate-links

git.iko.soy/typeable/remark-validate-links

60 files changed+2849−1270

since splitsnapshots

unifiedsplit

.editorconfig+1−7

@@ -2,14 +2,8 @@ root = true

33[*]

44indent_style = space

5−indent_size = 4

5+indent_size = 2

66end_of_line = lf

77charset = utf-8

88trim_trailing_whitespace = true

99insert_final_newline = true

10−

11−[*.{json,html,svg,css,mdastrc,eslintrc}]

12−indent_size = 2

13−

14−[*.md]

15−trim_trailing_whitespace = false

.eslintignoredeleted−1

@@ -1 +0,0 @@

1−coverage/

.eslintrcdeleted−8

@@ -1,8 +0,0 @@

1−{

2− "env": {

3− "node": true

4− },

5− "rules": {

6− "quotes": [2, "single"]

7− }

8−}

.gitignore+2

@@ -1,4 +1,6 @@

11.DS_Store

22*.log

3+.nyc_output/

34coverage/

45node_modules/

6+yarn.lock

.jscs.jsondeleted−147

@@ -1,147 +0,0 @@

1−{

2− "excludeFiles": [

3− "coverage/",

4− "node_modules/"

5− ],

6− "plugins": [

7− "jscs-jsdoc"

8− ],

9− "jsDoc": {

10− "checkAnnotations": "jsdoc3",

11− "checkParamNames": true,

12− "requireParamTypes": true,

13− "checkRedundantParams": true,

14− "checkReturnTypes": true,

15− "checkRedundantReturns": true,

16− "requireReturnTypes": true,

17− "checkTypes": "strictNativeCase",

18− "checkRedundantAccess": true,

19− "enforceExistence": true,

20− "requireHyphenBeforeDescription": true

21− },

22− "requireCurlyBraces": [

23− "if",

24− "else",

25− "for",

26− "while",

27− "do",

28− "try",

29− "catch"

30− ],

31− "requireSpaceAfterKeywords": [

32− "if",

33− "else",

34− "for",

35− "while",

36− "do",

37− "switch",

38− "return",

39− "try",

40− "catch"

41− ],

42− "requireSpaceBeforeBlockStatements": true,

43− "requireParenthesesAroundIIFE": true,

44− "requireSpacesInConditionalExpression": true,

45− "requireSpacesInAnonymousFunctionExpression": {

46− "beforeOpeningRoundBrace": true,

47− "beforeOpeningCurlyBrace": true

48− },

49− "requireSpacesInNamedFunctionExpression": {

50− "beforeOpeningRoundBrace": true,

51− "beforeOpeningCurlyBrace": true

52− },

53− "requireSpacesInFunctionExpression": {

54− "beforeOpeningCurlyBrace": true

55− },

56− "requireBlocksOnNewline": true,

57− "disallowPaddingNewlinesInBlocks": true,

58− "disallowEmptyBlocks": true,

59− "disallowSpacesInsideObjectBrackets": true,

60− "disallowSpacesInsideArrayBrackets": true,

61− "disallowSpacesInsideParentheses": true,

62− "requireSpacesInsideObjectBrackets": "all",

63− "disallowDanglingUnderscores": true,

64− "disallowSpaceAfterObjectKeys": true,

65− "requireCommaBeforeLineBreak": true,

66− "requireOperatorBeforeLineBreak": [

67− "?",

68− "+",

69− "-",

70− "/",

71− "*",

72− "=",

73− "==",

74− "===",

75− "!=",

76− "!==",

77− ">",

78− ">=",

79− "<",

80− "<="

81− ],

82− "requireSpaceBeforeBinaryOperators": [

83− "+",

84− "-",

85− "/",

86− "*",

87− "=",

88− "==",

89− "===",

90− "!=",

91− "!=="

92− ],

93− "requireSpaceAfterBinaryOperators": [

94− "+",

95− "-",

96− "/",

97− "*",

98− "=",

99− "==",

100− "===",

101− "!=",

102− "!=="

103− ],

104− "disallowSpaceAfterPrefixUnaryOperators": [

105− "++",

106− "--",

107− "+",

108− "-",

109− "~",

110− "!"

111− ],

112− "disallowSpaceBeforePostfixUnaryOperators": [

113− "++",

114− "--"

115− ],

116− "disallowImplicitTypeConversion": [

117− "numeric",

118− "boolean",

119− "binary",

120− "string"

121− ],

122− "requireCamelCaseOrUpperCaseIdentifiers": true,

123− "disallowKeywords": [

124− "with"

125− ],

126− "disallowMultipleLineStrings": true,

127− "disallowMultipleLineBreaks": true,

128− "validateLineBreaks": "LF",

129− "validateQuoteMarks": "'",

130− "disallowMixedSpacesAndTabs": true,

131− "disallowTrailingWhitespace": true,

132− "disallowTrailingComma": true,

133− "disallowKeywordsOnNewLine": [

134− "else"

135− ],

136− "requireLineFeedAtFileEnd": true,

137− "maximumLineLength": 78,

138− "requireCapitalizedConstructors": true,

139− "safeContextKeyword": "self",

140− "requireDotNotation": true,

141− "disallowYodaConditions": true,

142− "validateJSDoc": {

143− "checkParamNames": true,

144− "checkRedundantParams": true,

145− "requireParamTypes": true

146− }

147−}

.mdastignoredeleted−1

@@ -1 +0,0 @@

1−test/

.mdastrcdeleted−12

@@ -1,12 +0,0 @@

1−{

2− "plugins": [

3− "slug",

4− "./",

5− "lint",

6− "github",

7− "yaml-config"

8− ],

9− "settings": {

10− "bullet": "*"

11− }

12−}

.npmrcnew file+1

@@ -0,0 +1 @@

1+package-lock=false

.prettierignorenew file+3

@@ -0,0 +1,3 @@

1+coverage/

2+*.json

3+*.md

.travis.yml+3−7

@@ -1,9 +1,5 @@

11language: node_js

2−script: npm run-script test-travis

32node_js:

4−- '0.10'

5−- '0.11'

6−- '0.12'

7−- iojs

8−sudo: false

9−after_script: npm install coveralls@2.10.0 && cat ./coverage/lcov.info | coveralls

3+ - lts/dubnium

4+ - node

5+after_success: bash <(curl -s https://codecov.io/bash)

history.mddeleted−9

@@ -1,9 +0,0 @@

1−---

2−mdast:

3− setext: true

4−---

5−

6−

7−

8−0.1.0 / 2015-07-18

9−==================

index.js+2−496

@@ -1,497 +1,3 @@

1−'use strict';

1+'use strict'

3−/*

4− * Dependencies.

5− */

6−

7−var url = require('url');

8−var fs = require('fs');

9−var path = require('path');

10−var visit = require('mdast-util-visit');

11−var definitions = require('mdast-util-definitions');

12−var gh = require('github-url-to-object');

13−var urljoin = require('urljoin');

14−

15−/*

16− * Methods.

17− */

18−

19−var exists = fs.existsSync;

20−var parse = url.parse;

21−

22−/**

23− * Get the `pathname` of `uri`, if applicable.

24− *

25− * @todo Externalise.

26− * @param {string} uri - Reference.

27− * @return {string?} - Pathname.

28− */

29−function getPathname(uri) {

30− return parse(uri).pathname;

31−}

32−

33−/**

34− * Get the `hash` of `uri`, if applicable.

35− *

36− * @todo Externalise.

37− * @param {string} uri - Reference.

38− * @return {string?} - Hash.

39− */

40−function getHash(uri) {

41− var hash = parse(uri).hash;

42−

43− return hash ? hash.slice(1) : null;

44−}

45−

46−/**

47− * Utilitity to warn `warning` for each node in `nodes`,

48− * on `file`.

49− *

50− * @param {File} file - Virtual file.

51− * @param {Array.<Node>} nodes - Offending nodes.

52− * @param {string} warning - Message.

53− */

54−function warnAll(file, nodes, warning) {

55− nodes.forEach(function (node) {

56− file.warn(warning, node);

57− });

58−}

59−

60−/**

61− * Gather references: a map of file-paths references

62− * to be one or more nodes.

63− *

64− * @example

65− * gatherReferences(new File(), {});

66− *

67− * @param {File} file - Set of virtual files.

68− * @param {Object.<string, string>} project - GitHub

69− * project, with a `user` and `repo` property

70− * (optional).

71− * @return {Object.<string, Array.<Node>>} exposed - Map of

72− * file-paths (and anchors) which are referenced.

73− */

74−function gatherReferences(file, project) {

75− var cache = {};

76− var filePath = file.filePath();

77− var directory = file.directory;

78− var ast = file.ast;

79− var getDefinition = definitions(ast);

80− var prefix = '';

81−

82− if (project.user && project.repo) {

83− prefix = '/' + project.user + '/' + project.repo + '/blob/';

84− }

85−

86− /**

87− * Handle new links.

88− *

89− * @example

90− * link({

91− * href: 'foo/bar/baz.md#foo',

92− * children: [

93− * {

94− * type: 'text',

95− * value: 'foo'

96− * }

97− * ]

98− * });

99− *

100− * @param {Node} node - Link or link-reference node.

101− */

102− function onlink(node) {

103− var link = node.href;

104− var definition;

105− var index;

106− var uri;

107− var pathname;

108− var hash;

109−

110− /*

111− * Handle link-references.

112− */

113−

114− if (node.identifier) {

115− definition = getDefinition(node.identifier);

116− link = definition && definition.link;

117− }

118−

119− /*

120− * Ignore definitions without link.

121− */

122−

123− if (!link) {

124− return;

125− }

126−

127− uri = parse(link);

128−

129− if (!uri.hostname) {

130− /*

131− * Handle hashes, or relative files.

132− */

133− if (!uri.pathname && uri.hash) {

134− link = filePath + uri.hash;

135− uri = parse(link);

136− } else {

137− link = urljoin(directory, link) + (uri.hash || '');

138− uri = parse(link);

139− }

140− }

141−

142− /*

143− * Handle full links.

144− * Only works with GitHub.

145− */

146−

147− if (uri.hostname) {

148− if (!prefix) {

149− return;

150− }

151−

152− if (

153− uri.hostname !== 'github.com' ||

154− uri.pathname.slice(0, prefix.length) !== prefix

155− ) {

156− return;

157− }

158−

159− link = uri.pathname.slice(prefix.length) + (uri.hash || '');

160−

161− /*

162− * Things get interesting here: branches.

163− * `foo/bar/baz` could be `baz` on the

164− * `foo/bar` branch. Or, `baz` in the `bar`

165− * directory on the `foo` branch.

166− *

167− * Currently, I’m ignoring this and just not

168− * supporting branches.

169− */

170−

171− link = link.slice(link.indexOf('/') + 1);

172−

173− uri = parse(link);

174− }

175−

176− /*

177− * Handle file links, or combinations of files

178− * and hashes.

179− */

180−

181− index = link.indexOf('#');

182−

183− if (index === -1) {

184− pathname = link;

185− hash = null;

186− } else {

187− pathname = link.slice(0, index);

188− hash = link.slice(index + 1);

189− }

190−

191− if (!cache[pathname]) {

192− cache[pathname] = [];

193− }

194−

195− cache[pathname].push(node);

196−

197− if (hash) {

198− if (!cache[link]) {

199− cache[link] = [];

200− }

201−

202− cache[link].push(node);

203− }

204− }

205−

206− visit(ast, 'link', onlink);

207− visit(ast, 'linkReference', onlink);

208−

209− return cache;

210−}

211−

212−/**

213− * Factory to store all markdown files, and headings.

214− *

215− * @example

216− * var gather = gatherExposedFactory();

217− * var file = new File('# foo');

218− *

219− * gather(file).done() // {}

220− *

221− * @return {Function}

222− */

223−function gatherExposedFactory() {

224− var cache = {};

225− var hasHeadings = false;

226− var hasSlugs = false;

227−

228− /**

229− * Access found files and headings.

230− *

231− * @return {Object.<string, boolean>} - Map of

232− * file-paths, with `true` as their value.

233− * @throws {Error} - When headings are found, but no

234− * heading has a slug.

235− */

236− function done() {

237− if (hasHeadings && !hasSlugs) {

238− throw new Error(

239− 'Missing slugs. Use for example `mdast-slug` to generate ' +

240− 'heading IDs'

241− );

242− }

243−

244− return cache;

245− }

246−

247− /**

248− * Find headings in `file`.

249− *

250− * @property {Function} done - Access found links.

251− * @param {File} file - Virtual file.

252− * @returns {Function} - Itself.

253− */

254− function gather(file) {

255− var filePath = file.filePath();

256−

257− /*

258− * Ignore files without AST or filename.

259− */

260−

261− if (filePath && file.ast) {

262− cache[filePath] = true;

263−

264− visit(file.ast, 'heading', function (node) {

265− var id = node.attributes && node.attributes.id;

266−

267− hasHeadings = true;

268−

269− if (id) {

270− cache[filePath + '#' + id] = hasSlugs = true;

271− }

272− });

273− }

274−

275− return gather;

276− }

277−

278− gather.done = done;

279−

280− return gather;

281−}

282−

283−/**

284− * Check if `file` references headings or files not in

285− * `exposed`. If `project` is given, normalizes GitHub blob

286− * URLs.

287− *

288− * @example

289− * validate({'example.md': true}, new File());

290− *

291− * @param {Object.<string, boolean?>} exposed - Map of

292− * file-paths (and anchors) which can be references to.

293− * @param {File} file - Set of virtual files.

294− * @param {Object.<string, string>} project - GitHub

295− * project, with a `user` and `repo` property

296− * (optional).

297− */

298−function validate(exposed, file, project) {

299− var references = file.ast ? gatherReferences(file, project) : {};

300− var filePath = file.filePath();

301− var reference;

302− var nodes;

303− var real;

304− var hash;

305− var pathname;

306− var warning;

307−

308− for (reference in references) {

309− nodes = references[reference];

310− real = exposed[reference];

311− hash = getHash(reference);

312−

313− /*

314− * Check if files without `hash` can be linked to.

315− * Because there’s no need to inspect those files

316− * for headings they are not added to mdast. This

317− * is especially useful because they might be

318− * non-markdown files. Here we check if they exist.

319− */

320−

321− if ((real === undefined || real === null) && !hash) {

322− real = references[reference] = exists(reference);

323− }

324−

325− if (!real) {

326− if (hash) {

327− pathname = getPathname(reference);

328− warning = 'Link to unknown heading';

329−

330− if (pathname !== filePath) {

331− warning += ' in `' + pathname + '`';

332− }

333−

334− warning += ': `' + hash + '`';

335− } else {

336− warning = 'Link to unknown file: `' + reference + '`';

337− }

338−

339− warnAll(file, nodes, warning);

340− }

341− }

342−}

343−

344−/**

345− * Factory to create a new completer.

346− *

347− * @example

348− * var completer = completerFactory({

349− * 'user': 'foo',

350− * 'repo': 'bar'

351− * });

352− *

353− * @param {Object} project - GitHub project, if applicable.

354− * @return {Function} - `completer`, bound to `project`.

355− */

356−function completerFactory(project) {

357− /**

358− * Completer.

359− *

360− * @example

361− * completer(new FileSet(), console.log)

362− *

363− * @property {*} pluginId - Unique ID so completers by

364− * this plug-in are not added multiple times to a single

365− * file-set pipeline.

366− * @param {FileSet} set - Virtual file-set.

367− * @param {function(err?)} done - Callback.

368− */

369− function completer(set, done) {

370− var gatherExposed = gatherExposedFactory();

371− var exposed;

372−

373− set.valueOf().forEach(gatherExposed);

374−

375− exposed = gatherExposed.done();

376−

377− set.valueOf().forEach(function (file) {

378− validate(exposed, file, project);

379− });

380−

381− done();

382− }

383−

384− completer.pluginId = 'mdast-validate-links';

385−

386− return completer;

387−}

388−

389−/**

390− * Factory to create a transformer based on the given

391− * project and set.

392− *

393− * @example

394− * transformerFactory({}, new FileSet());

395− *

396− * @param {Object.<string, string>} project - GitHub

397− * project, with a `user` and `repo` property

398− * (optional).

399− * @param {FileSet} fileSet - Set of virtual files.

400− * @return {function(ast, file)}

401− */

402−function transformerFactory(project, fileSet) {

403− /**

404− * Transformer. Adds references files to the set.

405− *

406− * @example

407− * transformer({}, new File());

408− *

409− * @param {*} ast - Node.

410− * @param {File} file - Virtual file.

411− */

412− function transformer(ast, file) {

413− var references = gatherReferences(file, project);

414− var links = [];

415− var current = getPathname(file.filePath());

416− var link;

417− var pathname;

418−

419− for (link in references) {

420− pathname = getPathname(link);

421−

422− if (

423− pathname !== current &&

424− getHash(link) &&

425− links.indexOf(pathname) === -1

426− ) {

427− links.push(pathname);

428−

429− fileSet.add(pathname);

430− }

431− }

432− }

433−

434− return transformer;

435−}

436−

437−/**

438− * Attacher.

439− *

440− * @example

441− * attacher(mdast())

442− * // [Error: mdast-validate-links only works on the CLI]

443− *

444− * @param {MDAST} mdast - Processor.

445− * @param {Object?} options - Settings.

446− * @param {FileSet?} fileSet - Virtual file-set.

447− * @throws {Error} - When `fileSet` is not given (when not on

448− * the CLI).

449− */

450−function attacher(mdast, options, fileSet) {

451− var repo = (options || {}).repository;

452− var pack;

453−

454− /*

455− * Throw when not on the CLI.

456− */

457−

458− if (!fileSet) {

459− throw new Error('mdast-validate-links only works on the CLI');

460− }

461−

462− /*

463− * Try to get the repo from `package.json` when not

464− * given.

465− */

466−

467− if (!repo) {

468− try {

469− pack = require(path.resolve(process.cwd(), 'package.json'));

470− } catch (exception) {

471− pack = {};

472− }

473−

474− repo = pack.repository ? pack.repository.url || pack.repository : '';

475− }

476−

477− repo = repo ? gh(repo) : {};

478−

479− repo = {

480− 'user': repo.user,

481− 'repo': repo.repo

482− };

483−

484− /*

485− * Attach a `completer`.

486− */

487−

488− fileSet.use(completerFactory(repo));

489−

490− return transformerFactory(repo, fileSet);

491−}

492−

493−/*

494− * Expose.

495− */

496−

497−module.exports = attacher;

3+module.exports = require('./lib')

lib/check/check-files.browser.jsnew file+7

@@ -0,0 +1,7 @@

1+'use strict'

3+module.exports = checkIfReferencedFilesExist

5+function checkIfReferencedFilesExist(ctx, next) {

6+ next()

7+}

lib/check/check-files.jsnew file+42

@@ -0,0 +1,42 @@

1+'use strict'

3+var fs = require('fs')

5+module.exports = checkIfReferencedFilesExist

7+function checkIfReferencedFilesExist(ctx, next) {

8+ var landmarks = ctx.landmarks

9+ var references = ctx.references

10+ var filePaths = []

11+ var filePath

12+ var actual = 0

13+ var expected

14+

15+ for (filePath in references) {

16+ if (landmarks[filePath] === undefined) {

17+ filePaths.push(filePath)

18+ }

19+ }

20+

21+ expected = filePaths.length

22+

23+ if (expected === 0) {

24+ next()

25+ } else {

26+ filePaths.forEach(checkIfExists)

27+ }

28+

29+ function checkIfExists(filePath) {

30+ fs.access(filePath, fs.F_OK, onaccess)

31+

32+ function onaccess(err) {

33+ var noEntry = err && (err.code === 'ENOENT' || err.code === 'ENOTDIR')

34+

35+ landmarks[filePath] = {'': !noEntry}

36+

37+ if (++actual === expected) {

38+ next()

39+ }

40+ }

41+ }

42+}

lib/check/index.jsnew file+13

@@ -0,0 +1,13 @@

1+'use strict'

3+var trough = require('trough')

4+var mergeLandmarks = require('./merge-landmarks')

5+var mergeReferences = require('./merge-references')

6+var checkIfReferencedFilesExist = require('./check-files')

7+var validate = require('./validate')

9+module.exports = trough()

10+ .use(mergeLandmarks)

11+ .use(mergeReferences)

12+ .use(checkIfReferencedFilesExist)

13+ .use(validate)

lib/check/merge-landmarks.jsnew file+29

@@ -0,0 +1,29 @@

1+'use strict'

3+var xtend = require('xtend')

4+var constants = require('../constants')

6+module.exports = mergeLandmarks

8+function mergeLandmarks(ctx) {

9+ var result = {}

10+ var files = ctx.files

11+ var length = files.length

12+ var index = -1

13+ var file

14+ var landmarks

15+ var landmark

16+

17+ while (++index < length) {

18+ file = files[index]

19+ landmarks = file.data[constants.landmarkId]

20+

21+ if (landmarks) {

22+ for (landmark in landmarks) {

23+ result[landmark] = xtend(result[landmark] || {}, landmarks[landmark])

24+ }

25+ }

26+ }

27+

28+ ctx.landmarks = result

29+}

lib/check/merge-references.jsnew file+42

@@ -0,0 +1,42 @@

1+'use strict'

3+var constants = require('../constants')

5+module.exports = mergeReferences

7+function mergeReferences(ctx) {

8+ var result = {}

9+ var files = ctx.files

10+ var length = files.length

11+ var index = -1

12+ var file

13+ var references

14+ var reference

15+ var all

16+ var internal

17+ var hash

18+

19+ while (++index < length) {

20+ file = files[index]

21+ references = file.data[constants.referenceId]

22+

23+ if (!references) {

24+ continue

25+ }

26+

27+ for (reference in references) {

28+ internal = references[reference]

29+ all = result[reference] || (result[reference] = {})

30+

31+ for (hash in internal) {

32+ ;(all[hash] || (all[hash] = [])).push({

33+ file: file,

34+ reference: {filePath: reference, hash: hash},

35+ nodes: internal[hash]

36+ })

37+ }

38+ }

39+ }

40+

41+ ctx.references = result

42+}

lib/check/validate.jsnew file+108

@@ -0,0 +1,108 @@

1+'use strict'

3+var path = require('path')

4+var propose = require('propose')

5+var constants = require('../constants')

7+module.exports = validate

9+function validate(ctx) {

10+ var landmarks = ctx.landmarks

11+ var references = ctx.references

12+ var missing = []

13+ var reference

14+ var hash

15+ var refs

16+ var lands

17+ var length

18+ var index

19+

20+ for (reference in references) {

21+ refs = references[reference]

22+ /* istanbul ignore next - `else` could happen in browser. */

23+ lands = landmarks[reference] || {}

24+

25+ for (hash in refs) {

26+ if (!lands[hash]) {

27+ missing = missing.concat(refs[hash])

28+ }

29+ }

30+ }

31+

32+ length = missing.length

33+ index = -1

34+

35+ while (++index < length) {

36+ reference = missing[index]

37+ warn(ctx, reference.reference, reference.file, reference.nodes)

38+ }

39+}

40+

41+function warn(ctx, info, file, nodes) {

42+ var landmarks = ctx.landmarks

43+ var absolute = file.path ? path.resolve(file.cwd, file.path) : ''

44+ var base = absolute ? path.dirname(absolute) : null

45+ var filePath = base ? path.relative(base, info.filePath) : info.filePath

46+ var hash = info.hash

47+ var dictionary = []

48+ var subhash

49+ var landmark

50+ var relativeLandmark

51+ var reason

52+ var ruleId

53+ var origin

54+ var suggestion

55+

56+ if (hash) {

57+ reason = 'Link to unknown heading'

58+ ruleId = constants.headingRuleId

59+

60+ if (base && path.join(base, filePath) !== absolute) {

61+ reason += ' in `' + filePath + '`'

62+ ruleId = constants.headingInFileRuleId

63+ }

64+

65+ reason += ': `' + hash + '`'

66+ } else {

67+ reason = 'Link to unknown file: `' + filePath + '`'

68+ ruleId = constants.fileRuleId

69+ }

70+

71+ origin = [constants.sourceId, ruleId].join(':')

72+

73+ for (landmark in landmarks) {

74+ // Only suggest if file exists.

75+ if (!landmarks[landmark] || !landmarks[landmark]['']) {

76+ continue

77+ }

78+

79+ relativeLandmark = base ? path.relative(base, landmark) : landmark

80+

81+ if (!hash) {

82+ dictionary.push(relativeLandmark)

83+ continue

84+ }

85+

86+ if (relativeLandmark !== filePath) {

87+ continue

88+ }

89+

90+ for (subhash in landmarks[landmark]) {

91+ if (subhash !== '') {

92+ dictionary.push(subhash)

93+ }

94+ }

95+ }

96+

97+ suggestion = propose(hash ? hash : filePath, dictionary, {threshold: 0.7})

98+

99+ if (suggestion) {

100+ reason += '. Did you mean `' + suggestion + '`'

101+ }

102+

103+ nodes.forEach(one)

104+

105+ function one(node) {

106+ file.message(reason, node, origin)

107+ }

108+}

lib/constants.jsnew file+8

@@ -0,0 +1,8 @@

1+'use strict'

3+exports.sourceId = 'remark-validate-links'

4+exports.headingRuleId = 'missing-heading'

5+exports.headingInFileRuleId = 'missing-heading-in-file'

6+exports.fileRuleId = 'missing-file'

7+exports.landmarkId = 'remarkValidateLinksLandmarks'

8+exports.referenceId = 'remarkValidateLinksReferences'

lib/find/config.jsnew file+54

@@ -0,0 +1,54 @@

1+'use strict'

3+var hostedGitInfo = require('hosted-git-info')

5+module.exports = config

7+var viewPaths = {github: 'blob', gitlab: 'blob', bitbucket: 'src'}

8+var headingPrefixes = {github: '#', gitlab: '#', bitbucket: '#markdown-header-'}

9+var topAnchors = {github: '#readme', gitlab: '#readme'}

10+var lineLinks = {github: true, gitlab: true}

11+

12+function config(ctx) {

13+ var repo = ctx.repository

14+ var urlConfig = ctx.urlConfig

15+ var info = {}

16+

17+ if (urlConfig) {

18+ return

19+ }

20+

21+ urlConfig = {

22+ prefix: '',

23+ headingPrefix: '#',

24+ lines: false,

25+ hostname: null,

26+ topAnchor: null

27+ }

28+

29+ if (repo) {

30+ info = hostedGitInfo.fromUrl(repo)

31+ }

32+

33+ if (info) {

34+ if (info.type in viewPaths) {

35+ urlConfig.prefix = '/' + info.path() + '/' + viewPaths[info.type] + '/'

36+ }

37+

38+ if (info.type in headingPrefixes) {

39+ urlConfig.headingPrefix = headingPrefixes[info.type]

40+ }

41+

42+ if (info.type in lineLinks) {

43+ urlConfig.lines = lineLinks[info.type]

44+ }

45+

46+ if (info.type in topAnchors) {

47+ urlConfig.topAnchor = topAnchors[info.type]

48+ }

49+

50+ urlConfig.hostname = info.domain

51+ }

52+

53+ ctx.urlConfig = urlConfig

54+}

lib/find/find-repo.browser.jsnew file+7

@@ -0,0 +1,7 @@

1+'use strict'

3+module.exports = findRepo

5+function findRepo(ctx, next) {

6+ next()

7+}

lib/find/find-repo.jsnew file+76

@@ -0,0 +1,76 @@

1+'use strict'

3+var path = require('path')

4+var exec = require('child_process').exec

6+module.exports = findRepo

8+function findRepo(ctx, next) {

9+ var repo = ctx.repository

10+ var file = ctx.file

11+ var base = file.cwd

12+ var actual = 0

13+ var expected = 0

14+

15+ if (file.path) {

16+ base = path.dirname(path.resolve(base, file.path))

17+ }

18+

19+ if (repo === null || repo === undefined) {

20+ expected++

21+ exec('git remote -v', {cwd: base}, onremote)

22+ }

23+

24+ if (ctx.root === null || ctx.root === undefined) {

25+ if (repo === null || repo === undefined) {

26+ expected++

27+ exec('git rev-parse --show-cdup', {cwd: base}, oncdup)

28+ } else {

29+ ctx.root = ctx.file.cwd

30+ }

31+ } else {

32+ ctx.root = path.resolve(file.cwd, ctx.root)

33+ }

34+

35+ if (actual === expected) {

36+ next()

37+ }

38+

39+ function onremote(err, stdout) {

40+ var remote

41+

42+ if (err) {

43+ expected = Infinity

44+ return next(err)

45+ }

46+

47+ remote = stdout.match(/origin\t(.+?) $fetch$/)

48+ ctx.repository = remote ? remote[1] : null

49+

50+ if (!ctx.repository) {

51+ expected = Infinity

52+ return next(new Error('Could not find remote origin'))

53+ }

54+

55+ if (++actual === expected) {

56+ expected = Infinity

57+ next()

58+ }

59+ }

60+

61+ function oncdup(err, stdout) {

62+ var out

63+

64+ if (err) {

65+ expected = Infinity

66+ return next(err)

67+ }

68+

69+ out = stdout.trim()

70+ ctx.root = out ? path.join(base, out) : base

71+

72+ if (++actual === expected) {

73+ next()

74+ }

75+ }

76+}

lib/find/find.jsnew file+296

@@ -0,0 +1,296 @@

1+'use strict'

3+var fs = require('fs')

4+var path = require('path')

5+var URL = require('url').URL // Node 8 support

6+var vfile = require('to-vfile')

7+var visit = require('unist-util-visit')

8+var toString = require('mdast-util-to-string')

9+var xtend = require('xtend')

10+var slugs = require('github-slugger')()

11+var constants = require('../constants')

12+

13+module.exports = find

14+

15+var slash = '/'

16+var numberSign = '#'

17+var questionMark = '?'

18+

19+var https = 'https:'

20+var http = 'http:'

21+var slashes = '//'

22+

23+var lineExpression = /^#l\d/i

24+

25+// List from: https://github.com/github/markup#markups

26+var readmeExtensions = ['.markdown', '.mdown', '.mkdn', '.md']

27+var readmeBasename = /^readme$/i

28+

29+function find(ctx, next) {

30+ var file = ctx.file

31+ var fileSet = ctx.fileSet

32+ var absolute = file.path ? path.resolve(file.cwd, file.path) : ''

33+ var space = file.data

34+ var references = {}

35+ var landmarks = {}

36+ var actual = 0

37+ var expected = 0

38+ var statted = []

39+ var added = []

40+ var config = xtend(ctx.urlConfig, {

41+ path: absolute,

42+ base: absolute ? path.dirname(absolute) : file.cwd,

43+ root: ctx.root

44+ })

45+

46+ space[constants.referenceId] = references

47+ space[constants.landmarkId] = landmarks

48+

49+ addLandmarks(absolute, '')

50+

51+ slugs.reset()

52+

53+ visit(ctx.tree, mark)

54+

55+ if (expected === 0) {

56+ next()

57+ }

58+

59+ function mark(node) {

60+ var data = node.data || {}

61+ var props = data.hProperties || {}

62+ var id = props.name || props.id || data.id

63+ var info = node.url ? urlToPath(node.url, config) : null

64+ var fp

65+ var hash

66+

67+ if (!id && node.type === 'heading') {

68+ id = slugs.slug(toString(node))

69+ }

70+

71+ if (id) {

72+ addLandmarks(absolute, id)

73+ }

74+

75+ if (info) {

76+ fp = info.filePath

77+ hash = info.hash

78+

79+ addReference(fp, '', node)

80+

81+ if (hash) {

82+ if (fileSet || fp === absolute) {

83+ addReference(fp, hash, node)

84+ }

85+

86+ if (fileSet && fp && statted.indexOf(fp) === -1) {

87+ addFile(fp)

88+ }

89+ }

90+ }

91+ }

92+

93+ function addLandmarks(filePath, hash) {

94+ addLandmark(filePath, hash)

95+

96+ // Note: this may add marks too many anchors as defined.

97+ // For example, if there is both a `readme.md` and a `readme.markdown` in a

98+ // folder, both their landmarks will be defined for their parent folder.

99+ // To solve this, we could check whichever sorts first, and ignore the

100+ // others.

101+ // This is an unlikely scenario though, and adds a lot of complexity, so

102+ // we’re ignoring it.

103+ if (readme(filePath)) {

104+ addLandmark(path.dirname(filePath), hash)

105+ }

106+ }

107+

108+ function addLandmark(filePath, hash) {

109+ var marks = landmarks[filePath] || (landmarks[filePath] = {})

110+

111+ marks[hash] = true

112+ }

113+

114+ function addReference(filePath, hash, node) {

115+ var refs = references[filePath] || (references[filePath] = {})

116+ var hashes = refs[hash] || (refs[hash] = [])

117+

118+ hashes.push(node)

119+ }

120+

121+ function addFile(fileOrFolderPath) {

122+ expected++

123+

124+ statted.push(fileOrFolderPath)

125+

126+ fs.stat(fileOrFolderPath, onstat)

127+

128+ function onstat(_, stats) {

129+ if (stats && stats.isDirectory()) {

130+ fs.readdir(fileOrFolderPath, onreaddir)

131+ } else {

132+ done(fileOrFolderPath)

133+ }

134+ }

135+

136+ function onreaddir(_, entries) {

137+ /* istanbul ignore next - unlikely that it is an unreadable directory. */

138+ var files = (entries || []).sort()

139+ var length = files.length

140+ var index = -1

141+ var entry

142+ var file

143+ var filePath

144+

145+ while (++index < length) {

146+ entry = entries[index]

147+

148+ if (readme(entry)) {

149+ file = entry

150+ break

151+ }

152+ }

153+

154+ // If there is no readme that we can parse, add the directory.

155+ filePath = fileOrFolderPath

156+

157+ // To do: test for no readme in directory.

158+

159+ if (file) {

160+ filePath = path.join(fileOrFolderPath, file)

161+ statted.push(filePath)

162+ }

163+

164+ done(filePath)

165+ }

166+

167+ function done(filePath) {

168+ if (added.indexOf(filePath) === -1) {

169+ added.push(filePath)

170+

171+ fileSet.add(

172+ vfile({cwd: file.cwd, path: path.relative(file.cwd, filePath)})

173+ )

174+ }

175+

176+ actual++

177+

178+ if (actual === expected) {

179+ next()

180+ }

181+ }

182+ }

183+}

184+

185+function urlToPath(value, config) {

186+ var url

187+ var questionMarkIndex

188+ var numberSignIndex

189+

190+ // Absolute paths: `/wooorm/test/blob/main/directory/example.md`.

191+ if (value.charAt(0) === slash) {

192+ if (!config.hostname) {

193+ return

194+ }

195+

196+ // Create a URL.

197+ value = https + slashes + config.hostname + value

198+ }

199+

200+ try {

201+ url = new URL(value)

202+ } catch (_) {}

203+

204+ // URLs: `https://github.com/wooorm/test/blob/main/directory/example.md`.

205+ if (url) {

206+ // Exit if we don’t have hosted Git info or this is not a URL to the repo.

207+ if (

208+ !config.prefix ||

209+ !config.hostname ||

210+ (url.protocol !== https && url.protocol !== http) ||

211+ url.hostname !== config.hostname ||

212+ url.pathname.slice(0, config.prefix.length) !== config.prefix

213+ ) {

214+ return

215+ }

216+

217+ value = url.pathname.slice(config.prefix.length)

218+

219+ // Things get interesting here: branches: `foo/bar/baz` could be `baz` on

220+ // the `foo/bar` branch, or, `baz` in the `bar` directory on the `foo`

221+ // branch.

222+ // Currently, we’re ignoring this and just not supporting branches.

223+ value = value.split(slash).slice(1).join(slash)

224+

225+ return normalize(path.resolve(config.root, value + url.hash), config)

226+ }

227+

228+ // Remove the search: `?foo=bar`.

229+ // But don’t remove stuff if it’s in the hash: `readme.md#heading?`.

230+ numberSignIndex = value.indexOf(numberSign)

231+ questionMarkIndex = value.indexOf(questionMark)

232+

233+ if (

234+ questionMarkIndex !== -1 &&

235+ (numberSignIndex === -1 || numberSignIndex > questionMarkIndex)

236+ ) {

237+ value =

238+ value.slice(0, questionMarkIndex) +

239+ (numberSignIndex === -1 ? '' : value.slice(numberSignIndex))

240+ }

241+

242+ // Local: `#heading`.

243+ if (value.charAt(0) === numberSign) {

244+ value = config.path ? config.path + value : value

245+ }

246+ // Anything else, such as `readme.md`.

247+ else {

248+ value = config.path ? path.resolve(config.base, value) : ''

249+ }

250+

251+ return normalize(value, config)

252+}

253+

254+function normalize(url, config) {

255+ var numberSignIndex = url.indexOf(numberSign)

256+ var lines = config.lines

257+ var prefix = config.headingPrefix

258+ var topAnchor = config.topAnchor

259+ var filePath

260+ var hash

261+

262+ if (numberSignIndex === -1) {

263+ filePath = url

264+ } else {

265+ filePath = url.slice(0, numberSignIndex)

266+ hash = url.slice(numberSignIndex).toLowerCase()

267+

268+ // Ignore the hash if it references the top anchor of the environment

269+ if (topAnchor && hash === topAnchor) {

270+ hash = undefined

271+ }

272+ // Ignore the hash if it references lines in a file or doesn’t start

273+ // with a heading prefix.

274+ else if (

275+ (lines && lineExpression.test(hash)) ||

276+ hash.slice(0, prefix.length) !== prefix

277+ ) {

278+ hash = undefined

279+ }

280+ // Use the hash if it starts with a heading prefix.

281+ else {

282+ hash = hash.slice(prefix.length)

283+ }

284+ }

285+

286+ return {filePath: decodeURIComponent(filePath), hash: hash}

287+}

288+

289+function readme(filePath) {

290+ var ext = path.extname(filePath)

291+

292+ return (

293+ readmeExtensions.indexOf(ext) !== -1 &&

294+ readmeBasename.test(path.basename(filePath, ext))

295+ )

296+}

lib/find/index.jsnew file+8

@@ -0,0 +1,8 @@

1+'use strict'

3+var trough = require('trough')

4+var findRepo = require('./find-repo')

5+var config = require('./config')

6+var find = require('./find')

8+module.exports = trough().use(findRepo).use(config).use(find)

lib/index.jsnew file+48

@@ -0,0 +1,48 @@

1+'use strict'

3+var xtend = require('xtend')

4+var check = require('./check')

5+var find = require('./find')

6+var constants = require('./constants')

8+module.exports = validateLinks

10+cliCompleter.pluginId = constants.sourceId

11+

12+function validateLinks(options, fileSet) {

13+ var settings = options || {}

14+

15+ // Attach a `completer`.

16+ if (fileSet) {

17+ fileSet.use(cliCompleter)

18+ }

19+

20+ return transformer

21+

22+ // Find references and landmarks.

23+ function transformer(tree, file, next) {

24+ find.run(xtend(settings, {tree: tree, file: file, fileSet: fileSet}), done)

25+

26+ function done(err) {

27+ if (err) {

28+ next(err)

29+ } else if (fileSet) {

30+ next()

31+ } else {

32+ checkAll([file], next)

33+ }

34+ }

35+ }

36+}

37+

38+// Completer for the CLI (multiple files, supports parsing more files).

39+function cliCompleter(set, next) {

40+ checkAll(set.valueOf(), next)

41+}

42+

43+function checkAll(files, next) {

44+ // Check all references and landmarks.

45+ check.run({files: files}, function (err) {

46+ next(err)

47+ })

48+}

LICENSE → licenserenamed

The content is the same.

package.json+83−41

@@ -1,58 +1,100 @@

11{

2− "name": "mdast-validate-links",

3− "version": "0.1.0",

4− "description": "Validate links to headings and files in markdown",

2+ "name": "remark-validate-links",

3+ "version": "10.0.2",

4+ "description": "remark plugin to validate links to headings and files",

55 "license": "MIT",

66 "keywords": [

7+ "unified",

8+ "remark",

9+ "remark-plugin",

10+ "plugin",

11+ "mdast",

12+ "markdown",

713 "validate",

814 "link",

915 "reference",

1016 "file",

11− "heading",

12− "mdast"

17+ "heading"

1318 ],

14− "dependencies": {

15− "github-url-to-object": "^1.5.2",

16− "mdast-slug": "^0.1.1",

17− "mdast-util-definitions": "^0.1.0",

18− "mdast-util-visit": "^0.1.1",

19− "urljoin": "^0.1.5"

20− },

21− "repository": {

22− "type": "git",

23− "url": "https://github.com/wooorm/mdast-validate-links.git"

19+ "repository": "remarkjs/remark-validate-links",

20+ "bugs": "https://github.com/remarkjs/remark-validate-links/issues",

21+ "funding": {

22+ "type": "opencollective",

23+ "url": "https://opencollective.com/unified"

2424 },

25− "author": {

26− "name": "Titus Wormer",

27− "email": "tituswormer@gmail.com"

25+ "author": "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",

26+ "contributors": [

27+ "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",

28+ "Diogo Nunes <dialex.nunes@gmail.com>",

29+ "Jonathan Haines <jonno.haines@gmail.com>",

30+ "Merlijn Vos <merlijn@soverin.net>",

31+ "Andrew Petro <andrew.w.petro@gmail.com>",

32+ "wangshijun <wangshijun2010@gmail.com>",

33+ "Anton Rybochkin <anton.rybochkin@axibase.com>"

34+ ],

35+ "browser": {

36+ "./lib/check/check-files.js": "./lib/check/check-files.browser.js",

37+ "./lib/find/find-repo.js": "./lib/find/find-repo.browser.js"

2838 },

2939 "files": [

30− "index.js",

31− "LICENSE"

40+ "lib/",

41+ "index.js"

3242 ],

43+ "dependencies": {

44+ "github-slugger": "^1.0.0",

45+ "hosted-git-info": "^3.0.0",

46+ "mdast-util-to-string": "^1.0.0",

47+ "propose": "0.0.5",

48+ "to-vfile": "^6.0.0",

49+ "trough": "^1.0.0",

50+ "unist-util-visit": "^2.0.0",

51+ "xtend": "^4.0.0"

52+ },

3353 "devDependencies": {

34− "cept": "^1.0.0",

35− "eslint": "^0.24.0",

36− "istanbul": "^0.3.0",

37− "jscs": "^1.0.0",

38− "jscs-jsdoc": "^1.0.0",

39− "mdast": "^0.27.0-rc.2",

40− "mdast-github": "^0.3.0",

41− "mdast-lint": "^0.4.0",

42− "mdast-yaml-config": "^0.2.0",

43− "mocha": "^2.0.0"

54+ "nyc": "^15.0.0",

55+ "prettier": "^2.0.0",

56+ "remark": "^12.0.0",

57+ "remark-cli": "^8.0.0",

58+ "remark-preset-wooorm": "^7.0.0",

59+ "rimraf": "^3.0.0",

60+ "strip-ansi": "^6.0.0",

61+ "tape": "^5.0.0",

62+ "vfile-sort": "^2.0.0",

63+ "xo": "^0.32.0"

4464 },

4565 "scripts": {

46− "test-api": "mocha --check-leaks test/index.js",

47− "test-coveralls": "istanbul cover _mocha --report lcovonly -- --check-leaks test/index.js",

48− "test-coverage": "istanbul cover _mocha -- test/index.js",

49− "test-travis": "npm run test-coveralls",

50− "test": "npm run test-api",

51− "lint-api": "eslint .",

52− "lint-style": "jscs --reporter inline .",

53− "lint": "npm run lint-api && npm run lint-style",

54− "make": "npm run lint && npm run test-coverage",

55− "build-md": "mdast . --output --quiet",

56− "build": "npm run build-md"

66+ "format": "remark . -qfo --ignore-pattern test/ && prettier . --write && xo --fix",

67+ "test-api": "node test",

68+ "test-coverage": "nyc --reporter lcov tape test/index.js",

69+ "test": "npm run format && npm run test-coverage"

70+ },

71+ "nyc": {

72+ "check-coverage": true,

73+ "lines": 100,

74+ "functions": 100,

75+ "branches": 100

76+ },

77+ "prettier": {

78+ "tabWidth": 2,

79+ "useTabs": false,

80+ "singleQuote": true,

81+ "bracketSpacing": false,

82+ "semi": false,

83+ "trailingComma": "none"

84+ },

85+ "xo": {

86+ "prettier": true,

87+ "esnext": false,

88+ "rules": {

89+ "unicorn/prefer-optional-catch-binding": "off",

90+ "unicorn/no-fn-reference-in-iterator": "off",

91+ "unicorn/prefer-includes": "off",

92+ "guard-for-in": "off"

93+ }

94+ },

95+ "remarkConfig": {

96+ "plugins": [

97+ "preset-wooorm"

98+ ]

5799 }

58100}

readme.md+268−56

@@ -1,103 +1,315 @@

1−# mdast-validate-links [![Build Status](https://img.shields.io/travis/wooorm/mdast-validate-links.svg?style=flat)](https://travis-ci.org/wooorm/mdast-validate-links) [![Coverage Status](https://img.shields.io/coveralls/wooorm/mdast-validate-links.svg?style=flat)](https://coveralls.io/r/wooorm/mdast-validate-links?branch=master)

1+# remark-validate-links

3−> Currently, this only works with the current beta version of

4−> **mdast**: [0.27.0-rc.2](https://github.com/wooorm/mdast/blob/5f3d914fd0a59fd42bd1a2852ba17e1d1f6360db/history.md).

3+[![Build][build-badge]][build]

4+[![Coverage][coverage-badge]][coverage]

5+[![Downloads][downloads-badge]][downloads]

6+[![Size][size-badge]][size]

7+[![Sponsors][sponsors-badge]][collective]

8+[![Backers][backers-badge]][collective]

9+[![Chat][chat-badge]][chat]

510

6−[**mdast**](https://github.com/wooorm/mdast) plug-in to validate if links to

7−headings and files in markdown point to existing things.

11+[**remark**][remark] plugin to validate that Markdown links and images reference

12+existing local files and headings.

813

9−For example, this document does not have a heading named `Hello`. So if I

10−link to that (`[welcome](#hello)`), this plug-in will warn about it.

14+For example, this document does not have a heading named `Hello`.

15+So if we’d link to it (`[welcome](#hello)`), we’d get a warning.

1116

12−In addition, when I link to a heading in another document

13−(`examples/foo.md#hello`), if this file exists but the heading does not,

14−or if the file does not exist, this plug-in will also warn.

17+In addition, when there’s a link to a heading in another document

18+(`examples/foo.md#hello`), if that file exists but the heading does not, or if

19+that file does not exist, we’d also get a warning.

1520

16−Linking to other files, such as `LICENSE` or `index.js` (when they exist)

17−is fine.

21+Linking to other files, such as `license` or `index.js` (when they exist) is

22+fine.

1823

19−## Installation

24+This plugin does not check external URLs (see

25+[`remark-lint-no-dead-urls`][no-dead-urls]) or undefined references

26+(see [`remark-lint-no-undefined-references`][no-undef-refs]).

2027

21−[npm](https://docs.npmjs.com/cli/install):

28+## Contents

2229

23−```bash

24−npm install mdast-validate-links

30+* [Install](#install)

31+* [Use](#use)

32+ * [CLI](#cli)

33+ * [API](#api)

34+* [Configuration](#configuration)

35+* [Integration](#integration)

36+* [Security](#security)

37+* [Related](#related)

38+* [Contribute](#contribute)

39+* [License](#license)

40+

41+## Install

42+

43+[npm][]:

44+

45+```sh

46+npm install remark-validate-links

2547```

2648

27−## Command line

49+## Use

2850

29−![Example of how mdast-validate-links looks on screen](https://cdn.rawgit.com/wooorm/mdast-validate-links/master/screen-shot.png)

51+### CLI

3052

31−Use **mdast-validate-links** together with [**mdast**](https://github.com/wooorm/mdast)

32−and [**mdast-slug**](https://github.com/wooorm/mdast-slug):

53+Use `remark-validate-links` together with [**remark**][remark]:

3354

3455```bash

35−npm install --global mdast mdast-slug mdast-validate-links

56+npm install --global remark-cli remark-validate-links

3657```

3758

3859Let’s say `readme.md` is this document, and `example.md` looks as follows:

3960

40−```md

61+```markdown

4162# Hello

4263

4364Read more [whoops, this does not exist](#world).

4465

4566This doesn’t exist either [whoops!](readme.md#foo).

4667

47−But this does exist: [LICENSE](LICENSE).

68+But this does exist: [license](license).

4869

4970So does this: [README](readme.md#installation).

5071```

5172

52−Then, to run **mdast-validate-links** on `example.md` and `readme.md`:

73+Now, running `remark -u validate-links .` yields:

5374

54−```bash

55−mdast -u mdast-slug -u mdast-validate-links example.md

56−#

57−# Yields:

58−#

59−# example.md

60−# 3:11 warning Link to unknown heading: `world`

61−# 5:27 warning Link to unknown heading in `readme.md`: `foo`

62−#

63−# ✖ 2 problems (0 errors, 2 warnings)

75+```text

76+example.md

77+ 3:11-3:48 warning Link to unknown heading: `world` missing-heading remark-validate-links

78+ 5:27-5:51 warning Link to unknown heading in `readme.md`: `foo` missing-heading-in-file remark-validate-links

79+

80+readme.md: no issues found

81+

82+⚠ 2 warnings

6483```

6584

66−## Programmatic

85+> Note: passing a file over stdin(4) may not work as expected, because it is not

86+> known where the file originates from.

87+

88+### API

89+

90+> Note: The API checks links to headings and files.

91+> It does not check headings in other files.

92+> In a browser, only local links to headings are checked.

93+

94+Say we have the following file, `example.md`:

95+

96+```markdown

97+# Alpha

6798

68−This plug-in is **not** available on the API of mdast.

99+Links are checked:

100+

101+This [exists](#alpha).

102+This [one does not](#does-not).

103+

104+# Bravo

105+

106+Headings in `readme.md` are [checked](readme.md#nosuchheading).

107+And [missing files are reported](missing-example.js).

108+

109+Definitions are also checked:

110+

111+[alpha]: #alpha

112+[charlie]: #charlie

113+

114+References w/o definitions are not checked: [delta]

115+```

116+

117+And our script, `example.js`, looks as follows:

118+

119+```js

120+var vfile = require('to-vfile')

121+var report = require('vfile-reporter')

122+var remark = require('remark')

123+var links = require('remark-validate-links')

124+

125+remark()

126+ .use(links)

127+ .process(vfile.readSync('example.md'), function (err, file) {

128+ console.error(report(err || file))

129+ })

130+```

131+

132+Now, running `node example` yields:

133+

134+```markdown

135+example.md

136+ 6:6-6:31 warning Link to unknown heading: `does-not` missing-heading remark-validate-links

137+ 11:5-11:53 warning Link to unknown file: `missing-example.js` missing-file remark-validate-links

138+ 16:1-16:20 warning Link to unknown heading: `charlie` missing-heading remark-validate-links

139+

140+⚠ 3 warnings

141+```

142+

143+(Note that `readme.md#nosuchheading` is not warned about, because the API

144+does not check headings in other Markdown files).

69145

70146## Configuration

71147

72−You can pass a `repository`, containing anything `package.json`s

73−[`repository`](https://docs.npmjs.com/files/package.json#repository) can

74−handle. If this is omitted, **mdast-validate-links** will try

75−the `package.json` in your current working directory.

148+Typically, you don’t need to configure `remark-validate-links`, as it detects

149+local Git repositories.

150+If one is detected that references a known Git host (GitHub, GitLab,

151+or Bitbucket), some extra links can be checked.

152+If one is detected that does not reference a known Git host, local links still

153+work as expected.

154+If you’re not in a Git repository, you must pass `repository: false` explicitly.

76155

77−```bash

78−mdast --use 'validate-links=repository:"foo/bar"' example.md

156+You can pass a `repository` (`string?`, `false`).

157+If `repository` is nullish, the Git origin remote is detected.

158+If the repository resolves to something [npm understands][package-repository]

159+as a Git host such as GitHub, GitLab, or Bitbucket, full URLs to that host

160+(say, `https://github.com/remarkjs/remark-validate-links/readme.md#install`)

161+can also be checked.

162+

163+```sh

164+remark --use 'validate-links=repository:"foo/bar"' example.md

79165```

80166

81−When a repository is given or detected, links to GitHub are normalized

82−to the file-system. E.g., `https://github.com/foo/bar/blob/master/example.md`

83−becomes `example.md`.

167+For this to work, a `root` (`string?`) is also used, referencing the local Git

168+root directory (the place where `.git` is).

169+If both `root` and `repository` are nullish, the Git root is detected.

170+If `root` is not given but `repository` is, [`file.cwd`][cwd] is used.

84171

85−You can define this repository in `.mdastrc` or `package.json` [files](https://github.com/wooorm/mdast/blob/master/doc/mdastrc.5.md)

86−too. An example `.mdastrc` file could look as follows:

172+You can define this repository in [configuration files][cli] too.

173+An example `.remarkrc` file could look as follows:

87174

88175```json

89176{

90− "plugins": {

91− "slug": {

92− "library": "github"

93− },

94− "validate-links": {

95− "repository": "foo/bar"

96− }

97− }

177+ "plugins": [

178+ [

179+ "validate-links",

180+ {

181+ "repository": "foo/bar"

182+ }

183+ ]

184+ ]

185+}

186+```

187+

188+If you’re self-hosting a Git server, you can provide URL information directly,

189+as `urlConfig` (`Object`).

190+

191+For this repository, `urlConfig` looks as follows:

192+

193+```js

194+{

195+ // Domain of URLs:

196+ hostname: 'github.com',

197+ // Path prefix before files:

198+ prefix: '/remarkjs/remark-validate-links/blob/',

199+ // Prefix of headings:

200+ headingPrefix: '#',

201+ // Whether lines in files can be linked:

202+ lines: true

203+}

204+```

205+

206+If this project were hosted on Bitbucket, it would be:

207+

208+```js

209+{

210+ hostname: 'bitbucket.org',

211+ prefix: '/remarkjs/remark-validate-links/src/',

212+ headingPrefix: '#markdown-header-',

213+ lines: false

98214}

99215```

100216

217+## Integration

218+

219+`remark-validate-links` can detect anchors on nodes through several properties

220+on nodes:

221+

222+* `node.data.hProperties.name` — Used by [`remark-html`][remark-html]

223+ to create a `name` attribute, which anchors can link to

224+* `node.data.hProperties.id` — Used by [`remark-html`][remark-html]

225+ to create an `id` attribute, which anchors can link to

226+* `node.data.id` — Used, in the future, by other tools to signal

227+ unique identifiers on nodes

228+

229+## Security

230+

231+`remark-validate-links`, in Node, accesses the file system based on user

232+content, and this may be dangerous.

233+In Node `git remote` and `git rev-parse` also runs for processed files.

234+

235+The tree is not modified, so there are no openings for

236+[cross-site scripting (XSS)][xss] attacks.

237+

238+## Related

239+

240+* [`remark-lint`][remark-lint] — Markdown code style linter

241+* [`remark-lint-no-dead-urls`][no-dead-urls] — Ensure external links are alive

242+

243+## Contribute

244+

245+See [`contributing.md`][contributing] in [`remarkjs/.github`][health] for ways

246+to get started.

247+See [`support.md`][support] for ways to get help.

248+

249+This project has a [code of conduct][coc].

250+By interacting with this repository, organization, or community you agree to

251+abide by its terms.

252+

101253## License

102254

103−[MIT](LICENSE) © [Titus Wormer](http://wooorm.com)

255+[MIT][license] © [Titus Wormer][author]

256+

257+

258+

259+[build-badge]: https://img.shields.io/travis/remarkjs/remark-validate-links/main.svg

260+

261+[build]: https://travis-ci.org/remarkjs/remark-validate-links

262+

263+[coverage-badge]: https://img.shields.io/codecov/c/github/remarkjs/remark-validate-links.svg

264+

265+[coverage]: https://codecov.io/github/remarkjs/remark-validate-links

266+

267+[downloads-badge]: https://img.shields.io/npm/dm/remark-validate-links.svg

268+

269+[downloads]: https://www.npmjs.com/package/remark-validate-links

270+

271+[size-badge]: https://img.shields.io/bundlephobia/minzip/remark-validate-links.svg

272+

273+[size]: https://bundlephobia.com/result?p=remark-validate-links

274+

275+[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg

276+

277+[backers-badge]: https://opencollective.com/unified/backers/badge.svg

278+

279+[collective]: https://opencollective.com/unified

280+

281+[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg

282+

283+[chat]: https://github.com/remarkjs/remark/discussions

284+

285+[npm]: https://docs.npmjs.com/cli/install

286+

287+[health]: https://github.com/remarkjs/.github

288+

289+[contributing]: https://github.com/remarkjs/.github/blob/HEAD/contributing.md

290+

291+[support]: https://github.com/remarkjs/.github/blob/HEAD/support.md

292+

293+[coc]: https://github.com/remarkjs/.github/blob/HEAD/code-of-conduct.md

294+

295+[license]: license

296+

297+[author]: https://wooorm.com

298+

299+[remark]: https://github.com/remarkjs/remark

300+

301+[cli]: https://github.com/remarkjs/remark/tree/HEAD/packages/remark-cli#readme

302+

303+[remark-lint]: https://github.com/remarkjs/remark-lint

304+

305+[remark-html]: https://github.com/remarkjs/remark-html

306+

307+[no-dead-urls]: https://github.com/davidtheclark/remark-lint-no-dead-urls

308+

309+[no-undef-refs]: https://github.com/remarkjs/remark-lint/tree/master/packages/remark-lint-no-undefined-references

310+

311+[package-repository]: https://docs.npmjs.com/files/package.json#repository

312+

313+[cwd]: https://github.com/vfile/vfile#vfilecwd

314+

315+[xss]: https://en.wikipedia.org/wiki/Cross-site_scripting

screen-shot.pngdeleted

Binary file not shown.

test/fixtures/bitbucket.mdnew file+67

@@ -0,0 +1,67 @@

1+# Hello

3+This is a valid relative heading [link](#markdown-header-hello).

5+This is an invalid relative heading [link](#markdown-header-world).

7+This is an ignored hash [link](#world).

9+## Files

10+

11+This is a valid relative file [link](https://bitbucket.org/wooorm/test/src/main/examples/bitbucket.md).

12+

13+So is this [link](https://bitbucket.org/wooorm/test/src/foo-bar/examples/bitbucket.md).

14+

15+And this [link](./examples/bitbucket.md).

16+

17+And this [link](examples/bitbucket.md).

18+

19+This is a valid external [file](../index.js).

20+

21+This is an invalid relative file [link](https://bitbucket.org/wooorm/test/src/main/examples/world.md).

22+

23+So is this [link](https://bitbucket.org/wooorm/test/src/foo-bar/examples/world.md).

24+

25+And this [link](./examples/world.md).

26+

27+And this [link](examples/world.md).

28+

29+## Combination

30+

31+Valid: [a](./examples/bitbucket.md#markdown-header-hello).

32+

33+Valid: [b](examples/bitbucket.md#markdown-header-hello).

34+

35+Valid: [c](https://bitbucket.org/wooorm/test/src/main/examples/bitbucket.md#markdown-header-hello).

36+

37+Valid: [d](https://bitbucket.org/wooorm/test/src/foo-bar/examples/bitbucket.md#markdown-header-hello).

38+

39+Invalid: [e](./examples/bitbucket.md#markdown-header-world).

40+

41+Invalid: [f](examples/bitbucket.md#markdown-header-world).

42+

43+Invalid: [g](https://bitbucket.org/wooorm/test/src/main/examples/bitbucket.md#markdown-header-world).

44+

45+Invalid: [h](https://bitbucket.org/wooorm/test/src/foo-bar/examples/bitbucket.md#markdown-header-world).

46+

47+Invalid: [i](./examples/world.md#markdown-header-hello).

48+

49+Invalid: [j](examples/world.md#markdown-header-hello).

50+

51+Invalid: [k](https://bitbucket.org/wooorm/test/src/main/examples/world.md#markdown-header-hello).

52+

53+Invalid: [l](https://bitbucket.org/wooorm/test/src/foo-bar/examples/world.md#markdown-header-hello).

54+

55+This is an ignored hash [j](https://bitbucket.org/wooorm/test/src/foo-bar/examples/bitbucket.md#world).

56+

57+## External

58+

59+These are all invalid, because they do not link to Bitbucket.

60+

61+Valid: [a](irc://foo).

62+

63+Valid: [b](http://example.com).

64+

65+Valid: [b](http://example.com/foo/bar/baz).

66+

67+Valid: [b](http://github.com/wooorm/test/blob/foo-bar/examples/world.md#markdown-header-hello).

test/fixtures/case-insensitive-headings.mdnew file+9

@@ -0,0 +1,9 @@

1+# Hello

3+This is fine: [link](#HELLO).

5+This isn’t: [link](#WORLD).

7+Also fine: [link](examples/github.md#HELLO).

9+Also not fine: [link](examples/github.md#WORLD).

test/fixtures/empty.mdnew file+1

@@ -0,0 +1 @@

1+No links!

test/fixtures/examples/bitbucket.mdnew file+39

@@ -0,0 +1,39 @@

1+# Hello

3+This is a valid relative heading [link](#markdown-header-hello).

5+This is an invalid relative heading [link](#markdown-header-world).

7+## Files

9+This is a valid relative file [link](https://bitbucket.org/wooorm/test/src/main/bitbucket.md).

10+

11+So is this [link](https://bitbucket.org/wooorm/test/src/foo-bar/bitbucket.md).

12+

13+And this [link](../bitbucket.md).

14+

15+This is an invalid relative file [link](https://bitbucket.org/wooorm/test/src/main/world.md).

16+

17+So is this [link](https://bitbucket.org/wooorm/test/src/foo-bar/world.md).

18+

19+And this [link](../world.md).

20+

21+## Combination

22+

23+Valid: [a](../bitbucket.md#markdown-header-hello).

24+

25+Valid: [b](https://bitbucket.org/wooorm/test/src/main/bitbucket.md#markdown-header-hello).

26+

27+Valid: [c](https://bitbucket.org/wooorm/test/src/foo-bar/bitbucket.md#markdown-header-hello).

28+

29+Invalid: [d](../bitbucket.md#markdown-header-world).

30+

31+Invalid: [e](https://bitbucket.org/wooorm/test/src/main/bitbucket.md#markdown-header-world).

32+

33+Invalid: [f](https://bitbucket.org/wooorm/test/src/foo-bar/bitbucket.md#markdown-header-world).

34+

35+Invalid: [g](../world.md#markdown-header-hello).

36+

37+Invalid: [h](https://bitbucket.org/wooorm/test/src/main/world.md#markdown-header-hello).

38+

39+Invalid: [i](https://bitbucket.org/wooorm/test/src/foo-bar/world.md#markdown-header-hello).

test/fixtures/examples/example.jsnew file+1

@@ -0,0 +1 @@

1+console.log('Hello world!')

test/fixtures/examples/example.mddeleted−39

@@ -1,39 +0,0 @@

1−# Hello

2−

3−This is a valid relative heading [link](#hello).

4−

5−This is an invalid relative heading [link](#world).

6−

7−## Files

8−

9−This is a valid relative file [link](https://github.com/wooorm/test/blob/master/example.md).

10−

11−So is this [link](https://github.com/wooorm/test/blob/foo-bar/example.md).

12−

13−And this [link](../example.md).

14−

15−This is an invalid relative file [link](https://github.com/wooorm/test/blob/master/world.md).

16−

17−So is this [link](https://github.com/wooorm/test/blob/foo-bar/world.md).

18−

19−And this [link](../world.md).

20−

21−## Combination

22−

23−Valid: [a](../example.md#hello).

24−

25−Valid: [b](https://github.com/wooorm/test/blob/master/example.md#hello).

26−

27−Valid: [c](https://github.com/wooorm/test/blob/foo-bar/example.md#hello).

28−

29−Invalid: [d](../example.md#world).

30−

31−Invalid: [e](https://github.com/wooorm/test/blob/master/example.md#world).

32−

33−Invalid: [f](https://github.com/wooorm/test/blob/foo-bar/example.md#world).

34−

35−Invalid: [g](../world.md#hello).

36−

37−Invalid: [h](https://github.com/wooorm/test/blob/master/world.md#hello).

38−

39−Invalid: [i](https://github.com/wooorm/test/blob/foo-bar/world.md#hello).

test/fixtures/examples/github.mdnew file+39

@@ -0,0 +1,39 @@

1+# Hello

3+This is a valid relative heading [link](#hello).

5+This is an invalid relative heading [link](#world).

7+## Files

9+This is a valid relative file [link](https://github.com/wooorm/test/blob/main/github.md).

10+

11+So is this [link](https://github.com/wooorm/test/blob/foo-bar/github.md).

12+

13+And this [link](../github.md).

14+

15+This is an invalid relative file [link](https://github.com/wooorm/test/blob/main/world.md).

16+

17+So is this [link](https://github.com/wooorm/test/blob/foo-bar/world.md).

18+

19+And this [link](../world.md).

20+

21+## Combination

22+

23+Valid: [a](../github.md#hello).

24+

25+Valid: [b](https://github.com/wooorm/test/blob/main/github.md#hello).

26+

27+Valid: [c](https://github.com/wooorm/test/blob/foo-bar/github.md#hello).

28+

29+Invalid: [d](../github.md#world).

30+

31+Invalid: [e](https://github.com/wooorm/test/blob/main/github.md#world).

32+

33+Invalid: [f](https://github.com/wooorm/test/blob/foo-bar/github.md#world).

34+

35+Invalid: [g](../world.md#hello).

36+

37+Invalid: [h](https://github.com/wooorm/test/blob/main/world.md#hello).

38+

39+Invalid: [i](https://github.com/wooorm/test/blob/foo-bar/world.md#hello).

test/fixtures/examples/gitlab.mdnew file+39

@@ -0,0 +1,39 @@

1+# Hello

3+This is a valid relative heading [link](#hello).

5+This is an invalid relative heading [link](#world).

7+## Files

9+This is a valid relative file [link](https://gitlab.com/wooorm/test/blob/main/gitlab.md).

10+

11+So is this [link](https://gitlab.com/wooorm/test/blob/foo-bar/gitlab.md).

12+

13+And this [link](../gitlab.md).

14+

15+This is an invalid relative file [link](https://gitlab.com/wooorm/test/blob/main/world.md).

16+

17+So is this [link](https://gitlab.com/wooorm/test/blob/foo-bar/world.md).

18+

19+And this [link](../world.md).

20+

21+## Combination

22+

23+Valid: [a](../gitlab.md#hello).

24+

25+Valid: [b](https://gitlab.com/wooorm/test/blob/main/gitlab.md#hello).

26+

27+Valid: [c](https://gitlab.com/wooorm/test/blob/foo-bar/gitlab.md#hello).

28+

29+Invalid: [d](../gitlab.md#world).

30+

31+Invalid: [e](https://gitlab.com/wooorm/test/blob/main/gitlab.md#world).

32+

33+Invalid: [f](https://gitlab.com/wooorm/test/blob/foo-bar/gitlab.md#world).

34+

35+Invalid: [g](../world.md#hello).

36+

37+Invalid: [h](https://gitlab.com/wooorm/test/blob/main/world.md#hello).

38+

39+Invalid: [i](https://gitlab.com/wooorm/test/blob/foo-bar/world.md#hello).

test/fixtures/examples/image with space.jpgnew file

Binary file not shown.

test/fixtures/examples/image.jpgnew file

Binary file not shown.

test/fixtures/examples/weird#character/readme.mdnew file+1

@@ -0,0 +1 @@

1+# Hello

test/fixtures/examples/weird#characters.mdnew file+1

@@ -0,0 +1 @@

1+# Hello

test/fixtures/external.mdnew file+11

@@ -0,0 +1,11 @@

1+# Links to external websites

3+Link to [another website](https://mochajs.org)

5+Link to [another website with an anchor](https://mochajs.org/#exclusive-tests)

7+Link to [GitHub](https://experiments.github.com)

9+Link to [`github.com`](https://github.com/pulls)

10+

11+Link to [a repo on GitHub](https://github.com/foo/bar)

test/fixtures/file-as-folder.mdnew file+1

@@ -0,0 +1 @@

1+[](file-as-folder.md/other)

test/fixtures/folder-without-readme/example.mdnew file+1

@@ -0,0 +1 @@

1+This file isn’t used when linking to the folder: it has to be a `readme`.

test/fixtures/folder.mdnew file+23

@@ -0,0 +1,23 @@

1+Here we link to a folder:

3+Explicit:

5+[OK](./folder/readme.markdown#this)

7+[OK](./folder/readme.markdown#that)

9+[NOK](./folder/readme.markdown#missing)

10+

11+Implicit:

12+

13+[OK](./folder#this)

14+

15+[OK](./folder#that)

16+

17+[NOK](./folder#missing)

18+

19+Other:

20+

21+[NOK](./missing#missing)

22+

23+[NOK](./folder-without-readme#missing)

test/fixtures/folder/example.mdnew file+1

@@ -0,0 +1 @@

1+This file isn’t used when linking to the folder: it has to be a `readme`.

test/fixtures/folder/readme.ascnew file+9

@@ -0,0 +1,9 @@

1+readme

2+------

4+While GitHub would pick up on this readme for the folder,

5+`remark-validate-links` is for Markdown, so we ignore AsciiDoc.

7+== This

9+== That

test/fixtures/folder/readme.markdownnew file+5

@@ -0,0 +1,5 @@

1+# readme

3+## This

5+## That

test/fixtures/folder/readme.mdnew file+1

@@ -0,0 +1 @@

1+This one isn’t used (`readme.markdown` sorts before `readme.md`).

test/fixtures/example.md → test/fixtures/github.mdrenamed+22−14

@@ -6,17 +6,21 @@ This is an invalid relative heading [link](#world).

77## Files

9−This is a valid relative file [link](https://github.com/wooorm/test/blob/master/examples/example.md).

9+This is a valid relative file [link](https://github.com/wooorm/test/blob/main/examples/github.md).

1010

11−So is this [link](https://github.com/wooorm/test/blob/foo-bar/examples/example.md).

11+This is a valid absolute file [link](/wooorm/test/blob/main/examples/github.md).

1212

13−And this [link](./examples/example.md).

13+So is this [link](https://github.com/wooorm/test/blob/foo-bar/examples/github.md).

1414

15−And this [link](examples/example.md).

15+And this [link](./examples/github.md).

16+

17+And this [link](examples/github.md).

1618

1719This is a valid external [file](../index.js).

1820

19−This is an invalid relative file [link](https://github.com/wooorm/test/blob/master/examples/world.md).

21+This is an invalid relative file [link](https://github.com/wooorm/test/blob/main/examples/world.md).

22+

23+This is an invalid absolute file [link](/wooorm/test/blob/main/examples/world.md).

2024

2125So is this [link](https://github.com/wooorm/test/blob/foo-bar/examples/world.md).

2226

@@ -26,27 +30,27 @@ And this [link](examples/world.md).

2630

2731## Combination

2832

29−Valid: [a](./examples/example.md#hello).

33+Valid: [a](./examples/github.md#hello).

3034

31−Valid: [b](examples/example.md#hello).

35+Valid: [b](examples/github.md#hello).

3236

33−Valid: [c](https://github.com/wooorm/test/blob/master/examples/example.md#hello).

37+Valid: [c](https://github.com/wooorm/test/blob/main/examples/github.md#hello).

3438

35−Valid: [d](https://github.com/wooorm/test/blob/foo-bar/examples/example.md#hello).

39+Valid: [d](https://github.com/wooorm/test/blob/foo-bar/examples/github.md#hello).

3640

37−Invalid: [e](./examples/example.md#world).

41+Invalid: [e](./examples/github.md#world).

3842

39−Invalid: [f](examples/example.md#world).

43+Invalid: [f](examples/github.md#world).

4044

41−Invalid: [g](https://github.com/wooorm/test/blob/master/examples/example.md#world).

45+Invalid: [g](https://github.com/wooorm/test/blob/main/examples/github.md#world).

4246

43−Invalid: [h](https://github.com/wooorm/test/blob/foo-bar/examples/example.md#world).

47+Invalid: [h](https://github.com/wooorm/test/blob/foo-bar/examples/github.md#world).

4448

4549Invalid: [i](./examples/world.md#hello).

4650

4751Invalid: [j](examples/world.md#hello).

4852

49−Invalid: [k](https://github.com/wooorm/test/blob/master/examples/world.md#hello).

53+Invalid: [k](https://github.com/wooorm/test/blob/main/examples/world.md#hello).

5054

5155Invalid: [l](https://github.com/wooorm/test/blob/foo-bar/examples/world.md#hello).

5256

@@ -61,3 +65,7 @@ Valid: [b](http://example.com).

6165Valid: [b](http://example.com/foo/bar/baz).

6266

6367Valid: [b](http://bitbucket.com/wooorm/test/blob/foo-bar/examples/world.md#hello).

68+

69+## Top Anchor

70+

71+This links to the start of the document [link](#readme).

test/fixtures/gitlab.mdnew file+67

@@ -0,0 +1,67 @@

1+# Hello

3+This is a valid relative heading [link](#hello).

5+This is an invalid relative heading [link](#world).

7+## Files

9+This is a valid relative file [link](https://gitlab.com/wooorm/test/blob/main/examples/gitlab.md).

10+

11+So is this [link](https://gitlab.com/wooorm/test/blob/foo-bar/examples/gitlab.md).

12+

13+And this [link](./examples/gitlab.md).

14+

15+And this [link](examples/gitlab.md).

16+

17+This is a valid external [file](../index.js).

18+

19+This is an invalid relative file [link](https://gitlab.com/wooorm/test/blob/main/examples/world.md).

20+

21+So is this [link](https://gitlab.com/wooorm/test/blob/foo-bar/examples/world.md).

22+

23+And this [link](./examples/world.md).

24+

25+And this [link](examples/world.md).

26+

27+## Combination

28+

29+Valid: [a](./examples/gitlab.md#hello).

30+

31+Valid: [b](examples/gitlab.md#hello).

32+

33+Valid: [c](https://gitlab.com/wooorm/test/blob/main/examples/gitlab.md#hello).

34+

35+Valid: [d](https://gitlab.com/wooorm/test/blob/foo-bar/examples/gitlab.md#hello).

36+

37+Invalid: [e](./examples/gitlab.md#world).

38+

39+Invalid: [f](examples/gitlab.md#world).

40+

41+Invalid: [g](https://gitlab.com/wooorm/test/blob/main/examples/gitlab.md#world).

42+

43+Invalid: [h](https://gitlab.com/wooorm/test/blob/foo-bar/examples/gitlab.md#world).

44+

45+Invalid: [i](./examples/world.md#hello).

46+

47+Invalid: [j](examples/world.md#hello).

48+

49+Invalid: [k](https://gitlab.com/wooorm/test/blob/main/examples/world.md#hello).

50+

51+Invalid: [l](https://gitlab.com/wooorm/test/blob/foo-bar/examples/world.md#hello).

52+

53+## External

54+

55+These are all invalid, because they do not link to GitLab.

56+

57+Valid: [a](irc://foo).

58+

59+Valid: [b](http://example.com).

60+

61+Valid: [b](http://example.com/foo/bar/baz).

62+

63+Valid: [b](http://bitbucket.com/wooorm/test/blob/foo-bar/examples/world.md#hello).

64+

65+## Top Anchor

66+

67+This links to the start of the document [link](#readme).

test/fixtures/images.mdnew file+39

@@ -0,0 +1,39 @@

1+# Image references

3+

5+Relative ![image](./examples/image.jpg)

7+No `./` in ![image](examples/image.jpg)

9+Absolute ![image](https://github.com/wooorm/test/blob/main/examples/image.jpg)

10+

11+Relative ![image reference][rel]

12+

13+Absolute ![image reference][abs]

14+

15+Relative with whitespace ![image reference][rel-whitespace]

16+

17+

18+

19+Relative ![missing image](./examples/missing.jpg)

20+

21+No `./` in ![image](examples/missing.jpg)

22+

23+Absolute ![missing image](https://github.com/wooorm/test/blob/main/examples/missing.jpg)

24+

25+Relative ![missing image reference][rel-missing]

26+

27+Absolute ![missing image reference][abs-missing]

28+

29+

30+

31+[rel]: ./examples/image.jpg

32+

33+[abs]: https://github.com/wooorm/test/blob/main/examples/image.jpg

34+

35+[rel-missing]: ./examples/missing.jpg

36+

37+[abs-missing]: https://github.com/wooorm/test/blob/main/examples/missing.jpg

38+

39+[rel-whitespace]: "./examples/image with space.jpg"

test/fixtures/line-links.mdnew file+9

@@ -0,0 +1,9 @@

1+# Source Code Link

3+Link to [a line](./examples/example.js#L1)

5+Link to [a line in a missing file](./examples/missing.js#L1)

7+[a](https://github.com/wooorm/test/blob/main/examples/example.js#L1).

9+[b](https://github.com/wooorm/test/blob/main/examples/missing.js#L1).

test/fixtures/query-params.mdnew file+9

@@ -0,0 +1,9 @@

1+# Query params

3+Link to relative heading ![link](?foo=bar#query-params)

5+Link to an ![image](./examples/image.jpg?foo=bar)

7+And a file [link](./examples/github.md?foo=bar).

9+Question mark in hash (invalid) [link](#query-params?).

test/fixtures/self-hosted.mdnew file+5

@@ -0,0 +1,5 @@

1+# Hello

3+[Fine](https://gitlab.acme.com/acme/project/blob/main/self-hosted.md#hello);

5+[Not fine](https://gitlab.acme.com/acme/project/blob/main/self-hosted.md#world);

test/fixtures/small.mdnew file+5

@@ -0,0 +1,5 @@

1+# Hello

3+This is fine: [link](#hello).

5+This isn’t: [link](#world).

test/fixtures/suggestions.mdnew file+11

@@ -0,0 +1,11 @@

1+# Hello

3+This should suggest: [link](#helloo).

5+## Files

7+So should this: [k](github.md#fiiiles).

9+##

10+

11+An empty header.

test/fixtures/weird-characters.mdnew file+17

@@ -0,0 +1,17 @@

1+# File names and paths with weird characters

3+OK: Link to [a weird character in a file name](./examples/weird%23characters.md)

5+OK: Link to [a weird character in a file path](./examples/weird%23character/readme.md)

7+OK: Link to [a heading with a weird character in a file name](./examples/weird%23characters.md#hello)

9+OK: Link to [a heading with a weird character in a file path](./examples/weird%23character/readme.md#hello)

10+

11+Not OK: Link to [a weird character in a file name](./examples/missing%23characters.md)

12+

13+Not OK: Link to [a weird character in a file path](./examples/missing%23character/readme.md)

14+

15+Not OK: Link to [a missing heading with a weird character in a file name](./examples/weird%23characters.md#world)

16+

17+Not OK: Link to [a missing heading with a weird character in a file path](./examples/weird%23character/readme.md#world)

test/index.js+1302−432

@@ -1,432 +1,1302 @@

1−'use strict';

2−

3−/* eslint-env mocha */

4−

5−/*

6− * Dependencies.

7− */

8−

9−var assert = require('assert');

10−var fs = require('fs');

11−var cept = require('cept');

12−var mdast = require('mdast');

13−var cli = require('mdast/lib/cli');

14−var links = require('..');

15−

16−/*

17− * Cache to store output and errors by mdast.

18− */

19−

20−var std = {

21− 'out': [],

22− 'err': []

23−};

24−

25−/**

26− * Factory to store a bound type.

27− *

28− * @param {string} type - `"out"` or `"err"`.

29− * @return {Function} - Stores the bound type.

30− */

31−function queue(type) {

32− /**

33− * Store a bound type.

34− */

35− return function () {

36− std[type].push([].slice.call(arguments).join(''));

37− };

38−}

39−

40−/**

41− * Intercept both `console.log` to `std.out` and

42− * `console.error` to `std.err`;

43− *

44− * @return {Function} - Stores output.

45− */

46−function intercept() {

47− var stopOut = cept(console, 'log', queue('out'));

48− var stopErr = cept(console, 'error', queue('err'));

49−

50− /**

51− * Stops intercepting. Returns the captured `std`.

52− *

53− * @return {Object} - Output.

54− */

55− return function () {

56− var current = {

57− 'out': std.out.join('\n').trim(),

58− 'err': std.err.join('\n').trim()

59− };

60−

61− stopOut();

62− stopErr();

63−

64− std.out = [];

65− std.err = [];

66−

67− return current;

68− };

69−}

70−

71−/*

72− * Tests.

73− */

74−

75−describe('mdast-validate-links', function () {

76− beforeEach(function () {

77− process.chdir('./test/fixtures');

78− });

79−

80− afterEach(function () {

81− process.chdir('../..');

82− });

83−

84− it('should throw an error when not on the CLI', function () {

85− assert.throws(function () {

86− mdast().use(links);

87− }, /Error: mdast-validate-links only works on the CLI/);

88− });

89−

90− it('should warn when used without slugs', function (done) {

91− var stop = intercept();

92−

93− cli({

94− 'files': 'example.md',

95− 'color': false,

96− 'detectRC': false,

97− 'detectIgnore': false,

98− 'plugins': [

99− '../../../index.js'

100− ]

101− }, function (err) {

102− var res = stop();

103−

104− assert.equal(res.err, [

105− 'example.md: done.',

106− ' 0:0 error Missing slugs. Use for example `mdast-slug` ' +

107− 'to generate heading IDs',

108− '',

109− '✖ 1 problem (1 error, 0 warnings)'

110− ].join('\n'));

111−

112− done(err);

113− });

114− });

115−

116− it('should ignore unfound files', function (done) {

117− var stop = intercept();

118−

119− cli({

120− 'files': ['definitions.md', 'FOOOO'],

121− 'color': false,

122− 'detectRC': false,

123− 'detectIgnore': false,

124− 'plugins': [

125− '../../../node_modules/mdast-slug',

126− '../../../index.js'

127− ]

128− }, function (err) {

129− var res = stop();

130−

131− assert.equal(res.out, '');

132−

133− assert.equal(res.err, [

134− 'FOOOO: done.',

135− ' 0:0 error No such file or directory',

136− '',

137− '✖ 1 problem (1 error, 0 warnings)',

138− '',

139− '',

140− 'definitions.md: done.',

141− ' 5:12 warning Link to unknown heading: `world`',

142− '',

143− '✖ 1 problem (0 errors, 1 warning)'

144− ].join('\n'));

145−

146− done(err);

147− });

148− });

149−

150− it('should work when not all files are given', function (done) {

151− var stop = intercept();

152−

153− cli({

154− 'files': 'example.md',

155− 'color': false,

156− 'detectRC': false,

157− 'detectIgnore': false,

158− 'plugins': [

159− '../../../node_modules/mdast-slug',

160− '../../../index.js'

161− ]

162− }, function (err) {

163− var res = stop();

164−

165− assert.equal(res.err, [

166− 'example.md: done.',

167− ' 5:37 warning Link to unknown heading: `world`',

168− ' 23:10 warning Link to unknown file: `examples/world.md`',

169− ' 25:10 warning Link to unknown file: `examples/world.md`',

170− ' 45:10 warning Link to unknown file: `examples/world.md`',

171− ' 47:10 warning Link to unknown file: `examples/world.md`',

172− ' 37:10 warning Link to unknown heading in ' +

173− '`examples/example.md`: `world`',

174− ' 39:10 warning Link to unknown heading in ' +

175− '`examples/example.md`: `world`',

176− ' 45:10 warning Link to unknown heading in ' +

177− '`examples/world.md`: `hello`',

178− ' 47:10 warning Link to unknown heading in ' +

179− '`examples/world.md`: `hello`',

180− '',

181− '✖ 9 problems (0 errors, 9 warnings)'

182− ].join('\n'));

183−

184− done(err);

185− });

186− });

187−

188− it('should work when all files are given', function (done) {

189− var stop = intercept();

190−

191− cli({

192− 'files': [

193− 'example.md',

194− 'examples/example.md'

195− ],

196− 'color': false,

197− 'detectRC': false,

198− 'detectIgnore': false,

199− 'plugins': [

200− '../../../node_modules/mdast-slug',

201− '../../../index.js'

202− ]

203− }, function (err) {

204− var res = stop();

205−

206− assert.equal(res.out, '');

207−

208− assert.equal(res.err, [

209− 'example.md: done.',

210− ' 5:37 warning Link to unknown heading: `world`',

211− ' 23:10 warning Link to unknown file: `examples/world.md`',

212− ' 25:10 warning Link to unknown file: `examples/world.md`',

213− ' 45:10 warning Link to unknown file: `examples/world.md`',

214− ' 47:10 warning Link to unknown file: `examples/world.md`',

215− ' 37:10 warning Link to unknown heading in ' +

216− '`examples/example.md`: `world`',

217− ' 39:10 warning Link to unknown heading in ' +

218− '`examples/example.md`: `world`',

219− ' 45:10 warning Link to unknown heading in ' +

220− '`examples/world.md`: `hello`',

221− ' 47:10 warning Link to unknown heading in ' +

222− '`examples/world.md`: `hello`',

223− '',

224− '✖ 9 problems (0 errors, 9 warnings)',

225− '',

226− '',

227− 'examples/example.md: done.',

228− ' 5:37 warning Link to unknown heading: `world`',

229− ' 19:10 warning Link to unknown file: `world.md`',

230− ' 35:10 warning Link to unknown file: `world.md`',

231− ' 29:10 warning Link to unknown heading in ' +

232− '`example.md`: `world`',

233− ' 35:10 warning Link to unknown heading in ' +

234− '`world.md`: `hello`',

235− '',

236− '✖ 5 problems (0 errors, 5 warnings)'

237− ].join('\n'));

238−

239− done(err);

240− });

241− });

242−

243− it('should work with definitions', function (done) {

244− var stop = intercept();

245−

246− cli({

247− 'files': 'definitions.md',

248− 'color': false,

249− 'detectRC': false,

250− 'detectIgnore': false,

251− 'plugins': [

252− '../../../node_modules/mdast-slug',

253− '../../../index.js'

254− ]

255− }, function (err) {

256− var res = stop();

257−

258− assert.equal(res.err, [

259− 'definitions.md: done.',

260− ' 5:12 warning Link to unknown heading: `world`',

261− '',

262− '✖ 1 problem (0 errors, 1 warning)'

263− ].join('\n'));

264−

265− done(err);

266− });

267− });

268−

269− it('should work on GitHub URLs when given a repo', function (done) {

270− var stop = intercept();

271−

272− cli({

273− 'files': [

274− 'example.md',

275− 'examples/example.md'

276− ],

277− 'color': false,

278− 'detectRC': false,

279− 'detectIgnore': false,

280− 'plugins': {

281− '../../../node_modules/mdast-slug': null,

282− '../../../index.js': {

283− 'repository': 'wooorm/test'

284− }

285− }

286− }, function (err) {

287− var res = stop();

288−

289− assert.equal(res.out, '');

290−

291− assert.equal(res.err, [

292− 'example.md: done.',

293− ' 5:37 warning Link to unknown heading: `world`',

294− ' 19:34 warning Link to unknown file: `examples/world.md`',

295− ' 21:12 warning Link to unknown file: `examples/world.md`',

296− ' 23:10 warning Link to unknown file: `examples/world.md`',

297− ' 25:10 warning Link to unknown file: `examples/world.md`',

298− ' 45:10 warning Link to unknown file: `examples/world.md`',

299− ' 47:10 warning Link to unknown file: `examples/world.md`',

300− ' 49:10 warning Link to unknown file: `examples/world.md`',

301− ' 51:10 warning Link to unknown file: `examples/world.md`',

302− ' 37:10 warning Link to unknown heading in ' +

303− '`examples/example.md`: `world`',

304− ' 39:10 warning Link to unknown heading in ' +

305− '`examples/example.md`: `world`',

306− ' 41:10 warning Link to unknown heading in ' +

307− '`examples/example.md`: `world`',

308− ' 43:10 warning Link to unknown heading in ' +

309− '`examples/example.md`: `world`',

310− ' 45:10 warning Link to unknown heading in ' +

311− '`examples/world.md`: `hello`',

312− ' 47:10 warning Link to unknown heading in ' +

313− '`examples/world.md`: `hello`',

314− ' 49:10 warning Link to unknown heading in ' +

315− '`examples/world.md`: `hello`',

316− ' 51:10 warning Link to unknown heading in ' +

317− '`examples/world.md`: `hello`',

318− '',

319− '✖ 17 problems (0 errors, 17 warnings)',

320− '',

321− '',

322− 'examples/example.md: done.',

323− ' 5:37 warning Link to unknown heading: `world`',

324− ' 15:34 warning Link to unknown file: `world.md`',

325− ' 17:12 warning Link to unknown file: `world.md`',

326− ' 19:10 warning Link to unknown file: `world.md`',

327− ' 35:10 warning Link to unknown file: `world.md`',

328− ' 37:10 warning Link to unknown file: `world.md`',

329− ' 39:10 warning Link to unknown file: `world.md`',

330− ' 29:10 warning Link to unknown heading in ' +

331− '`example.md`: `world`',

332− ' 31:10 warning Link to unknown heading in ' +

333− '`example.md`: `world`',

334− ' 33:10 warning Link to unknown heading in ' +

335− '`example.md`: `world`',

336− ' 35:10 warning Link to unknown heading in ' +

337− '`world.md`: `hello`',

338− ' 37:10 warning Link to unknown heading in ' +

339− '`world.md`: `hello`',

340− ' 39:10 warning Link to unknown heading in ' +

341− '`world.md`: `hello`',

342− '',

343− '✖ 13 problems (0 errors, 13 warnings)'

344− ].join('\n'));

345−

346− done(err);

347− });

348− });

349−

350− it('should work on GitHub URLs when with package.json', function (done) {

351− var stop = intercept();

352−

353− fs.writeFileSync('./package.json', JSON.stringify({

354− 'repository': 'wooorm/test'

355− }, 0, 2));

356−

357− cli({

358− 'files': [

359− 'example.md',

360− 'examples/example.md'

361− ],

362− 'color': false,

363− 'detectRC': false,

364− 'detectIgnore': false,

365− 'plugins': [

366− '../../../node_modules/mdast-slug',

367− '../../../index.js'

368− ]

369− }, function (err) {

370− var res = stop();

371−

372− fs.unlinkSync('./package.json');

373−

374− assert.equal(res.err, [

375− 'example.md: done.',

376− ' 5:37 warning Link to unknown heading: `world`',

377− ' 19:34 warning Link to unknown file: `examples/world.md`',

378− ' 21:12 warning Link to unknown file: `examples/world.md`',

379− ' 23:10 warning Link to unknown file: `examples/world.md`',

380− ' 25:10 warning Link to unknown file: `examples/world.md`',

381− ' 45:10 warning Link to unknown file: `examples/world.md`',

382− ' 47:10 warning Link to unknown file: `examples/world.md`',

383− ' 49:10 warning Link to unknown file: `examples/world.md`',

384− ' 51:10 warning Link to unknown file: `examples/world.md`',

385− ' 37:10 warning Link to unknown heading in ' +

386− '`examples/example.md`: `world`',

387− ' 39:10 warning Link to unknown heading in ' +

388− '`examples/example.md`: `world`',

389− ' 41:10 warning Link to unknown heading in ' +

390− '`examples/example.md`: `world`',

391− ' 43:10 warning Link to unknown heading in ' +

392− '`examples/example.md`: `world`',

393− ' 45:10 warning Link to unknown heading in ' +

394− '`examples/world.md`: `hello`',

395− ' 47:10 warning Link to unknown heading in ' +

396− '`examples/world.md`: `hello`',

397− ' 49:10 warning Link to unknown heading in ' +

398− '`examples/world.md`: `hello`',

399− ' 51:10 warning Link to unknown heading in ' +

400− '`examples/world.md`: `hello`',

401− '',

402− '✖ 17 problems (0 errors, 17 warnings)',

403− '',

404− '',

405− 'examples/example.md: done.',

406− ' 5:37 warning Link to unknown heading: `world`',

407− ' 15:34 warning Link to unknown file: `world.md`',

408− ' 17:12 warning Link to unknown file: `world.md`',

409− ' 19:10 warning Link to unknown file: `world.md`',

410− ' 35:10 warning Link to unknown file: `world.md`',

411− ' 37:10 warning Link to unknown file: `world.md`',

412− ' 39:10 warning Link to unknown file: `world.md`',

413− ' 29:10 warning Link to unknown heading in ' +

414− '`example.md`: `world`',

415− ' 31:10 warning Link to unknown heading in ' +

416− '`example.md`: `world`',

417− ' 33:10 warning Link to unknown heading in ' +

418− '`example.md`: `world`',

419− ' 35:10 warning Link to unknown heading in ' +

420− '`world.md`: `hello`',

421− ' 37:10 warning Link to unknown heading in ' +

422− '`world.md`: `hello`',

423− ' 39:10 warning Link to unknown heading in ' +

424− '`world.md`: `hello`',

425− '',

426− '✖ 13 problems (0 errors, 13 warnings)'

427− ].join('\n'));

428−

429− done(err);

430− });

431− });

432−});

1+'use strict'

3+var fs = require('fs')

4+var path = require('path')

5+var childProcess = require('child_process')

6+var test = require('tape')

7+var vfile = require('to-vfile')

8+var remark = require('remark')

9+var strip = require('strip-ansi')

10+var rimraf = require('rimraf')

11+var sort = require('./sort')

12+var links = require('..')

13+

14+process.chdir(path.resolve(process.cwd(), 'test', 'fixtures'))

15+

16+test.onFinish(function () {

17+ process.chdir(path.resolve(process.cwd(), '..', '..'))

18+})

19+

20+var bin = path.join('..', '..', 'node_modules', '.bin', 'remark')

21+

22+test('remark-validate-links', function (t) {

23+ t.test('should work on the API', function (st) {

24+ st.plan(1)

25+

26+ remark()

27+ .use(links)

28+ .use(sort)

29+ .process(vfile.readSync('github.md'), function (err, file) {

30+ st.deepEqual(

31+ [err].concat(file.messages.map(String)),

32+ [

33+ null,

34+ 'github.md:5:37-5:51: Link to unknown heading: `world`',

35+ 'github.md:27:10-27:37: Link to unknown file: `examples/world.md`',

36+ 'github.md:29:10-29:35: Link to unknown file: `examples/world.md`',

37+ 'github.md:49:10-49:40: Link to unknown file: `examples/world.md`',

38+ 'github.md:51:10-51:38: Link to unknown file: `examples/world.md`'

39+ ],

40+ 'should report messages'

41+ )

42+ })

43+ })

44+

45+ t.test('should ignore invalid repositories', function (st) {

46+ st.plan(1)

47+

48+ childProcess.exec(

49+ [

50+ bin,

51+ '--no-config',

52+ '--no-ignore',

53+ '--use',

54+ '"../..=repository:\\"invalid:shortcode\\""',

55+ '--use',

56+ '../sort',

57+ 'small.md'

58+ ].join(' '),

59+ onexec

60+ )

61+

62+ function onexec(err, stdout, stderr) {

63+ st.deepEqual(

64+ [err, strip(stderr)],

65+ [

66+ null,

67+ [

68+ 'small.md',

69+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

70+ '',

71+ '⚠ 1 warning',

72+ ''

73+ ].join('\n')

74+ ],

75+ 'should work'

76+ )

77+ }

78+ })

79+

80+ t.test('should throw on Gist repositories', function (st) {

81+ st.plan(1)

82+

83+ childProcess.exec(

84+ [

85+ bin,

86+ '--no-config',

87+ '--no-ignore',

88+ '--use',

89+ '"../..=repository:\\"gist:wooorm/8504606\\""',

90+ '--use',

91+ '../sort',

92+ 'small.md'

93+ ].join(' '),

94+ onexec

95+ )

96+

97+ function onexec(err, stdout, stderr) {

98+ st.deepEqual(

99+ [err, strip(stderr)],

100+ [

101+ null,

102+ [

103+ 'small.md',

104+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

105+ '',

106+ '⚠ 1 warning',

107+ ''

108+ ].join('\n')

109+ ],

110+ 'should work'

111+ )

112+ }

113+ })

114+

115+ t.test('should ignore unfound files (#1)', function (st) {

116+ st.plan(1)

117+

118+ childProcess.exec(

119+ [

120+ bin,

121+ '--no-config',

122+ '--no-ignore',

123+ '--use',

124+ '../..',

125+ '--use',

126+ '../sort',

127+ 'FOOOO'

128+ ].join(' '),

129+ onexec

130+ )

131+

132+ function onexec(err, stdout, stderr) {

133+ st.deepEqual(

134+ [/command failed/i.test(err), strip(stderr)],

135+ [

136+ true,

137+ [

138+ 'FOOOO',

139+ ' 1:1 error No such file or directory',

140+ '',

141+ '✖ 1 error',

142+ ''

143+ ].join('\n')

144+ ],

145+ 'should work'

146+ )

147+ }

148+ })

149+

150+ t.test('should ignore unfound files (#2)', function (st) {

151+ st.plan(1)

152+

153+ childProcess.exec(

154+ [

155+ bin,

156+ '--no-config',

157+ '--no-ignore',

158+ '--use',

159+ '../..',

160+ '--use',

161+ '../sort',

162+ 'definitions.md',

163+ 'FOOOO'

164+ ].join(' '),

165+ onexec

166+ )

167+

168+ function onexec(err, stdout, stderr) {

169+ st.deepEqual(

170+ [/command failed/i.test(err), strip(stderr)],

171+ [

172+ true,

173+ [

174+ 'FOOOO',

175+ ' 1:1 error No such file or directory',

176+ '',

177+ 'definitions.md',

178+ ' 10:1-10:18 warning Link to unknown heading: `world` missing-heading remark-validate-links',

179+ '',

180+ '2 messages (✖ 1 error, ⚠ 1 warning)',

181+ ''

182+ ].join('\n')

183+ ],

184+ 'should work'

185+ )

186+ }

187+ })

188+

189+ t.test('should work if there are no links', function (st) {

190+ st.plan(1)

191+

192+ childProcess.exec(

193+ [

194+ bin,

195+ '--no-config',

196+ '--no-ignore',

197+ '--use',

198+ '../..',

199+ '--use',

200+ '../sort',

201+ 'empty.md'

202+ ].join(' '),

203+ onexec

204+ )

205+

206+ function onexec(err, stdout, stderr) {

207+ st.deepEqual(

208+ [err, strip(stderr)],

209+ [null, 'empty.md: no issues found\n'],

210+ 'should work'

211+ )

212+ }

213+ })

214+

215+ t.test('should work with stdin', function (st) {

216+ st.plan(1)

217+

218+ var subprocess = childProcess.exec(

219+ [

220+ bin,

221+ '--no-config',

222+ '--no-ignore',

223+ '--use',

224+ '../..',

225+ '--use',

226+ '../sort'

227+ ].join(' '),

228+ onexec

229+ )

230+

231+ fs.createReadStream('github.md').pipe(subprocess.stdin)

232+

233+ function onexec(err, stdout, stderr) {

234+ st.deepEqual(

235+ [err, strip(stderr)],

236+ [

237+ null,

238+ [

239+ '<stdin>',

240+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

241+ '',

242+ '⚠ 1 warning',

243+ ''

244+ ].join('\n')

245+ ],

246+ 'should work'

247+ )

248+ }

249+ })

250+

251+ t.test('should work when not all files are given', function (st) {

252+ st.plan(1)

253+

254+ childProcess.exec(

255+ [

256+ bin,

257+ '--no-config',

258+ '--no-ignore',

259+ '--use',

260+ '../..',

261+ '--use',

262+ '../sort',

263+ 'github.md'

264+ ].join(' '),

265+ onexec

266+ )

267+

268+ function onexec(err, stdout, stderr) {

269+ st.deepEqual(

270+ [err, strip(stderr)],

271+ [

272+ null,

273+ [

274+ 'github.md',

275+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

276+ ' 27:10-27:37 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

277+ ' 29:10-29:35 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

278+ ' 41:10-41:41 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

279+ ' 43:10-43:39 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

280+ ' 49:10-49:40 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

281+ ' 49:10-49:40 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

282+ ' 51:10-51:38 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

283+ ' 51:10-51:38 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

284+ '',

285+ '⚠ 9 warnings',

286+ ''

287+ ].join('\n')

288+ ],

289+ 'should work'

290+ )

291+ }

292+ })

293+

294+ t.test('should work when all files are given', function (st) {

295+ st.plan(1)

296+

297+ childProcess.exec(

298+ [

299+ bin,

300+ '--no-config',

301+ '--no-ignore',

302+ '--use',

303+ '../..',

304+ '--use',

305+ '../sort',

306+ 'github.md',

307+ 'examples/github.md'

308+ ].join(' '),

309+ onexec

310+ )

311+

312+ function onexec(err, stdout, stderr) {

313+ st.deepEqual(

314+ [err, strip(stderr)],

315+ [

316+ null,

317+ [

318+ 'examples/github.md',

319+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

320+ ' 19:10-19:29 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

321+ ' 29:10-29:33 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

322+ ' 35:10-35:32 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

323+ ' 35:10-35:32 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

324+ '',

325+ 'github.md',

326+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

327+ ' 27:10-27:37 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

328+ ' 29:10-29:35 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

329+ ' 41:10-41:41 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

330+ ' 43:10-43:39 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

331+ ' 49:10-49:40 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

332+ ' 49:10-49:40 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

333+ ' 51:10-51:38 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

334+ ' 51:10-51:38 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

335+ '',

336+ '⚠ 14 warnings',

337+ ''

338+ ].join('\n')

339+ ],

340+ 'should work'

341+ )

342+ }

343+ })

344+

345+ t.test('should work with definitions', function (st) {

346+ st.plan(1)

347+

348+ childProcess.exec(

349+ [

350+ bin,

351+ '--no-config',

352+ '--no-ignore',

353+ '--use',

354+ '../..',

355+ '--use',

356+ '../sort',

357+ 'definitions.md'

358+ ].join(' '),

359+ onexec

360+ )

361+

362+ function onexec(err, stdout, stderr) {

363+ st.deepEqual(

364+ [err, strip(stderr)],

365+ [

366+ null,

367+ [

368+ 'definitions.md',

369+ ' 10:1-10:18 warning Link to unknown heading: `world` missing-heading remark-validate-links',

370+ '',

371+ '⚠ 1 warning',

372+ ''

373+ ].join('\n')

374+ ],

375+ 'should work'

376+ )

377+ }

378+ })

379+

380+ t.test('should work on GitHub URLs when given a repo', function (st) {

381+ st.plan(1)

382+

383+ childProcess.exec(

384+ [

385+ bin,

386+ '--no-config',

387+ '--no-ignore',

388+ '--use',

389+ '"../..=repository:\\"wooorm/test\\""',

390+ '--use',

391+ '../sort',

392+ 'github.md',

393+ 'examples/github.md'

394+ ].join(' '),

395+ onexec

396+ )

397+

398+ function onexec(err, stdout, stderr) {

399+ st.deepEqual(

400+ [err, strip(stderr)],

401+ [

402+ null,

403+ [

404+ 'examples/github.md',

405+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

406+ ' 15:34-15:91 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

407+ ' 17:12-17:72 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

408+ ' 19:10-19:29 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

409+ ' 29:10-29:33 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

410+ ' 31:10-31:71 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

411+ ' 33:10-33:74 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

412+ ' 35:10-35:32 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

413+ ' 35:10-35:32 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

414+ ' 37:10-37:70 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

415+ ' 37:10-37:70 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

416+ ' 39:10-39:73 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

417+ ' 39:10-39:73 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

418+ '',

419+ 'github.md',

420+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

421+ ' 21:34-21:100 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

422+ ' 23:34-23:82 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

423+ ' 25:12-25:81 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

424+ ' 27:10-27:37 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

425+ ' 29:10-29:35 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

426+ ' 41:10-41:41 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

427+ ' 43:10-43:39 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

428+ ' 45:10-45:80 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

429+ ' 47:10-47:83 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

430+ ' 49:10-49:40 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

431+ ' 49:10-49:40 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

432+ ' 51:10-51:38 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

433+ ' 51:10-51:38 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

434+ ' 53:10-53:79 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

435+ ' 53:10-53:79 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

436+ ' 55:10-55:82 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

437+ ' 55:10-55:82 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

438+ '',

439+ '⚠ 31 warnings',

440+ ''

441+ ].join('\n')

442+ ],

443+ 'should work'

444+ )

445+ }

446+ })

447+

448+ t.test('should work when with Git directory', function (st) {

449+ st.plan(1)

450+

451+ childProcess.exec('git init', oninit)

452+

453+ function oninit(err) {

454+ if (err) {

455+ t.ifErr(err)

456+ } else {

457+ childProcess.exec(

458+ 'git remote add origin git@github.com:wooorm/test.git',

459+ onremote

460+ )

461+ }

462+ }

463+

464+ function onremote(err) {

465+ if (err) {

466+ clean()

467+ t.ifErr(err)

468+ } else {

469+ childProcess.exec(

470+ [

471+ bin,

472+ '--no-config',

473+ '--no-ignore',

474+ '--use',

475+ '../..',

476+ '--use',

477+ '../sort',

478+ 'github.md',

479+ 'examples/github.md'

480+ ].join(' '),

481+ onexec

482+ )

483+ }

484+ }

485+

486+ function onexec(err, stdout, stderr) {

487+ clean()

488+ st.deepEqual(

489+ [err, strip(stderr)],

490+ [

491+ null,

492+ [

493+ 'examples/github.md',

494+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

495+ ' 15:34-15:91 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

496+ ' 17:12-17:72 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

497+ ' 19:10-19:29 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

498+ ' 29:10-29:33 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

499+ ' 31:10-31:71 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

500+ ' 33:10-33:74 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

501+ ' 35:10-35:32 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

502+ ' 35:10-35:32 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

503+ ' 37:10-37:70 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

504+ ' 37:10-37:70 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

505+ ' 39:10-39:73 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

506+ ' 39:10-39:73 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

507+ '',

508+ 'github.md',

509+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

510+ ' 21:34-21:100 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

511+ ' 23:34-23:82 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

512+ ' 25:12-25:81 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

513+ ' 27:10-27:37 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

514+ ' 29:10-29:35 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

515+ ' 41:10-41:41 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

516+ ' 43:10-43:39 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

517+ ' 45:10-45:80 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

518+ ' 47:10-47:83 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

519+ ' 49:10-49:40 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

520+ ' 49:10-49:40 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

521+ ' 51:10-51:38 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

522+ ' 51:10-51:38 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

523+ ' 53:10-53:79 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

524+ ' 53:10-53:79 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

525+ ' 55:10-55:82 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

526+ ' 55:10-55:82 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

527+ '',

528+ '⚠ 31 warnings',

529+ ''

530+ ].join('\n')

531+ ],

532+ 'should work'

533+ )

534+ }

535+

536+ function clean() {

537+ rimraf.sync('./.git')

538+ }

539+ })

540+

541+ t.test('should fail w/o Git repository', function (st) {

542+ st.plan(1)

543+

544+ fs.renameSync('../../.git', '../../.git.bak')

545+

546+ childProcess.exec(

547+ [

548+ bin,

549+ '--no-config',

550+ '--no-ignore',

551+ '--use',

552+ '../..',

553+ '--use',

554+ '../sort',

555+ 'github.md'

556+ ].join(' '),

557+ onexec

558+ )

559+

560+ function onexec(err) {

561+ fs.renameSync('../../.git.bak', '../../.git')

562+ st.ok(/not a git repository/i.test(err), 'should fail')

563+ }

564+ })

565+

566+ t.test('should fail w/o Git repository w/o remote', function (st) {

567+ st.plan(1)

568+

569+ childProcess.exec('git init', oninit)

570+

571+ function oninit(err) {

572+ if (err) {

573+ t.ifErr(err)

574+ } else {

575+ childProcess.exec(

576+ [

577+ bin,

578+ '--no-config',

579+ '--no-ignore',

580+ '--use',

581+ '../..',

582+ 'github.md'

583+ ].join(' '),

584+ onexec

585+ )

586+ }

587+ }

588+

589+ function onexec(err) {

590+ rimraf.sync('./.git')

591+ st.ok(/Could not find remote origin/.test(err), 'should fail')

592+ }

593+ })

594+

595+ t.test('should work w/o Git repository w/ repo', function (st) {

596+ st.plan(1)

597+

598+ fs.renameSync('../../.git', '../../.git.bak')

599+

600+ childProcess.exec(

601+ [

602+ bin,

603+ '--no-config',

604+ '--no-ignore',

605+ '--use',

606+ '"../..=repository:\\"wooorm/test\\""',

607+ '--use',

608+ '../sort',

609+ 'small.md'

610+ ].join(' '),

611+ onexec

612+ )

613+

614+ function onexec(err, stdout, stderr) {

615+ fs.renameSync('../../.git.bak', '../../.git')

616+ st.deepEqual(

617+ [err, strip(stderr)],

618+ [

619+ null,

620+ [

621+ 'small.md',

622+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

623+ '',

624+ '⚠ 1 warning',

625+ ''

626+ ].join('\n')

627+ ],

628+ 'should work'

629+ )

630+ }

631+ })

632+

633+ t.test('should work w/o Git repository w/ remote', function (st) {

634+ st.plan(1)

635+

636+ fs.renameSync('../../.git', '../../.git.bak')

637+

638+ childProcess.exec(

639+ [

640+ bin,

641+ '--no-config',

642+ '--no-ignore',

643+ '--use',

644+ '"../..=repository:{remote:\\"wooorm/test\\"}"',

645+ 'small.md'

646+ ].join(' '),

647+ onexec

648+ )

649+

650+ function onexec(err, stdout, stderr) {

651+ fs.renameSync('../../.git.bak', '../../.git')

652+ st.deepEqual(

653+ [err, strip(stderr)],

654+ [

655+ null,

656+ [

657+ 'small.md',

658+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

659+ '',

660+ '⚠ 1 warning',

661+ ''

662+ ].join('\n')

663+ ],

664+ 'should work'

665+ )

666+ }

667+ })

668+

669+ t.test('should work w/o Git repository w/ remote and root', function (st) {

670+ st.plan(1)

671+

672+ fs.renameSync('../../.git', '../../.git.bak')

673+

674+ childProcess.exec(

675+ [

676+ bin,

677+ '--no-config',

678+ '--no-ignore',

679+ '--use',

680+ '"../..=repository:\\"wooorm/test\\",root:\\"../\\""',

681+ 'small.md'

682+ ].join(' '),

683+ onexec

684+ )

685+

686+ function onexec(err, stdout, stderr) {

687+ fs.renameSync('../../.git.bak', '../../.git')

688+ st.deepEqual(

689+ [err, strip(stderr)],

690+ [

691+ null,

692+ [

693+ 'small.md',

694+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

695+ '',

696+ '⚠ 1 warning',

697+ ''

698+ ].join('\n')

699+ ],

700+ 'should work'

701+ )

702+ }

703+ })

704+

705+ t.test('should work with `repository:false`', function (st) {

706+ st.plan(1)

707+

708+ fs.renameSync('../../.git', '../../.git.bak')

709+

710+ childProcess.exec(

711+ [

712+ bin,

713+ '--no-config',

714+ '--no-ignore',

715+ '--use',

716+ '"../..=repository:false"',

717+ '--use',

718+ '../sort',

719+ 'github.md',

720+ 'examples/github.md'

721+ ].join(' '),

722+ onexec

723+ )

724+

725+ function onexec(err, stdout, stderr) {

726+ fs.renameSync('../../.git.bak', '../../.git')

727+ st.deepEqual(

728+ [err, strip(stderr)],

729+ [

730+ null,

731+ [

732+ 'examples/github.md',

733+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

734+ ' 19:10-19:29 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

735+ ' 29:10-29:33 warning Link to unknown heading in `../github.md`: `world` missing-heading-in-file remark-validate-links',

736+ ' 35:10-35:32 warning Link to unknown file: `../world.md` missing-file remark-validate-links',

737+ ' 35:10-35:32 warning Link to unknown heading in `../world.md`: `hello` missing-heading-in-file remark-validate-links',

738+ '',

739+ 'github.md',

740+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

741+ ' 27:10-27:37 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

742+ ' 29:10-29:35 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

743+ ' 41:10-41:41 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

744+ ' 43:10-43:39 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

745+ ' 49:10-49:40 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

746+ ' 49:10-49:40 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

747+ ' 51:10-51:38 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

748+ ' 51:10-51:38 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

749+ ' 71:41-71:56 warning Link to unknown heading: `readme` missing-heading remark-validate-links',

750+ '',

751+ '⚠ 15 warnings',

752+ ''

753+ ].join('\n')

754+ ],

755+ 'should work'

756+ )

757+ }

758+ })

759+

760+ t.test('should work when finding non-hosted Git remotes', function (st) {

761+ st.plan(1)

762+

763+ childProcess.exec(

764+ [

765+ bin,

766+ '--no-config',

767+ '--no-ignore',

768+ '--use',

769+ '"../..=repository:\\"ssh://git@domain.com/user/project.git\\""',

770+ '--use',

771+ '../sort',

772+ 'small.md'

773+ ].join(' '),

774+ onexec

775+ )

776+

777+ function onexec(err, stdout, stderr) {

778+ st.deepEqual(

779+ [err, strip(stderr)],

780+ [

781+ null,

782+ [

783+ 'small.md',

784+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

785+ '',

786+ '⚠ 1 warning',

787+ ''

788+ ].join('\n')

789+ ],

790+ 'should work'

791+ )

792+ }

793+ })

794+

795+ t.test('should support a GitLab shortcode', function (st) {

796+ st.plan(1)

797+

798+ childProcess.exec(

799+ [

800+ bin,

801+ '--no-config',

802+ '--no-ignore',

803+ '--use',

804+ '"../..=repository:\\"gitlab:wooorm/test\\""',

805+ '--use',

806+ '../sort',

807+ 'gitlab.md'

808+ ].join(' '),

809+ onexec

810+ )

811+

812+ function onexec(err, stdout, stderr) {

813+ st.deepEqual(

814+ [err, strip(stderr)],

815+ [

816+ null,

817+ [

818+ 'gitlab.md',

819+ ' 5:37-5:51 warning Link to unknown heading: `world` missing-heading remark-validate-links',

820+ ' 19:34-19:100 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

821+ ' 21:12-21:81 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

822+ ' 23:10-23:37 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

823+ ' 25:10-25:35 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

824+ ' 37:10-37:41 warning Link to unknown heading in `examples/gitlab.md`: `world` missing-heading-in-file remark-validate-links',

825+ ' 39:10-39:39 warning Link to unknown heading in `examples/gitlab.md`: `world` missing-heading-in-file remark-validate-links',

826+ ' 41:10-41:80 warning Link to unknown heading in `examples/gitlab.md`: `world` missing-heading-in-file remark-validate-links',

827+ ' 43:10-43:83 warning Link to unknown heading in `examples/gitlab.md`: `world` missing-heading-in-file remark-validate-links',

828+ ' 45:10-45:40 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

829+ ' 45:10-45:40 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

830+ ' 47:10-47:38 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

831+ ' 47:10-47:38 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

832+ ' 49:10-49:79 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

833+ ' 49:10-49:79 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

834+ ' 51:10-51:82 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md` missing-file remark-validate-links',

835+ ' 51:10-51:82 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

836+ '',

837+ '⚠ 17 warnings',

838+ ''

839+ ].join('\n')

840+ ],

841+ 'should work'

842+ )

843+ }

844+ })

845+

846+ t.test('should support a Bitbucket shortcode', function (st) {

847+ st.plan(1)

848+

849+ childProcess.exec(

850+ [

851+ bin,

852+ '--no-config',

853+ '--no-ignore',

854+ '--use',

855+ '"../..=repository:\\"bitbucket:wooorm/test\\""',

856+ '--use',

857+ '../sort',

858+ 'bitbucket.md'

859+ ].join(' '),

860+ onexec

861+ )

862+

863+ function onexec(err, stdout, stderr) {

864+ st.deepEqual(

865+ [err, strip(stderr)],

866+ [

867+ null,

868+ [

869+ 'bitbucket.md',

870+ ' 5:37-5:67 warning Link to unknown heading: `world` missing-heading remark-validate-links',

871+ ' 21:34-21:102 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

872+ ' 23:12-23:83 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

873+ ' 25:10-25:37 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

874+ ' 27:10-27:35 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

875+ ' 39:10-39:60 warning Link to unknown heading in `examples/bitbucket.md`: `world` missing-heading-in-file remark-validate-links',

876+ ' 41:10-41:58 warning Link to unknown heading in `examples/bitbucket.md`: `world` missing-heading-in-file remark-validate-links',

877+ ' 43:10-43:101 warning Link to unknown heading in `examples/bitbucket.md`: `world` missing-heading-in-file remark-validate-links',

878+ ' 45:10-45:104 warning Link to unknown heading in `examples/bitbucket.md`: `world` missing-heading-in-file remark-validate-links',

879+ ' 47:10-47:56 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

880+ ' 47:10-47:56 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

881+ ' 49:10-49:54 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

882+ ' 49:10-49:54 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

883+ ' 51:10-51:97 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

884+ ' 51:10-51:97 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

885+ ' 53:10-53:100 warning Link to unknown file: `examples/world.md` missing-file remark-validate-links',

886+ ' 53:10-53:100 warning Link to unknown heading in `examples/world.md`: `hello` missing-heading-in-file remark-validate-links',

887+ '',

888+ '⚠ 17 warnings',

889+ ''

890+ ].join('\n')

891+ ],

892+ 'should work'

893+ )

894+ }

895+ })

896+

897+ t.test('should suggest similar links', function (st) {

898+ st.plan(1)

899+

900+ childProcess.exec(

901+ [

902+ bin,

903+ '--no-config',

904+ '--no-ignore',

905+ '--use',

906+ '../..',

907+ '--use',

908+ '../sort',

909+ 'suggestions.md'

910+ ].join(' '),

911+ onexec

912+ )

913+

914+ function onexec(err, stdout, stderr) {

915+ st.deepEqual(

916+ [err, strip(stderr)],

917+ [

918+ null,

919+ [

920+ 'suggestions.md',

921+ ' 3:22-3:37 warning Link to unknown heading: `helloo`. Did you mean `hello` missing-heading remark-validate-links',

922+ ' 7:17-7:39 warning Link to unknown heading in `github.md`: `fiiiles`. Did you mean `files` missing-heading-in-file remark-validate-links',

923+ '',

924+ '⚠ 2 warnings',

925+ ''

926+ ].join('\n')

927+ ],

928+ 'should work'

929+ )

930+ }

931+ })

932+

933+ t.test('should recognise links to particular lines', function (st) {

934+ st.plan(1)

935+

936+ childProcess.exec(

937+ [

938+ bin,

939+ '--no-config',

940+ '--no-ignore',

941+ '--use',

942+ '"../..=repository:\\"wooorm/test\\""',

943+ '--use',

944+ '../sort',

945+ 'line-links.md'

946+ ].join(' '),

947+ onexec

948+ )

949+

950+ function onexec(err, stdout, stderr) {

951+ st.deepEqual(

952+ [err, strip(stderr)],

953+ [

954+ null,

955+ [

956+ 'line-links.md',

957+ ' 5:9-5:61 warning Link to unknown file: `examples/missing.js` missing-file remark-validate-links',

958+ ' 9:1-9:69 warning Link to unknown file: `examples/missing.js` missing-file remark-validate-links',

959+ '',

960+ '⚠ 2 warnings',

961+ ''

962+ ].join('\n')

963+ ],

964+ 'should work'

965+ )

966+ }

967+ })

968+

969+ t.test('should recognise links with encoded URLs', function (st) {

970+ st.plan(1)

971+

972+ childProcess.exec(

973+ [

974+ bin,

975+ '--no-config',

976+ '--no-ignore',

977+ '--use',

978+ '"../..=repository:\\"wooorm/test\\""',

979+ '--use',

980+ '../sort',

981+ 'weird-characters.md'

982+ ].join(' '),

983+ onexec

984+ )

985+

986+ function onexec(err, stdout, stderr) {

987+ st.deepEqual(

988+ [err, strip(stderr)],

989+ [

990+ null,

991+ [

992+ 'weird-characters.md',

993+ ' 11:17-11:87 warning Link to unknown file: `examples/missing#characters.md`. Did you mean `examples/weird#characters.md` missing-file remark-validate-links',

994+ ' 13:17-13:93 warning Link to unknown file: `examples/missing#character/readme.md`. Did you mean `examples/weird#character/readme.md` missing-file remark-validate-links',

995+ ' 15:17-15:114 warning Link to unknown heading in `examples/weird#characters.md`: `world` missing-heading-in-file remark-validate-links',

996+ ' 17:17-17:120 warning Link to unknown heading in `examples/weird#character/readme.md`: `world` missing-heading-in-file remark-validate-links',

997+ '',

998+ '⚠ 4 warnings',

999+ ''

1000+ ].join('\n')

1001+ ],

1002+ 'should work'

1003+ )

1004+ }

1005+ })

1006+

1007+ t.test('should support folders', function (st) {

1008+ st.plan(1)

1009+

1010+ childProcess.exec(

1011+ [

1012+ bin,

1013+ '--no-config',

1014+ '--no-ignore',

1015+ '--use',

1016+ '"../..=repository:\\"wooorm/test\\""',

1017+ '--use',

1018+ '../sort',

1019+ 'folder.md'

1020+ ].join(' '),

1021+ onexec

1022+ )

1023+

1024+ function onexec(err, stdout, stderr) {

1025+ st.deepEqual(

1026+ [err, strip(stderr)],

1027+ [

1028+ null,

1029+ [

1030+ 'folder.md',

1031+ ' 9:1-9:40 warning Link to unknown heading in `folder/readme.markdown`: `missing` missing-heading-in-file remark-validate-links',

1032+ ' 17:1-17:24 warning Link to unknown heading in `folder`: `missing` missing-heading-in-file remark-validate-links',

1033+ ' 21:1-21:25 warning Link to unknown file: `missing` missing-file remark-validate-links',

1034+ ' 21:1-21:25 warning Link to unknown heading in `missing`: `missing` missing-heading-in-file remark-validate-links',

1035+ ' 23:1-23:39 warning Link to unknown heading in `folder-without-readme`: `missing` missing-heading-in-file remark-validate-links',

1036+ '',

1037+ '⚠ 5 warnings',

1038+ ''

1039+ ].join('\n')

1040+ ],

1041+ 'should work'

1042+ )

1043+ }

1044+ })

1045+

1046+ t.test('should warn on files as folders', function (st) {

1047+ st.plan(1)

1048+

1049+ childProcess.exec(

1050+ [

1051+ bin,

1052+ '--no-config',

1053+ '--no-ignore',

1054+ '--use',

1055+ '../..',

1056+ '--use',

1057+ '../sort',

1058+ 'file-as-folder.md'

1059+ ].join(' '),

1060+ onexec

1061+ )

1062+

1063+ function onexec(err, stdout, stderr) {

1064+ st.deepEqual(

1065+ [err, strip(stderr)],

1066+ [

1067+ null,

1068+ [

1069+ 'file-as-folder.md',

1070+ ' 1:1-1:28 warning Link to unknown file: `file-as-folder.md/other`. Did you mean `file-as-folder.md` missing-file remark-validate-links',

1071+ '',

1072+ '⚠ 1 warning',

1073+ ''

1074+ ].join('\n')

1075+ ],

1076+ 'should work'

1077+ )

1078+ }

1079+ })

1080+

1081+ t.test('should check images', function (st) {

1082+ st.plan(1)

1083+

1084+ childProcess.exec(

1085+ [

1086+ bin,

1087+ '--no-config',

1088+ '--no-ignore',

1089+ '--use',

1090+ '"../..=repository:\\"wooorm/test\\""',

1091+ '--use',

1092+ '../sort',

1093+ 'images.md'

1094+ ].join(' '),

1095+ onexec

1096+ )

1097+

1098+ function onexec(err, stdout, stderr) {

1099+ st.deepEqual(

1100+ [err, strip(stderr)],

1101+ [

1102+ null,

1103+ [

1104+ 'images.md',

1105+ ' 19:10-19:50 warning Link to unknown file: `examples/missing.jpg`. Did you mean `examples/image.jpg` missing-file remark-validate-links',

1106+ ' 21:12-21:42 warning Link to unknown file: `examples/missing.jpg`. Did you mean `examples/image.jpg` missing-file remark-validate-links',

1107+ ' 23:10-23:89 warning Link to unknown file: `examples/missing.jpg`. Did you mean `examples/image.jpg` missing-file remark-validate-links',

1108+ ' 35:1-35:38 warning Link to unknown file: `examples/missing.jpg`. Did you mean `examples/image.jpg` missing-file remark-validate-links',

1109+ ' 37:1-37:77 warning Link to unknown file: `examples/missing.jpg`. Did you mean `examples/image.jpg` missing-file remark-validate-links',

1110+ '',

1111+ '⚠ 5 warnings',

1112+ ''

1113+ ].join('\n')

1114+ ],

1115+ 'should work'

1116+ )

1117+ }

1118+ })

1119+

1120+ t.test('should support query parameters', function (st) {

1121+ st.plan(1)

1122+

1123+ childProcess.exec(

1124+ [

1125+ bin,

1126+ '--no-config',

1127+ '--no-ignore',

1128+ '--use',

1129+ '"../..=repository:\\"wooorm/test\\""',

1130+ '--use',

1131+ '../sort',

1132+ 'query-params.md'

1133+ ].join(' '),

1134+ onexec

1135+ )

1136+

1137+ function onexec(err, stdout, stderr) {

1138+ st.deepEqual(

1139+ [err, strip(stderr)],

1140+ [

1141+ null,

1142+ [

1143+ 'query-params.md',

1144+ ' 9:33-9:55 warning Link to unknown heading: `query-params?`. Did you mean `query-params` missing-heading remark-validate-links',

1145+ '',

1146+ '⚠ 1 warning',

1147+ ''

1148+ ].join('\n')

1149+ ],

1150+ 'should work'

1151+ )

1152+ }

1153+ })

1154+

1155+ t.test('should support case insensitive headings', function (st) {

1156+ st.plan(1)

1157+

1158+ childProcess.exec(

1159+ [

1160+ bin,

1161+ '--no-config',

1162+ '--no-ignore',

1163+ '--use',

1164+ '../..',

1165+ '--use',

1166+ '../sort',

1167+ 'case-insensitive-headings.md'

1168+ ].join(' '),

1169+ onexec

1170+ )

1171+

1172+ function onexec(err, stdout, stderr) {

1173+ st.deepEqual(

1174+ [err, strip(stderr)],

1175+ [

1176+ null,

1177+ [

1178+ 'case-insensitive-headings.md',

1179+ ' 5:13-5:27 warning Link to unknown heading: `world` missing-heading remark-validate-links',

1180+ ' 9:16-9:48 warning Link to unknown heading in `examples/github.md`: `world` missing-heading-in-file remark-validate-links',

1181+ '',

1182+ '⚠ 2 warnings',

1183+ ''

1184+ ].join('\n')

1185+ ],

1186+ 'should work'

1187+ )

1188+ }

1189+ })

1190+

1191+ t.test('should ignore external links', function (st) {

1192+ st.plan(1)

1193+

1194+ childProcess.exec(

1195+ [

1196+ bin,

1197+ '--no-config',

1198+ '--no-ignore',

1199+ '--use',

1200+ '"../..=repository:\\"wooorm/test\\""',

1201+ '--use',

1202+ '../sort',

1203+ 'external.md'

1204+ ].join(' '),

1205+ onexec

1206+ )

1207+

1208+ function onexec(err, stdout, stderr) {

1209+ st.deepEqual(

1210+ [err, strip(stderr)],

1211+ [null, 'external.md: no issues found\n'],

1212+ 'should work'

1213+ )

1214+ }

1215+ })

1216+

1217+ t.test('should ignore external links (without repo)', function (st) {

1218+ st.plan(1)

1219+

1220+ childProcess.exec(

1221+ [

1222+ bin,

1223+ '--no-config',

1224+ '--no-ignore',

1225+ '--use',

1226+ '../..=repository:false',

1227+ '--use',

1228+ '../sort',

1229+ 'external.md'

1230+ ].join(' '),

1231+ onexec

1232+ )

1233+

1234+ function onexec(err, stdout, stderr) {

1235+ st.deepEqual(

1236+ [err, strip(stderr)],

1237+ [null, 'external.md: no issues found\n'],

1238+ 'should work'

1239+ )

1240+ }

1241+ })

1242+

1243+ t.test('should support self-hosted Git solutions', function (st) {

1244+ st.plan(1)

1245+

1246+ childProcess.exec('git init', oninit)

1247+

1248+ function oninit(err) {

1249+ if (err) {

1250+ t.ifErr(err)

1251+ } else {

1252+ childProcess.exec(

1253+ 'git remote add origin git@gitlab.acme.company:acme/project.git',

1254+ onremote

1255+ )

1256+ }

1257+ }

1258+

1259+ function onremote(err) {

1260+ if (err) {

1261+ clean()

1262+ t.ifErr(err)

1263+ } else {

1264+ childProcess.exec(

1265+ [

1266+ bin,

1267+ '--no-config',

1268+ '--no-ignore',

1269+ '--use',

1270+ '"../..=urlConfig:{hostname:\\"gitlab.acme.com\\",prefix:\\"/acme/project/blob/\\",headingPrefix:\\"#\\",lines:true}"',

1271+ 'self-hosted.md'

1272+ ].join(' '),

1273+ onexec

1274+ )

1275+ }

1276+ }

1277+

1278+ function onexec(err, stdout, stderr) {

1279+ clean()

1280+ st.deepEqual(

1281+ [err, strip(stderr)],

1282+ [

1283+ null,

1284+ [

1285+ 'self-hosted.md',

1286+ ' 5:1-5:80 warning Link to unknown heading: `world` missing-heading remark-validate-links',

1287+ '',

1288+ '⚠ 1 warning',

1289+ ''

1290+ ].join('\n')

1291+ ],

1292+ 'should work'

1293+ )

1294+ }

1295+

1296+ function clean() {

1297+ rimraf.sync('./.git')

1298+ }

1299+ })

1300+

1301+ t.end()

1302+})

test/sort.jsnew file+13

@@ -0,0 +1,13 @@

1+'use strict'

3+var vfileSort = require('vfile-sort')

5+module.exports = sort

7+function sort() {

8+ return transform

9+}

10+

11+function transform(tree, file) {

12+ vfileSort(file)

13+}