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

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

50 files changed+2494−884

since splitsnapshots

unifiedsplit

.gitignore+1 .npmrc+1 .prettierignore+3 .travis.yml+2−10 index.js+2−373 lib/check/check-files.browser.js+7 lib/check/check-files.js+42 lib/check/index.js+13 lib/check/merge-landmarks.js+29 lib/check/merge-references.js+42 lib/check/validate.js+108 lib/constants.js+8 lib/find/config.js+54 lib/find/find-repo.browser.js+7 lib/find/find-repo.js+76 lib/find/find.js+296 lib/find/index.js+8 lib/index.js+48 LICENSE → license package.json+65−36 readme.md+206−44 test/fixtures/bitbucket.md+9−5 test/fixtures/case-insensitive-headings.md+9 test/fixtures/empty.md+1 test/fixtures/examples/bitbucket.md+5−5 test/fixtures/examples/example.js+1 test/fixtures/examples/github.md+5−5 test/fixtures/examples/gitlab.md+5−5 test/fixtures/examples/image with space.jpg test/fixtures/examples/image.jpg test/fixtures/examples/weird#character/readme.md+1 test/fixtures/examples/weird#characters.md+1 test/fixtures/external.md+11 test/fixtures/file-as-folder.md+1 test/fixtures/folder-without-readme/example.md+1 test/fixtures/folder.md+23 test/fixtures/folder/example.md+1 test/fixtures/folder/readme.asc+9 test/fixtures/folder/readme.markdown+5 test/fixtures/folder/readme.md+1 test/fixtures/github.md+13−5 test/fixtures/gitlab.md+9−5 test/fixtures/images.md+39 test/fixtures/line-links.md+9 test/fixtures/query-params.md+9 test/fixtures/self-hosted.md+5 test/fixtures/small.md+5 test/fixtures/weird-characters.md+17 test/index.js+1268−391 test/sort.js+13

.gitignore+1

@@ -3,3 +3,4 @@

33.nyc_output/

44coverage/

55node_modules/

6+yarn.lock

.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+2−10

@@ -1,13 +1,5 @@

11language: node_js

22node_js:

3−- '4.0'

4−- '8.0'

3+ - lts/dubnium

4+ - node

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

6−deploy:

7− provider: npm

8− email: tituswormer@gmail.com

9− api_key:

10− secure: NslAC8ebv6SgJQOGIER9ivZfTUTpT4t0FX7JukKXzAj2syfoKxsm/MzImfN3usDVkmTxnWw/PJQgUhkiD0Mw03ceLPgxAssoNcneE7mrTR/LJcT+r+TxM8rfZszO917G7hJonN/sHBUqzSmPKJmD1zKnFiPD1SN6x6T09sFVeS0VgJIiKZA1LZDtHatbX6USNiGfk7J0KVocJs2P8SWqU5NEGwDYWIgYtAFP2xHPc5ttn9p29kMZ3v1geKVyaKU6+TwUJ6T83wSy5bX5mDdGSpM0zwox0pqoYsbwZCUAudlNjHYm1NZxowhfkseExA6sLef3QKd2aoUclXO9CMbpOP6bHpyaukHc7x0vJzmOsZDnvrSLf/iZzwzT13BSGjs+Im22gAJ8A3zBBnG/acWNpQZ8sIS8jXPw0oTrPSRAf3JAfA28Q/zYnGaDRInbO7JXtencNI3nR+royQsBf0VNdvfMug03GwMeAq4xXCzuafsux+VRyOxu9c+YV+2olQFC4zxrF6ecpN+PpyAquHyINsgqEQNmbopnq6xvX2tlogpys/ehPmFaFqmBq7ghsLLpl3YyZZ4CHlSnlJ4wBeyBi4bYiLnToPE1AS6Ykq1Os0xwYpyKqx6o3EzQ9hMXOfe9Z98Zv0VQHM8JWOFt90HFhzdBpN0dwKgzIBBfgBcgxo4=

11− on:

12− tags: true

13− node: '8.0'

index.js+2−373

@@ -1,374 +1,3 @@

1−'use strict';

1+'use strict'

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

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

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

6−var propose = require('propose');

7−var visit = require('unist-util-visit');

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

9−var hostedGitInfo = require('hosted-git-info');

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

11−var slug = require('remark-slug');

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

13−

14−module.exports = attacher;

15−

16−var referenceId = 'remarkValidateLinksReferences';

17−var landmarkId = 'remarkValidateLinksLandmarks';

18−var sourceId = 'remark-validate-links';

19−

20−completer.pluginId = sourceId;

21−

22−var exists = fs.existsSync;

23−var parse = url.parse;

24−

25−var viewPaths = {

26− github: 'blob',

27− gitlab: 'blob',

28− bitbucket: 'src'

29−};

30−

31−var headingPrefixes = {

32− github: '#',

33− gitlab: '#',

34− bitbucket: '#markdown-header-'

35−};

36−

37−function attacher(options, fileSet) {

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

39− var info;

40− var pack;

41−

42− /* Throw when not on the CLI. */

43− if (!fileSet) {

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

45− }

46−

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

48− * given. */

49− if (!repo) {

50− try {

51− pack = fileSet.files[0].cwd;

52− pack = JSON.parse(fs.readFileSync(path.resolve(pack, 'package.json')));

53− } catch (err) {

54− pack = {};

55− }

56−

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

58− }

59−

60− if (repo) {

61− info = hostedGitInfo.fromUrl(repo);

62−

63− if (!info) {

64− throw new Error('remark-validate-links cannot parse `repository` (`' + repo + '`)');

65− } else if (info.domain === 'gist.github.com') {

66− throw new Error('remark-validate-links does not support gist repositories');

67− }

68− }

69−

70− /* Attach a `completer`. */

71− fileSet.use(completer);

72−

73− /* Attach `slug` and a plugin that adds our transformer after it. */

74− this.use(slug).use(subplugin);

75−

76− function subplugin() {

77− /* Expose transformer. */

78− return transformerFactory(fileSet, info);

79− }

80−}

81−

82−/* Completer. */

83−function completer(set, done) {

84− var exposed = {};

85−

86− set.valueOf().forEach(expose);

87− set.valueOf().forEach(check);

88−

89− done();

90−

91− function expose(file) {

92− var landmarks = file.data[landmarkId];

93−

94− if (landmarks) {

95− exposed = xtend(exposed, landmarks);

96− }

97− }

98−

99− function check(file) {

100− /* istanbul ignore else - stdin */

101− if (file.path) {

102− validate(exposed, file);

103− }

104− }

105−}

106−

107−/* Factory to create a transformer based on the given

108− * info and set. */

109−function transformerFactory(fileSet, info) {

110− return transformer;

111−

112− /* Transformer. Adds references files to the set. */

113− function transformer(ast, file) {

114− var filePath = file.path;

115− var space = file.data;

116− var links = [];

117− var landmarks = {};

118− var references;

119− var current;

120− var link;

121− var pathname;

122−

123− /* istanbul ignore if - stdin */

124− if (!filePath) {

125− return;

126− }

127−

128− references = gatherReferences(file, ast, info);

129− current = getPathname(filePath);

130−

131− for (link in references) {

132− pathname = getPathname(link);

133−

134− if (

135− pathname !== current &&

136− getHash(link) &&

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

138− ) {

139− links.push(pathname);

140− fileSet.add(pathname);

141− }

142− }

143−

144− landmarks[filePath] = true;

145−

146− visit(ast, mark);

147−

148− space[referenceId] = references;

149− space[landmarkId] = landmarks;

150−

151− function mark(node) {

152− var data = node.data || {};

153− var attrs = data.hProperties || data.htmlAttributes || {};

154− var id = attrs.name || attrs.id || data.id;

155−

156− if (id) {

157− landmarks[filePath + '#' + id] = true;

158− }

159− }

160− }

161−}

162−

163−/* Check if `file` references headings or files not in `exposed`. */

164−function validate(exposed, file) {

165− var references = file.data[referenceId];

166− var filePath = file.path;

167− var reference;

168− var nodes;

169− var real;

170− var hash;

171− var pathname;

172− var warning;

173− var suggestion;

174−

175− for (reference in references) {

176− nodes = references[reference];

177− real = exposed[reference];

178− hash = getHash(reference);

179−

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

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

182− * for headings they are not added to remark. This

183− * is especially useful because they might be

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

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

186− real = exists(reference);

187− references[reference] = real;

188− }

189−

190− if (!real) {

191− if (hash) {

192− pathname = getPathname(reference);

193− warning = 'Link to unknown heading';

194−

195− if (pathname !== filePath) {

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

197− }

198−

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

200− } else {

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

202− }

203−

204− suggestion = getClosest(reference, exposed);

205−

206− if (suggestion) {

207− warning += '. Did you mean `' + suggestion + '`';

208− }

209−

210− warnAll(file, nodes, warning);

211− }

212− }

213−}

214−

215−/* Gather references: a map of file-paths references

216− * to be one or more nodes. */

217−function gatherReferences(file, tree, info) {

218− var cache = {};

219− var filePath = file.path;

220− var dirname = file.dirname;

221− var getDefinition;

222− var prefix = '';

223− var headingPrefix = '#';

224−

225− getDefinition = definitions(tree);

226−

227− if (info && info.type in viewPaths) {

228− prefix = '/' + info.path() + '/' + viewPaths[info.type] + '/';

229− }

230−

231− if (info && info.type in headingPrefixes) {

232− headingPrefix = headingPrefixes[info.type];

233− }

234−

235− visit(tree, 'link', onlink);

236− visit(tree, 'linkReference', onlink);

237−

238− return cache;

239−

240− /* Handle new links. */

241− function onlink(node) {

242− var link = node.url;

243− var definition;

244− var index;

245− var uri;

246− var pathname;

247− var hash;

248−

249− /* Handle link-references. */

250− if (node.identifier) {

251− definition = getDefinition(node.identifier);

252− link = definition && definition.url;

253− }

254−

255− /* Ignore definitions without link. */

256− if (!link) {

257− return;

258− }

259−

260− uri = parse(link);

261−

262− if (!uri.hostname) {

263− /* Handle hashes, or relative files. */

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

265− link = filePath + uri.hash;

266− uri = parse(link);

267− } else {

268− link = urljoin(dirname, link);

269− if (uri.hash) {

270− link += uri.hash;

271− }

272− uri = parse(link);

273− }

274− }

275−

276− /* Handle full links. */

277− if (uri.hostname) {

278− if (!prefix) {

279− return;

280− }

281−

282− if (uri.hostname !== info.domain || uri.pathname.slice(0, prefix.length) !== prefix) {

283− return;

284− }

285−

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

287−

288− /* Things get interesting here: branches.

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

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

291− * directory on the `foo` branch.

292− *

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

294− * supporting branches. */

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

296− }

297−

298− /* Handle file links, or combinations of files

299− * and hashes. */

300− index = link.indexOf(headingPrefix);

301−

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

303− pathname = link;

304− hash = null;

305− } else {

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

307− hash = link.slice(index + headingPrefix.length);

308− }

309−

310− if (!cache[pathname]) {

311− cache[pathname] = [];

312− }

313−

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

315−

316− if (hash) {

317− link = pathname + '#' + hash;

318− if (!cache[link]) {

319− cache[link] = [];

320− }

321−

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

323− }

324− }

325−}

326−

327−/* Utilitity to warn `reason` for each node in `nodes`,

328− * on `file`. */

329−function warnAll(file, nodes, reason) {

330− nodes.forEach(one);

331−

332− function one(node) {

333− var message = file.message(reason, node);

334− message.source = sourceId;

335− message.ruleId = sourceId;

336− }

337−}

338−

339−/* Suggest a possible similar reference. */

340−function getClosest(pathname, references) {

341− var hash = getHash(pathname);

342− var base = getPathname(pathname);

343− var dictionary = [];

344− var reference;

345− var subhash;

346− var subbase;

347−

348− for (reference in references) {

349− subbase = getPathname(reference);

350− subhash = getHash(reference);

351−

352− if (getPathname(reference) === base) {

353− if (subhash && hash) {

354− dictionary.push(subhash);

355− }

356− } else if (!subhash && !hash) {

357− dictionary.push(subbase);

358− }

359− }

360−

361− return propose(hash ? hash : base, dictionary, {threshold: 0.7});

362−}

363−

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

365−function getHash(uri) {

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

367−

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

369−}

370−

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

372−function getPathname(uri) {

373− return parse(uri).pathname;

374−}

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+65−36

@@ -1,61 +1,72 @@

11{

22 "name": "remark-validate-links",

3− "version": "6.1.0",

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

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− "remark"

17+ "heading"

1318 ],

14− "repository": "wooorm/remark-validate-links",

15− "bugs": "https://github.com/wooorm/remark-validate-links/issues",

16− "author": "Titus Wormer <tituswormer@gmail.com> (http://wooorm.com)",

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"

24+ },

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

1726 "contributors": [

18− "Titus Wormer <tituswormer@gmail.com> (http://wooorm.com)"

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>"

1934 ],

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"

38+ },

2039 "files": [

40+ "lib/",

2141 "index.js"

2242 ],

2343 "dependencies": {

24− "hosted-git-info": "^2.5.0",

25− "mdast-util-definitions": "^1.0.0",

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

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

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

2647 "propose": "0.0.5",

27− "remark-slug": "^4.2.1",

28− "unist-util-visit": "^1.0.0",

29− "urljoin": "^0.1.5",

30− "xtend": "^4.0.1"

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

49+ "trough": "^1.0.0",

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

51+ "xtend": "^4.0.0"

3152 },

3253 "devDependencies": {

33− "execa": "^0.8.0",

34− "nyc": "^11.0.0",

35− "remark": "^8.0.0",

36− "remark-cli": "^4.0.0",

37− "remark-preset-wooorm": "^3.0.0",

38− "strip-ansi": "^4.0.0",

39− "tape": "^4.0.0",

40− "xo": "^0.18.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"

4164 },

4265 "scripts": {

43− "build-md": "remark *.md -qfo",

44− "build": "npm run build-md",

45− "lint": "xo",

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

4667 "test-api": "node test",

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

48− "test": "npm run build && npm run lint && npm run test-coverage"

49− },

50− "xo": {

51− "space": true,

52− "esnext": false,

53− "rules": {

54− "no-eq-null": "off",

55− "eqeqeq": "off",

56− "guard-for-in": "off",

57− "max-lines": "off"

58− }

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

5970 },

6071 "nyc": {

6172 "check-coverage": true,

@@ -63,6 +74,24 @@

6374 "functions": 100,

6475 "branches": 100

6576 },

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+ },

6695 "remarkConfig": {

6796 "plugins": [

6897 "preset-wooorm"

readme.md+206−44

@@ -1,38 +1,54 @@

1−# remark-validate-links [![Build Status][build-badge]][build-status] [![Coverage Status][coverage-badge]][coverage-status] [![Chat][chat-badge]][chat]

1+# remark-validate-links

3−[**remark**][remark] plug-in to validate if links to headings and files

4−in markdown point to existing things.

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]

10+

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

12+existing local files and headings.

513

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

7−So if I link to that (`[welcome](#hello)`), this plug-in will warn

8−about it.

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

16+

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.

920

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

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

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

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

22+fine.

1323

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

15−is fine.

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]).

1627

17−## Table of Contents

28+## Contents

1829

19−* [Installation](#installation)

20−* [Command line](#command-line)

21−* [Programmatic](#programmatic)

30+* [Install](#install)

31+* [Use](#use)

32+ * [CLI](#cli)

33+ * [API](#api)

2234* [Configuration](#configuration)

2335* [Integration](#integration)

36+* [Security](#security)

2437* [Related](#related)

38+* [Contribute](#contribute)

2539* [License](#license)

2640

27−## Installation

41+## Install

2842

2943[npm][]:

3044

31−```bash

45+```sh

3246npm install remark-validate-links

3347```

3448

35−## Command line

49+## Use

50+

51+### CLI

3652

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

3854

@@ -49,7 +65,7 @@ Read more [whoops, this does not exist](#world).

4965

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

5167

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

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

5369

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

5571```

@@ -58,33 +74,100 @@ Now, running `remark -u validate-links .` yields:

5874

5975```text

6076example.md

61− 3:11-3:48 warning Link to unknown heading: `world` remark-validate-links remark-validate-links

62− 5:27-5:51 warning Link to unknown heading in `readme.md`: `foo` remark-validate-links remark-validate-links

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

6379

6480readme.md: no issues found

6581

6682⚠ 2 warnings

6783```

6884

69−## 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.

7087

71−This plug-in is **not** available on the API of remark.

88+### API

7289

73−## Configuration

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.

7493

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

76−[`repository`][package-repository] can handle. If this is omitted,

77−`remark-validate-links` will try the `package.json` in your current working

78−directory.

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

7995

80−```bash

96+```markdown

97+# Alpha

98+

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).

145+

146+## Configuration

147+

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.

155+

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

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

82165```

83166

84−When a repository is given or detected (supporting GitHub, GitLab, and

85−Bitbucket), links to the only files are normalized to the file-system.

86−For example, `https://github.com/foo/bar/blob/master/example.md` becomes

87−`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.

88171

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

90173An example `.remarkrc` file could look as follows:

@@ -102,6 +185,35 @@ An example `.remarkrc` file could look as follows:

102185}

103186```

104187

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

214+}

215+```

216+

105217## Integration

106218

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

@@ -114,9 +226,29 @@ on nodes:

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

115227 unique identifiers on nodes

116228

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+

117238## Related

118239

119240* [`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.

120252

121253## License

122254

@@ -124,30 +256,60 @@ on nodes:

124256

125257

126258

127−[build-badge]: https://img.shields.io/travis/wooorm/remark-validate-links.svg

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

128260

129−[build-status]: https://travis-ci.org/wooorm/remark-validate-links

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

130262

131−[coverage-badge]: https://img.shields.io/codecov/c/github/wooorm/remark-validate-links.svg

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

132264

133−[coverage-status]: https://codecov.io/github/wooorm/remark-validate-links

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

134266

135−[chat-badge]: https://img.shields.io/gitter/room/wooorm/remark.svg

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

136268

137−[chat]: https://gitter.im/wooorm/remark

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

138270

139−[license]: LICENSE

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

140272

141−[author]: http://wooorm.com

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

142284

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

144286

145−[remark]: https://github.com/wooorm/remark

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

146294

147−[remark-lint]: https://github.com/wooorm/remark-lint

295+[license]: license

148296

149−[remark-html]: https://github.com/wooorm/remark-html

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

150310

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

152312

153−[cli]: https://github.com/wooorm/remark/tree/master/packages/remark-cli#readme

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

314+

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

test/fixtures/bitbucket.md+9−5

@@ -4,9 +4,11 @@ This is a valid relative heading [link](#markdown-header-hello).

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

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

79## Files

810

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

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

1012

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

1214

@@ -16,7 +18,7 @@ And this [link](examples/bitbucket.md).

1618

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

1820

19−This is an invalid relative file [link](https://bitbucket.org/wooorm/test/src/master/examples/world.md).

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

2022

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

2224

@@ -30,7 +32,7 @@ Valid: [a](./examples/bitbucket.md#markdown-header-hello).

3032

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

3234

33−Valid: [c](https://bitbucket.org/wooorm/test/src/master/examples/bitbucket.md#markdown-header-hello).

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

3436

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

3638

@@ -38,7 +40,7 @@ Invalid: [e](./examples/bitbucket.md#markdown-header-world).

3840

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

4042

41−Invalid: [g](https://bitbucket.org/wooorm/test/src/master/examples/bitbucket.md#markdown-header-world).

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

4244

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

4446

@@ -46,10 +48,12 @@ Invalid: [i](./examples/world.md#markdown-header-hello).

4648

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

4850

49−Invalid: [k](https://bitbucket.org/wooorm/test/src/master/examples/world.md#markdown-header-hello).

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

5052

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

5254

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

56+

5357## External

5458

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

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.md+5−5

@@ -6,13 +6,13 @@ This is an invalid relative heading [link](#markdown-header-world).

77## Files

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

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

1010

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

1212

1313And this [link](../bitbucket.md).

1414

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

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

1616

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

1818

@@ -22,18 +22,18 @@ And this [link](../world.md).

2222

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

2424

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

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

2626

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

2828

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

3030

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

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

3232

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

3434

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

3636

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

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

3838

3939Invalid: [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/github.md+5−5

@@ -6,13 +6,13 @@ 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/github.md).

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

1010

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

1212

1313And this [link](../github.md).

1414

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

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

1616

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

1818

@@ -22,18 +22,18 @@ And this [link](../world.md).

2222

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

2424

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

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

2626

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

2828

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

3030

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

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

3232

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

3434

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

3636

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

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

3838

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

test/fixtures/examples/gitlab.md+5−5

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

77## Files

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

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

1010

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

1212

1313And this [link](../gitlab.md).

1414

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

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

1616

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

1818

@@ -22,18 +22,18 @@ And this [link](../world.md).

2222

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

2424

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

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

2626

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

2828

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

3030

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

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

3232

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

3434

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

3636

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

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

3838

3939Invalid: [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/github.md+13−5

@@ -6,7 +6,9 @@ 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/github.md).

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

10+

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

1012

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

1214

@@ -16,7 +18,9 @@ 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

@@ -30,7 +34,7 @@ Valid: [a](./examples/github.md#hello).

3034

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

3236

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

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

3438

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

3640

@@ -38,7 +42,7 @@ Invalid: [e](./examples/github.md#world).

3842

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

4044

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

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

4246

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

4448

@@ -46,7 +50,7 @@ Invalid: [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.md+9−5

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

77## Files

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

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

1010

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

1212

@@ -16,7 +16,7 @@ And this [link](examples/gitlab.md).

1616

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

1818

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

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

2020

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

2222

@@ -30,7 +30,7 @@ Valid: [a](./examples/gitlab.md#hello).

3030

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

3232

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

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

3434

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

3636

@@ -38,7 +38,7 @@ Invalid: [e](./examples/gitlab.md#world).

3838

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

4040

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

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

4242

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

4444

@@ -46,7 +46,7 @@ Invalid: [i](./examples/world.md#hello).

4646

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

4848

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

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

5050

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

5252

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

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

6262

6363Valid: [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/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+1268−391

@@ -1,425 +1,1302 @@

1−'use strict';

1+'use strict'

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

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

5−var test = require('tape');

6−var execa = require('execa');

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

8−var strip = require('strip-ansi');

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

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('..')

1013

11−process.chdir(path.resolve(process.cwd(), 'test', 'fixtures'));

14+process.chdir(path.resolve(process.cwd(), 'test', 'fixtures'))

1215

1316test.onFinish(function () {

14− process.chdir(path.resolve(process.cwd(), '..', '..'));

15−});

17+ process.chdir(path.resolve(process.cwd(), '..', '..'))

18+})

1619

17−var bin = path.join('..', '..', 'node_modules', '.bin', 'remark');

18−

19−var source = ' remark-validate-links remark-validate-links';

20+var bin = path.join('..', '..', 'node_modules', '.bin', 'remark')

2021

2122test('remark-validate-links', function (t) {

22− t.plan(12);

23−

24− t.throws(

25− function () {

26− remark().use(links).freeze();

27− },

28− /Error: remark-validate-links only works on the CLI/,

29− 'should throw an error when not on the CLI'

30− );

31−

32− t.test('should throw on unparsable git repositories', function (st) {

33− st.plan(1);

34−

35− execa(bin, [

36− '--no-config',

37− '--no-ignore',

38− '--use',

39− '../..=repository:"invalid:shortcode"',

40− 'definitions.md'

41− ]).then(function () {

42− st.fail('should not be successful');

43− }, function (err) {

44− st.equal(

45− strip(err.stderr).split('\n').slice(0, 2).join('\n'),

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)],

46100 [

47− 'definitions.md',

48− ' 1:1 error Error: remark-validate-links cannot parse `repository` (`invalid:shortcode`)'

49− ].join('\n'),

50− 'should report an error'

51− );

52− });

53− });

54−

55− t.test('should throw on gist repositories', function (st) {

56− st.plan(1);

57−

58− execa(bin, [

59− '--no-config',

60− '--no-ignore',

61− '--use',

62− '../..=repository:"gist:wooorm/8504606"',

63− 'definitions.md'

64− ]).then(function () {

65− st.fail('should not be successful');

66− }, function (err) {

67− st.equal(

68− strip(err.stderr).split('\n').slice(0, 2).join('\n'),

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)],

69135 [

70− 'definitions.md',

71− ' 1:1 error Error: remark-validate-links does not support gist repositories'

72− ].join('\n'),

73− 'should report an error'

74− );

75− });

76− });

77−

78− t.test('should ignore unfound files', function (st) {

79− st.plan(1);

80−

81− execa(bin, [

82− '--no-config',

83− '--no-ignore',

84− '--use',

85− '../..',

86− 'definitions.md',

87− 'FOOOO'

88− ]).then(function () {

89− st.fail('should not be successful');

90− }, function (err) {

91− st.equal(

92− strip(err.stderr),

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)],

93171 [

94− 'FOOOO',

95− ' 1:1 error No such file or directory',

96− '',

97− 'definitions.md',

98− ' 5:12-5:21 warning Link to unknown heading: `world`' + source,

99− '',

100− '2 messages (✖ 1 error, ⚠ 1 warning)',

101− ''

102− ].join('\n'),

103− 'should report an error'

104− );

105− });

106− });

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+ })

107250

108251 t.test('should work when not all files are given', function (st) {

109− st.plan(1);

110−

111− execa(bin, [

112− '--no-config',

113− '--no-ignore',

114− '--use',

115− '../..',

116− 'github.md'

117− ]).then(function (result) {

118− st.equal(

119− strip(result.stderr),

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)],

120271 [

121− 'github.md',

122− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

123− ' 23:10-23:37 warning Link to unknown file: `examples/world.md` ' + source,

124− ' 25:10-25:35 warning Link to unknown file: `examples/world.md` ' + source,

125− ' 37:10-37:41 warning Link to unknown heading in `examples/github.md`: `world`' + source,

126− ' 39:10-39:39 warning Link to unknown heading in `examples/github.md`: `world`' + source,

127− ' 45:10-45:40 warning Link to unknown file: `examples/world.md` ' + source,

128− ' 45:10-45:40 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

129− ' 47:10-47:38 warning Link to unknown file: `examples/world.md` ' + source,

130− ' 47:10-47:38 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

131− '',

132− '⚠ 9 warnings'

133− ].join('\n'),

134− 'should report'

135− );

136− }, st.error);

137− });

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+ })

138293

139294 t.test('should work when all files are given', function (st) {

140− st.plan(1);

141−

142− execa(bin, [

143− '--no-config',

144− '--no-ignore',

145− '--use',

146− '../..',

147− 'github.md',

148− 'examples/github.md'

149− ]).then(function (result) {

150− st.equal(

151− strip(result.stderr),

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)],

152315 [

153− 'examples/github.md',

154− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

155− ' 19:10-19:29 warning Link to unknown file: `world.md` ' + source,

156− ' 29:10-29:33 warning Link to unknown heading in `github.md`: `world` ' + source,

157− ' 35:10-35:32 warning Link to unknown file: `world.md` ' + source,

158− ' 35:10-35:32 warning Link to unknown heading in `world.md`: `hello` ' + source,

159− '',

160− 'github.md',

161− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

162− ' 23:10-23:37 warning Link to unknown file: `examples/world.md` ' + source,

163− ' 25:10-25:35 warning Link to unknown file: `examples/world.md` ' + source,

164− ' 37:10-37:41 warning Link to unknown heading in `examples/github.md`: `world`' + source,

165− ' 39:10-39:39 warning Link to unknown heading in `examples/github.md`: `world`' + source,

166− ' 45:10-45:40 warning Link to unknown file: `examples/world.md` ' + source,

167− ' 45:10-45:40 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

168− ' 47:10-47:38 warning Link to unknown file: `examples/world.md` ' + source,

169− ' 47:10-47:38 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

170− '',

171− '⚠ 14 warnings'

172− ].join('\n'),

173− 'should report'

174− );

175− }, st.error);

176− });

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+ })

177344

178345 t.test('should work with definitions', function (st) {

179− st.plan(1);

180−

181− execa(bin, [

182− '--no-config',

183− '--no-ignore',

184− '--use',

185− '../..',

186− 'definitions.md'

187− ]).then(function (result) {

188− st.equal(

189− strip(result.stderr),

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)],

190365 [

191− 'definitions.md',

192− ' 5:12-5:21 warning Link to unknown heading: `world`' + source,

193− '',

194− '⚠ 1 warning'

195− ].join('\n'),

196− 'should report'

197− );

198− }, st.error);

199− });

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+ })

200379

201380 t.test('should work on GitHub URLs when given a repo', function (st) {

202− st.plan(1);

203−

204− execa(bin, [

205− '--no-config',

206− '--no-ignore',

207− '--use',

208− '../..=repository:"wooorm/test"',

209− 'github.md',

210− 'examples/github.md'

211− ]).then(function (result) {

212− st.equal(

213− strip(result.stderr),

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)],

214490 [

215− 'examples/github.md',

216− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

217− ' 15:34-15:93 warning Link to unknown file: `world.md` ' + source,

218− ' 17:12-17:72 warning Link to unknown file: `world.md` ' + source,

219− ' 19:10-19:29 warning Link to unknown file: `world.md` ' + source,

220− ' 29:10-29:33 warning Link to unknown heading in `github.md`: `world` ' + source,

221− ' 31:10-31:73 warning Link to unknown heading in `github.md`: `world` ' + source,

222− ' 33:10-33:74 warning Link to unknown heading in `github.md`: `world` ' + source,

223− ' 35:10-35:32 warning Link to unknown file: `world.md` ' + source,

224− ' 35:10-35:32 warning Link to unknown heading in `world.md`: `hello` ' + source,

225− ' 37:10-37:72 warning Link to unknown file: `world.md` ' + source,

226− ' 37:10-37:72 warning Link to unknown heading in `world.md`: `hello` ' + source,

227− ' 39:10-39:73 warning Link to unknown heading in `world.md`: `hello` ' + source,

228− ' 39:10-39:73 warning Link to unknown file: `world.md` ' + source,

229− '',

230− 'github.md',

231− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

232− ' 19:34-19:102 warning Link to unknown file: `examples/world.md` ' + source,

233− ' 21:12-21:81 warning Link to unknown file: `examples/world.md` ' + source,

234− ' 23:10-23:37 warning Link to unknown file: `examples/world.md` ' + source,

235− ' 25:10-25:35 warning Link to unknown file: `examples/world.md` ' + source,

236− ' 37:10-37:41 warning Link to unknown heading in `examples/github.md`: `world`' + source,

237− ' 39:10-39:39 warning Link to unknown heading in `examples/github.md`: `world`' + source,

238− ' 41:10-41:82 warning Link to unknown heading in `examples/github.md`: `world`' + source,

239− ' 43:10-43:83 warning Link to unknown heading in `examples/github.md`: `world`' + source,

240− ' 45:10-45:40 warning Link to unknown file: `examples/world.md` ' + source,

241− ' 45:10-45:40 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

242− ' 47:10-47:38 warning Link to unknown file: `examples/world.md` ' + source,

243− ' 47:10-47:38 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

244− ' 49:10-49:81 warning Link to unknown file: `examples/world.md` ' + source,

245− ' 49:10-49:81 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

246− ' 51:10-51:82 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

247− ' 51:10-51:82 warning Link to unknown file: `examples/world.md` ' + source,

248− '',

249− '⚠ 30 warnings'

250− ].join('\n'),

251− 'should report'

252− );

253− }, st.error);

254− });

255−

256− t.test('should work on GitHub URLs when with package.json', function (st) {

257− st.plan(1);

258−

259− /* `cwd` is moved to `test/fixtures`. */

260− fs.writeFileSync('./package.json', JSON.stringify({

261− repository: 'wooorm/test'

262− }, 0, 2));

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+ }

263535

264536 function clean() {

265− fs.unlinkSync('./package.json');

266− }

267−

268− execa(bin, [

269− '--no-config',

270− '--no-ignore',

271− '--use',

272− '../..',

273− 'github.md',

274− 'examples/github.md'

275− ]).then(function (result) {

276− clean();

277− st.equal(

278− strip(result.stderr),

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)],

279618 [

280− 'examples/github.md',

281− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

282− ' 15:34-15:93 warning Link to unknown file: `world.md` ' + source,

283− ' 17:12-17:72 warning Link to unknown file: `world.md` ' + source,

284− ' 19:10-19:29 warning Link to unknown file: `world.md` ' + source,

285− ' 29:10-29:33 warning Link to unknown heading in `github.md`: `world` ' + source,

286− ' 31:10-31:73 warning Link to unknown heading in `github.md`: `world` ' + source,

287− ' 33:10-33:74 warning Link to unknown heading in `github.md`: `world` ' + source,

288− ' 35:10-35:32 warning Link to unknown file: `world.md` ' + source,

289− ' 35:10-35:32 warning Link to unknown heading in `world.md`: `hello` ' + source,

290− ' 37:10-37:72 warning Link to unknown file: `world.md` ' + source,

291− ' 37:10-37:72 warning Link to unknown heading in `world.md`: `hello` ' + source,

292− ' 39:10-39:73 warning Link to unknown heading in `world.md`: `hello` ' + source,

293− ' 39:10-39:73 warning Link to unknown file: `world.md` ' + source,

294− '',

295− 'github.md',

296− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

297− ' 19:34-19:102 warning Link to unknown file: `examples/world.md` ' + source,

298− ' 21:12-21:81 warning Link to unknown file: `examples/world.md` ' + source,

299− ' 23:10-23:37 warning Link to unknown file: `examples/world.md` ' + source,

300− ' 25:10-25:35 warning Link to unknown file: `examples/world.md` ' + source,

301− ' 37:10-37:41 warning Link to unknown heading in `examples/github.md`: `world`' + source,

302− ' 39:10-39:39 warning Link to unknown heading in `examples/github.md`: `world`' + source,

303− ' 41:10-41:82 warning Link to unknown heading in `examples/github.md`: `world`' + source,

304− ' 43:10-43:83 warning Link to unknown heading in `examples/github.md`: `world`' + source,

305− ' 45:10-45:40 warning Link to unknown file: `examples/world.md` ' + source,

306− ' 45:10-45:40 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

307− ' 47:10-47:38 warning Link to unknown file: `examples/world.md` ' + source,

308− ' 47:10-47:38 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

309− ' 49:10-49:81 warning Link to unknown file: `examples/world.md` ' + source,

310− ' 49:10-49:81 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

311− ' 51:10-51:82 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

312− ' 51:10-51:82 warning Link to unknown file: `examples/world.md` ' + source,

313− '',

314− '⚠ 30 warnings'

315− ].join('\n'),

316− 'should report'

317− );

318− }, function (err) {

319− clean();

320− st.error(err);

321− });

322− });

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+ })

323794

324795 t.test('should support a GitLab shortcode', function (st) {

325− st.plan(1);

326−

327− execa(bin, [

328− '--no-config',

329− '--no-ignore',

330− '--use',

331− '../..=repository:"gitlab:wooorm/test"',

332− 'gitlab.md'

333− ]).then(function (result) {

334− st.equal(

335− strip(result.stderr),

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)],

336815 [

337− 'gitlab.md',

338− ' 5:37-5:51 warning Link to unknown heading: `world` ' + source,

339− ' 19:34-19:102 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

340− ' 21:12-21:81 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

341− ' 23:10-23:37 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

342− ' 25:10-25:35 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

343− ' 37:10-37:41 warning Link to unknown heading in `examples/gitlab.md`: `world` ' + source,

344− ' 39:10-39:39 warning Link to unknown heading in `examples/gitlab.md`: `world` ' + source,

345− ' 41:10-41:82 warning Link to unknown heading in `examples/gitlab.md`: `world` ' + source,

346− ' 43:10-43:83 warning Link to unknown heading in `examples/gitlab.md`: `world` ' + source,

347− ' 45:10-45:40 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

348− ' 45:10-45:40 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

349− ' 47:10-47:38 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

350− ' 47:10-47:38 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

351− ' 49:10-49:81 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

352− ' 49:10-49:81 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

353− ' 51:10-51:82 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

354− ' 51:10-51:82 warning Link to unknown file: `examples/world.md`. Did you mean `examples/gitlab.md`' + source,

355− '',

356− '⚠ 17 warnings'

357− ].join('\n'),

358− 'should report'

359− );

360− }, st.error);

361− });

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+ })

362845

363846 t.test('should support a Bitbucket shortcode', function (st) {

364− st.plan(1);

365−

366− execa(bin, [

367− '--no-config',

368− '--no-ignore',

369− '--use',

370− '../..=repository:"bitbucket:wooorm/test"',

371− 'bitbucket.md'

372− ]).then(function (result) {

373− st.equal(

374− strip(result.stderr),

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)],

375866 [

376− 'bitbucket.md',

377− ' 5:37-5:67 warning Link to unknown heading: `world` ' + source,

378− ' 19:34-19:104 warning Link to unknown file: `examples/world.md` ' + source,

379− ' 21:12-21:83 warning Link to unknown file: `examples/world.md` ' + source,

380− ' 23:10-23:37 warning Link to unknown file: `examples/world.md` ' + source,

381− ' 25:10-25:35 warning Link to unknown file: `examples/world.md` ' + source,

382− ' 37:10-37:60 warning Link to unknown heading in `examples/bitbucket.md`: `world`' + source,

383− ' 39:10-39:58 warning Link to unknown heading in `examples/bitbucket.md`: `world`' + source,

384− ' 41:10-41:103 warning Link to unknown heading in `examples/bitbucket.md`: `world`' + source,

385− ' 43:10-43:104 warning Link to unknown heading in `examples/bitbucket.md`: `world`' + source,

386− ' 45:10-45:56 warning Link to unknown file: `examples/world.md` ' + source,

387− ' 45:10-45:56 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

388− ' 47:10-47:54 warning Link to unknown file: `examples/world.md` ' + source,

389− ' 47:10-47:54 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

390− ' 49:10-49:99 warning Link to unknown file: `examples/world.md` ' + source,

391− ' 49:10-49:99 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

392− ' 51:10-51:100 warning Link to unknown heading in `examples/world.md`: `hello` ' + source,

393− ' 51:10-51:100 warning Link to unknown file: `examples/world.md` ' + source,

394− '',

395− '⚠ 17 warnings'

396− ].join('\n'),

397− 'should report'

398− );

399− }, st.error);

400− });

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+ })

401896

402897 t.test('should suggest similar links', function (st) {

403− st.plan(1);

404−

405− execa(bin, [

406− '--no-config',

407− '--no-ignore',

408− '--use',

409− '../..',

410− 'suggestions.md'

411− ]).then(function (result) {

412− st.equal(

413− strip(result.stderr),

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)],

414917 [

415− 'suggestions.md',

416− ' 3:22-3:37 warning Link to unknown heading: `helloo`. Did you mean `hello` ' + source,

417− ' 7:17-7:39 warning Link to unknown heading in `github.md`: `fiiiles`. Did you mean `files`' + source,

418− '',

419− '⚠ 2 warnings'

420− ].join('\n'),

421− 'should report'

422− );

423− }, st.error);

424− });

425−});

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+}