@docusaurus/utils 3.9.2-canary-6436 → 3.9.2-canary-6439

package/src/vcs/vcsGitEager.ts

@@ -0,0 +1,99 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {resolve, basename} from 'node:path';
+import logger, {PerfLogger} from '@docusaurus/logger';
+import {getGitAllRepoRoots, getGitRepositoryFilesInfo} from './gitUtils';
+import type {GitFileInfo, GitFileInfoMap} from './gitUtils';
+import type {VcsConfig} from '@docusaurus/types';
+
+// The Map keys should be absolute file paths, not relative Git paths
+function resolveFileInfoMapPaths(
+  repoRoot: string,
+  filesInfo: GitFileInfoMap,
+): GitFileInfoMap {
+  function transformMapEntry(
+    entry: [string, GitFileInfo],
+  ): [string, GitFileInfo] {
+    // We just resolve the Git paths that are relative to the repo root
+    return [resolve(repoRoot, entry[0]), entry[1]];
+  }
+
+  return new Map(Array.from(filesInfo.entries()).map(transformMapEntry));
+}
+
+function mergeFileMaps(fileMaps: GitFileInfoMap[]): GitFileInfoMap {
+  return new Map(fileMaps.flatMap((m) => [...m]));
+}
+
+async function loadAllGitFilesInfoMap(cwd: string): Promise<GitFileInfoMap> {
+  const roots = await PerfLogger.async('Reading Git root dirs', () =>
+    getGitAllRepoRoots(cwd),
+  );
+
+  const allMaps: GitFileInfoMap[] = await Promise.all(
+    roots.map(async (root) => {
+      const map = await PerfLogger.async(
+        `Reading Git history for repo ${logger.path(basename(root))}`,
+        () => getGitRepositoryFilesInfo(root),
+      );
+      return resolveFileInfoMapPaths(root, map);
+    }),
+  );
+
+  return mergeFileMaps(allMaps);
+}
+
+function createGitVcsConfig(): VcsConfig {
+  let filesMapPromise: Promise<GitFileInfoMap> | null = null;
+
+  async function getGitFileInfo(filePath: string): Promise<GitFileInfo | null> {
+    const filesMap = await filesMapPromise;
+    return filesMap?.get(filePath) ?? null;
+  }
+
+  return {
+    initialize: ({siteDir}) => {
+      if (filesMapPromise) {
+        // We only initialize this VCS once!
+        // For i18n sites, this permits reading ahead of time for all locales
+        // so that it only slows down the first locale
+        // I assume this logic is fine, but we'll see if it causes trouble
+
+        // Note: we could also only call "initialize()" once from the outside,
+        // But maybe it could be useful for custom VCS implementations to be
+        // able to initialize once per locale?
+        PerfLogger.log(
+          'Git Eager VCS strategy already initialized, skipping re-initialization',
+        );
+        return;
+      }
+
+      filesMapPromise = PerfLogger.async('Git Eager VCS init', () =>
+        loadAllGitFilesInfoMap(siteDir),
+      );
+      filesMapPromise.catch((error) => {
+        console.error(
+          'Failed to initialize the Docusaurus Git Eager VCS strategy',
+          error,
+        );
+      });
+    },
+
+    getFileCreationInfo: async (filePath: string) => {
+      const fileInfo = await getGitFileInfo(filePath);
+      return fileInfo?.creation ?? null;
+    },
+
+    getFileLastUpdateInfo: async (filePath: string) => {
+      const fileInfo = await getGitFileInfo(filePath);
+      return fileInfo?.lastUpdate ?? null;
+    },
+  };
+}
+
+export const VscGitEager: VcsConfig = createGitVcsConfig();

package/src/vcs/vcsHardcoded.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import type {VcsConfig, VcsChangeInfo} from '@docusaurus/types';
+
+export const VCS_HARDCODED_CREATION_INFO: VcsChangeInfo = {
+  timestamp: 1490997600000, // 1st Apr 2017
+  author: 'Creator',
+};
+
+export const VCS_HARDCODED_LAST_UPDATE_INFO: VcsChangeInfo = {
+  timestamp: 1539502055000, // 14th Oct 2018
+  author: 'Author',
+};
+
+export const VCS_HARDCODED_UNTRACKED_FILE_PATH = `file/path/${Math.random()}.mdx`;
+
+/**
+ * This VCS implementation always returns hardcoded values for testing purposes.
+ * It is also useful in dev environments where VCS info is not important.
+ * Reading information from the VCS can be slow and is not always necessary.
+ */
+export const VcsHardcoded: VcsConfig = {
+  initialize: () => {
+    // Noop
+  },
+
+  getFileCreationInfo: async (filePath: string) => {
+    if (filePath === VCS_HARDCODED_UNTRACKED_FILE_PATH) {
+      return null;
+    }
+    return VCS_HARDCODED_CREATION_INFO;
+  },
+
+  getFileLastUpdateInfo: async (filePath: string) => {
+    if (filePath === VCS_HARDCODED_UNTRACKED_FILE_PATH) {
+      return null;
+    }
+    return VCS_HARDCODED_LAST_UPDATE_INFO;
+  },
+};

package/lib/gitUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gitUtils.d.ts","sourceRoot":"","sources":["../src/gitUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH,2DAA2D;AAC3D,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,uEAAuE;AACvE,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB;AACrC,iCAAiC;AACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ;;;OAGG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACA,OAAO,CAAC;IACT,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AACH;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB;AACrC,iCAAiC;AACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ;;;OAGG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,aAAa,EAAE,IAAI,CAAC;CACrB,GACA,OAAO,CAAC;IACT,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC"}

package/lib/gitUtils.js

@@ -1,103 +0,0 @@
-"use strict";
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileNotTrackedError = exports.GitNotFoundError = void 0;
-exports.getFileCommitDate = getFileCommitDate;
-const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const os_1 = tslib_1.__importDefault(require("os"));
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
-const execa_1 = tslib_1.__importDefault(require("execa"));
-const p_queue_1 = tslib_1.__importDefault(require("p-queue"));
-// Quite high/conservative concurrency value (it was previously "Infinity")
-// See https://github.com/facebook/docusaurus/pull/10915
-const DefaultGitCommandConcurrency = 
-// TODO Docusaurus v4: bump node, availableParallelism() now always exists
-(typeof os_1.default.availableParallelism === 'function'
-    ? os_1.default.availableParallelism()
-    : os_1.default.cpus().length) * 4;
-const GitCommandConcurrencyEnv = process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY
-    ? parseInt(process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY, 10)
-    : undefined;
-const GitCommandConcurrency = GitCommandConcurrencyEnv && GitCommandConcurrencyEnv > 0
-    ? GitCommandConcurrencyEnv
-    : DefaultGitCommandConcurrency;
-// We use a queue to avoid running too many concurrent Git commands at once
-// See https://github.com/facebook/docusaurus/issues/10348
-const GitCommandQueue = new p_queue_1.default({
-    concurrency: GitCommandConcurrency,
-});
-const realHasGitFn = () => {
-    try {
-        return execa_1.default.sync('git', ['--version']).exitCode === 0;
-    }
-    catch (error) {
-        return false;
-    }
-};
-// The hasGit call is synchronous IO so we memoize it
-// The user won't install Git in the middle of a build anyway...
-const hasGit = process.env.NODE_ENV === 'test' ? realHasGitFn : lodash_1.default.memoize(realHasGitFn);
-/** Custom error thrown when git is not found in `PATH`. */
-class GitNotFoundError extends Error {
-}
-exports.GitNotFoundError = GitNotFoundError;
-/** Custom error thrown when the current file is not tracked by git. */
-class FileNotTrackedError extends Error {
-}
-exports.FileNotTrackedError = FileNotTrackedError;
-async function getFileCommitDate(file, { age = 'oldest', includeAuthor = false, }) {
-    if (!hasGit()) {
-        throw new GitNotFoundError(`Failed to retrieve git history for "${file}" because git is not installed.`);
-    }
-    if (!(await fs_extra_1.default.pathExists(file))) {
-        throw new Error(`Failed to retrieve git history for "${file}" because the file does not exist.`);
-    }
-    // We add a "RESULT:" prefix to make parsing easier
-    // See why: https://github.com/facebook/docusaurus/pull/10022
-    const resultFormat = includeAuthor ? 'RESULT:%ct,%an' : 'RESULT:%ct';
-    const args = [
-        `--format=${resultFormat}`,
-        '--max-count=1',
-        age === 'oldest' ? '--follow --diff-filter=A' : undefined,
-    ]
-        .filter(Boolean)
-        .join(' ');
-    const command = `git -c log.showSignature=false log ${args} -- "${path_1.default.basename(file)}"`;
-    const result = (await GitCommandQueue.add(() => {
-        return (0, execa_1.default)(command, {
-            cwd: path_1.default.dirname(file),
-            shell: true,
-        });
-    }));
-    if (result.exitCode !== 0) {
-        throw new Error(`Failed to retrieve the git history for file "${file}" with exit code ${result.exitCode}: ${result.stderr}`);
-    }
-    // We only parse the output line starting with our "RESULT:" prefix
-    // See why https://github.com/facebook/docusaurus/pull/10022
-    const regex = includeAuthor
-        ? /(?:^|\n)RESULT:(?<timestamp>\d+),(?<author>.+)(?:$|\n)/
-        : /(?:^|\n)RESULT:(?<timestamp>\d+)(?:$|\n)/;
-    const output = result.stdout.trim();
-    if (!output) {
-        throw new FileNotTrackedError(`Failed to retrieve the git history for file "${file}" because the file is not tracked by git.`);
-    }
-    const match = output.match(regex);
-    if (!match) {
-        throw new Error(`Failed to retrieve the git history for file "${file}" with unexpected output: ${output}`);
-    }
-    const timestampInSeconds = Number(match.groups.timestamp);
-    const timestamp = timestampInSeconds * 1000;
-    const date = new Date(timestamp);
-    if (includeAuthor) {
-        return { date, timestamp, author: match.groups.author };
-    }
-    return { date, timestamp };
-}
-//# sourceMappingURL=gitUtils.js.map

package/lib/gitUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gitUtils.js","sourceRoot":"","sources":["../src/gitUtils.ts"],"names":[],"mappings":"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"}

package/src/gitUtils.ts

@@ -1,200 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import path from 'path';
-import fs from 'fs-extra';
-import os from 'os';
-import _ from 'lodash';
-import execa from 'execa';
-import PQueue from 'p-queue';
-
-// Quite high/conservative concurrency value (it was previously "Infinity")
-// See https://github.com/facebook/docusaurus/pull/10915
-const DefaultGitCommandConcurrency =
-  // TODO Docusaurus v4: bump node, availableParallelism() now always exists
-  (typeof os.availableParallelism === 'function'
-    ? os.availableParallelism()
-    : os.cpus().length) * 4;
-
-const GitCommandConcurrencyEnv = process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY
-  ? parseInt(process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY, 10)
-  : undefined;
-
-const GitCommandConcurrency =
-  GitCommandConcurrencyEnv && GitCommandConcurrencyEnv > 0
-    ? GitCommandConcurrencyEnv
-    : DefaultGitCommandConcurrency;
-
-// We use a queue to avoid running too many concurrent Git commands at once
-// See https://github.com/facebook/docusaurus/issues/10348
-const GitCommandQueue = new PQueue({
-  concurrency: GitCommandConcurrency,
-});
-
-const realHasGitFn = () => {
-  try {
-    return execa.sync('git', ['--version']).exitCode === 0;
-  } catch (error) {
-    return false;
-  }
-};
-
-// The hasGit call is synchronous IO so we memoize it
-// The user won't install Git in the middle of a build anyway...
-const hasGit =
-  process.env.NODE_ENV === 'test' ? realHasGitFn : _.memoize(realHasGitFn);
-
-/** Custom error thrown when git is not found in `PATH`. */
-export class GitNotFoundError extends Error {}
-
-/** Custom error thrown when the current file is not tracked by git. */
-export class FileNotTrackedError extends Error {}
-
-/**
- * Fetches the git history of a file and returns a relevant commit date.
- * It gets the commit date instead of author date so that amended commits
- * can have their dates updated.
- *
- * @throws {@link GitNotFoundError} If git is not found in `PATH`.
- * @throws {@link FileNotTrackedError} If the current file is not tracked by git.
- * @throws Also throws when `git log` exited with non-zero, or when it outputs
- * unexpected text.
- */
-export async function getFileCommitDate(
-  /** Absolute path to the file. */
-  file: string,
-  args: {
-    /**
-     * `"oldest"` is the commit that added the file, following renames;
-     * `"newest"` is the last commit that edited the file.
-     */
-    age?: 'oldest' | 'newest';
-    /** Use `includeAuthor: true` to get the author information as well. */
-    includeAuthor?: false;
-  },
-): Promise<{
-  /** Relevant commit date. */
-  date: Date;
-  /** Timestamp returned from git, converted to **milliseconds**. */
-  timestamp: number;
-}>;
-/**
- * Fetches the git history of a file and returns a relevant commit date.
- * It gets the commit date instead of author date so that amended commits
- * can have their dates updated.
- *
- * @throws {@link GitNotFoundError} If git is not found in `PATH`.
- * @throws {@link FileNotTrackedError} If the current file is not tracked by git.
- * @throws Also throws when `git log` exited with non-zero, or when it outputs
- * unexpected text.
- */
-export async function getFileCommitDate(
-  /** Absolute path to the file. */
-  file: string,
-  args: {
-    /**
-     * `"oldest"` is the commit that added the file, following renames;
-     * `"newest"` is the last commit that edited the file.
-     */
-    age?: 'oldest' | 'newest';
-    includeAuthor: true;
-  },
-): Promise<{
-  /** Relevant commit date. */
-  date: Date;
-  /** Timestamp returned from git, converted to **milliseconds**. */
-  timestamp: number;
-  /** The author's name, as returned from git. */
-  author: string;
-}>;
-
-export async function getFileCommitDate(
-  file: string,
-  {
-    age = 'oldest',
-    includeAuthor = false,
-  }: {
-    age?: 'oldest' | 'newest';
-    includeAuthor?: boolean;
-  },
-): Promise<{
-  date: Date;
-  timestamp: number;
-  author?: string;
-}> {
-  if (!hasGit()) {
-    throw new GitNotFoundError(
-      `Failed to retrieve git history for "${file}" because git is not installed.`,
-    );
-  }
-
-  if (!(await fs.pathExists(file))) {
-    throw new Error(
-      `Failed to retrieve git history for "${file}" because the file does not exist.`,
-    );
-  }
-
-  // We add a "RESULT:" prefix to make parsing easier
-  // See why: https://github.com/facebook/docusaurus/pull/10022
-  const resultFormat = includeAuthor ? 'RESULT:%ct,%an' : 'RESULT:%ct';
-
-  const args = [
-    `--format=${resultFormat}`,
-    '--max-count=1',
-    age === 'oldest' ? '--follow --diff-filter=A' : undefined,
-  ]
-    .filter(Boolean)
-    .join(' ');
-
-  const command = `git -c log.showSignature=false log ${args} -- "${path.basename(
-    file,
-  )}"`;
-
-  const result = (await GitCommandQueue.add(() => {
-    return execa(command, {
-      cwd: path.dirname(file),
-      shell: true,
-    });
-  }))!;
-
-  if (result.exitCode !== 0) {
-    throw new Error(
-      `Failed to retrieve the git history for file "${file}" with exit code ${result.exitCode}: ${result.stderr}`,
-    );
-  }
-
-  // We only parse the output line starting with our "RESULT:" prefix
-  // See why https://github.com/facebook/docusaurus/pull/10022
-  const regex = includeAuthor
-    ? /(?:^|\n)RESULT:(?<timestamp>\d+),(?<author>.+)(?:$|\n)/
-    : /(?:^|\n)RESULT:(?<timestamp>\d+)(?:$|\n)/;
-
-  const output = result.stdout.trim();
-
-  if (!output) {
-    throw new FileNotTrackedError(
-      `Failed to retrieve the git history for file "${file}" because the file is not tracked by git.`,
-    );
-  }
-
-  const match = output.match(regex);
-
-  if (!match) {
-    throw new Error(
-      `Failed to retrieve the git history for file "${file}" with unexpected output: ${output}`,
-    );
-  }
-
-  const timestampInSeconds = Number(match.groups!.timestamp);
-  const timestamp = timestampInSeconds * 1_000;
-  const date = new Date(timestamp);
-
-  if (includeAuthor) {
-    return {date, timestamp, author: match.groups!.author!};
-  }
-  return {date, timestamp};
-}