mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-10 18:50:18 +01:00
Garry Tanandcapy-ai[bot]
e077053c3c
* Let pull requests that only change human-facing docs skip the test suites (GST-1951) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Quote the docs test list in the docs lane so shellcheck passes Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Keep the Windows smoke check green on docs-only pull requests and update the workflow contract tests Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Keep the merged test check when the base gained a reader of a changed doc, hold the land policy key until a release reads it, and register two more docs reader tests Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Check links in untracked docs and docs with quoted or spaced names, and report an undecodable anchor instead of crashing Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * Point the flaky-exception anchor back at its section and test the link checker's exit codes Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --------- Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
22 lines
1.4 KiB
TypeScript
Executable File
22 lines
1.4 KiB
TypeScript
Executable File
#!/usr/bin/env -S bun --no-env-file --config=/dev/null
|
|
/**
|
|
* check-doc-links — the docs lane's link check (lib/doc-links.ts; docs/pregate.md#docs-only).
|
|
* bun scripts/check-doc-links.ts [--base <ref>] <file.md>...
|
|
* With --base, only links on lines added since <ref> (diffed against the working tree) are checked, so a docs edit is
|
|
* not blocked by an older broken link it did not touch. Prints DOC_LINKS: ok (<n> file(s)) and exits 0, or one line per
|
|
* broken link and DOC_LINKS: broken <n> and exits 1; a git failure prints DOC_LINKS: error and exits 2.
|
|
*/
|
|
import { addedLines, brokenLinks } from '../lib/doc-links';
|
|
|
|
const args = process.argv.slice(2);
|
|
const at = args.indexOf('--base');
|
|
const base = at >= 0 ? args[at + 1] : undefined;
|
|
const files = args.filter((a, i) => (at < 0 || (i !== at && i !== at + 1)) && /\.md$/i.test(a));
|
|
let added: Map<string, Set<number>> | undefined;
|
|
try { added = base ? addedLines(process.cwd(), base, files) : undefined; }
|
|
catch (e) { console.log(`DOC_LINKS: error (${(e as Error).message})`); process.exit(2); }
|
|
const broken = brokenLinks(process.cwd(), files, added);
|
|
for (const b of broken) console.log(`${b.file}:${b.line}: ${b.target}: ${b.reason}; fix: correct the link or add the heading it names`);
|
|
console.log(broken.length ? `DOC_LINKS: broken ${broken.length}` : `DOC_LINKS: ok (${files.length} file(s))`);
|
|
process.exit(broken.length ? 1 : 0);
|