123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
import { VERSION } from "../version.ts";import * as semver from "../semver/mod.ts";import * as colors from "../fmt/colors.ts";import { doc } from "deno_doc";import { walk } from "../fs/walk.ts";import { toFileUrl } from "../path/mod.ts";
const EXTENSIONS = [".mjs", ".js", ".ts"];const EXCLUDED_PATHS = [  ".git",  "dotenv/testdata",  "fs/testdata",  "http/testdata",  "http/_negotiation",  "crypto/_wasm",  "crypto/_fnv",  "encoding/_yaml",  "encoding/_toml",  "_tools",  "_util",  "docs",];
const ROOT = new URL("../", import.meta.url);
const FAIL_FAST = Deno.args.includes("--fail-fast");
const DEPRECATION_IN_FORMAT_REGEX =  /^\(will be removed in (?<version>\d+\.\d+\.\d+)\)/;const DEPRECATION_AFTER_FORMAT_REGEX =  /^\(will be removed after (?<version>\d+\.\d+\.\d+)\)/;
let shouldFail = false;
// add three minor version to current versionconst DEFAULT_DEPRECATED_VERSION = semver.increment(  semver.increment(    semver.increment(      semver.parse(VERSION),      "minor",    )!,    "minor",  )!,  "minor",);
const DEPRECATION_IN_FORMAT =  `(will be removed in ${DEFAULT_DEPRECATED_VERSION})`;
for await (  const { path } of walk(ROOT, {    includeDirs: false,    exts: EXTENSIONS,    skip: EXCLUDED_PATHS.map((path) => new RegExp(path + "$")),  })) {  // deno_doc only takes urls.  const url = toFileUrl(path);  const docs = await doc(url.href);
  for (const d of docs) {    const tags = d.jsDoc?.tags;    if (tags) {      for (const tag of tags) {        switch (tag.kind) {          case "deprecated": {            const message = tag.doc;            if (!message) {              console.error(                colors.red("Error"),                `${                  colors.bold("@deprecated")                } tag must have a version: ${path}:${d.location.line}`,              );              shouldFail = true;              if (FAIL_FAST) Deno.exit(1);              continue;            }            const { version: afterVersion } =              DEPRECATION_AFTER_FORMAT_REGEX.exec(message)?.groups || {};
            if (afterVersion) {              if (                semver.lessThan(                  semver.parse(afterVersion),                  semver.parse(VERSION),                )              ) {                console.warn(                  colors.yellow("Warn"),                  `${                    colors.bold("@deprecated")                  } tag is expired and export should be removed: ${path}:${d.location.line}`,                );              }              continue;            }
            const { version: inVersion } =              DEPRECATION_IN_FORMAT_REGEX.exec(message)?.groups || {};            if (!inVersion) {              console.error(                colors.red("Error"),                `${                  colors.bold("@deprecated")                } tag version is missing. Append '${DEPRECATION_IN_FORMAT}' after @deprecated tag: ${path}:${d.location.line}`,              );              shouldFail = true;              if (FAIL_FAST) Deno.exit(1);              continue;            }
            if (              !semver.greaterThan(                semver.parse(inVersion),                semver.parse(VERSION),              )            ) {              console.error(                colors.red("Error"),                `${                  colors.bold("@deprecated")                } tag is expired and export must be removed: ${path}:${d.location.line}`,              );              if (FAIL_FAST) Deno.exit(1);              shouldFail = true;              continue;            }          }        }      }    }  }}
if (shouldFail) Deno.exit(1);