honor QUARTO_VERSION_REQUIREMENT environment variable

Author: cscheid

news/changelog-1.6.md

@@ -129,6 +129,7 @@ All changes included in 1.6:
 - ([#10332](https://github.com/quarto-dev/quarto-cli/issues/10332)): Use `exitWithCleanup` whenever possible instead of `Deno.exit` to clean up temporary resources.
 - ([#10334](https://github.com/quarto-dev/quarto-cli/issues/10334)): Fix `author` field rendered incorrectly in dashboards when multiple authors are present.
 - ([#8383](https://github.com/quarto-dev/quarto-cli/issues/8383)), ([#10087](https://github.com/quarto-dev/quarto-cli/issues/10087)), ([#10369](https://github.coma/quarto-dev/quarto-cli/issues/10369)): Track theme generation and file naming through content hashing to allow different themes to coexist in the same project.
+- ([#10442](https://github.com/quarto-dev/quarto-cli/issues/10442)): Honor the `semver` requirement in `QUARTO_VERSION_REQUIREMENT` and stop execution when that isn't met.
 - ([#10552](https://github.com/quarto-dev/quarto-cli/issues/10552)): Add `contents` shortcode.
 - ([#10581](https://github.com/quarto-dev/quarto-cli/issues/10581)): Add `.landscape` div processing to `typst`, `docx` and `pdf` formats to support pages in landscape orientation.
 - ([#10591](https://github.com/quarto-dev/quarto-cli/issues/10591)): Make fenced div syntax slightly more robust by removing spaces around the `=` sign ahead of Pandoc's reader.

src/quarto.ts

@@ -24,6 +24,7 @@ import { pandocBinaryPath } from "./core/resources.ts";
 import { appendProfileArg, setProfileFromArg } from "./quarto-core/profile.ts";
 import { logError } from "./core/log.ts";
 import { CommandError } from "cliffy/command/_errors.ts";
+import { satisfies } from "semver/mod.ts";
 
 import {
   devConfigsEqual,
@@ -51,11 +52,19 @@ import "./format/imports.ts";
 import { kCliffyImplicitCwd } from "./config/constants.ts";
 import { mainRunner } from "./core/main.ts";
 
-export async function quarto(
-  args: string[],
-  cmdHandler?: (command: Command) => Command,
-  env?: Record<string, string>,
-) {
+const checkVersionRequirement = () => {
+  const versionReq = Deno.env.get("QUARTO_VERSION_REQUIREMENT");
+  if (versionReq) {
+    if (!satisfies(quartoConfig.version(), versionReq)) {
+      error(
+        `Quarto version ${quartoConfig.version()} does not meet semver requirement ${versionReq}`,
+      );
+      Deno.exit(1);
+    }
+  }
+};
+
+const checkReconfiguration = async () => {
   // check for need to reconfigure
   if (quartoConfig.isDebug()) {
     const installed = readInstalledDevConfig();
@@ -65,36 +74,55 @@ export async function quarto(
       Deno.exit(1);
     }
   }
+};
 
-  // passthrough to pandoc
-  if (args[0] === "pandoc" && args[1] !== "help") {
-    const result = await execProcess(
-      {
-        cmd: [pandocBinaryPath(), ...args.slice(1)],
-        env,
-      },
-      undefined,
-      undefined,
-      undefined,
-      true,
+const passThroughPandoc = async (
+  args: string[],
+  env?: Record<string, string>,
+) => {
+  const result = await execProcess(
+    {
+      cmd: [pandocBinaryPath(), ...args.slice(1)],
+      env,
+    },
+    undefined,
+    undefined,
+    undefined,
+    true,
+  );
+  Deno.exit(result.code);
+};
+
+const passThroughTypst = async (
+  args: string[],
+  env?: Record<string, string>,
+) => {
+  if (args[1] === "update") {
+    error(
+      "The 'typst update' command is not supported.\n" +
+        "Please install the latest version of Quarto from http://quarto.org to get the latest supported typst features.",
     );
-    Deno.exit(result.code);
+    Deno.exit(1);
   }
+  const result = await execProcess({
+    cmd: [typstBinaryPath(), ...args.slice(1)],
+    env,
+  });
+  Deno.exit(result.code);
+};
 
-  // passthrough to typst
+export async function quarto(
+  args: string[],
+  cmdHandler?: (command: Command) => Command,
+  env?: Record<string, string>,
+) {
+  await checkReconfiguration();
+  checkVersionRequirement();
+  if (args[0] === "pandoc" && args[1] !== "help") {
+    await passThroughPandoc(args.slice(1), env);
+  }
   if (args[0] === "typst") {
-    if (args[1] === "update") {
-      error(
-        "The 'typst update' command is not supported.\n" +
-          "Please install the latest version of Quarto from http://quarto.org to get the latest supported typst features.",
-      );
-      Deno.exit(1);
-    }
-    const result = await execProcess({
-      cmd: [typstBinaryPath(), ...args.slice(1)],
-      env,
-    });
-    Deno.exit(result.code);
+    await passThroughTypst(args, env);
   }
 
   // passthrough to run handlers