Merge pull request #11803 from PumasAI/jk/engine-commands

Add `call engine julia` commands

Author: cscheid

news/changelog-1.7.md

@@ -88,6 +88,7 @@ All changes included in 1.7:
 
 - ([#12121](https://github.com/quarto-dev/quarto-cli/pull/12121)): Update QuartoNotebookRunner to 0.14.0. Support for evaluating Python cells via [PythonCall.jl](https://github.com/JuliaPy/PythonCall.jl) added. Support for notebook caching via `execute.cache` added.
 - ([#12151](https://github.com/quarto-dev/quarto-cli/pull/12151)): Basic YAML validation is now active for document using Julia engine.
+- ([#11803](https://github.com/quarto-dev/quarto-cli/pull/11803)): Added subcommands `status`, `kill`, `close [--force]` and `log` under the new CLI command `quarto call engine julia`.
 
 ### `jupyter`
 
@@ -105,3 +106,4 @@ All changes included in 1.7:
 - ([#11951](https://github.com/quarto-dev/quarto-cli/issues/11951)): Raw LaTeX table without `tbl-` prefix label for using Quarto crossref are now correctly passed through unmodified.
 - ([#12117](https://github.com/quarto-dev/quarto-cli/issues/12117)): Color output to stdout and stderr is now correctly rendered for `html` format in the Jupyter and Julia engines.
 - ([#12264](https://github.com/quarto-dev/quarto-cli/issues/12264)): Upgrade `dart-sass` to 1.85.1.
+- ([#11803](https://github.com/quarto-dev/quarto-cli/pull/11803)): Added a new CLI command `quarto call`. First users of this interface are the new `quarto call engine julia ...` subcommands.

src/command/call/cmd.ts

@@ -0,0 +1,10 @@
+import { Command } from "cliffy/command/mod.ts";
+import { engineCommand } from "../../execute/engine.ts";
+
+export const callCommand = new Command()
+  .name("call")
+  .description("Access functions of Quarto subsystems such as its rendering engines.")
+  .action(() => {
+    callCommand.showHelp();
+    Deno.exit(1);
+  }).command("engine", engineCommand);

src/command/command.ts

@@ -29,6 +29,7 @@ import { addCommand } from "./add/cmd.ts";
 import { uninstallCommand } from "./uninstall/cmd.ts";
 import { createCommand } from "./create/cmd.ts";
 import { editorSupportCommand } from "./editor-support/cmd.ts";
+import { callCommand } from "./call/cmd.ts";
 
 // deno-lint-ignore no-explicit-any
 export function commands(): Command<any>[] {
@@ -57,5 +58,6 @@ export function commands(): Command<any>[] {
     checkCommand,
     buildJsCommand,
     editorSupportCommand,
+    callCommand,
   ];
 }

src/execute/engine.ts

@@ -31,6 +31,7 @@ import { pandocBuiltInFormats } from "../core/pandoc/pandoc-formats.ts";
 import { gitignoreEntries } from "../project/project-gitignore.ts";
 import { juliaEngine } from "./julia.ts";
 import { ensureFileInformationCache } from "../project/project-shared.ts";
+import { Command } from "cliffy/command/mod.ts";
 
 const kEngines: Map<string, ExecutionEngine> = new Map();
 
@@ -276,3 +277,30 @@ export function projectIgnoreGlobs(dir: string) {
     gitignoreEntries(dir).map((ignore) => `**/${ignore}**`),
   );
 }
+
+export const engineCommand = new Command()
+  .name("engine")
+  .description(
+    `Access functionality specific to quarto's different rendering engines.`,
+  )
+  .action(() => {
+    engineCommand.showHelp();
+    Deno.exit(1);
+  });
+
+kEngines.forEach((engine, name) => {
+  if (engine.populateCommand) {
+    const engineSubcommand = new Command();
+    // fill in some default behavior for each engine command
+    engineSubcommand
+      .description(
+        `Access functionality specific to the ${name} rendering engine.`,
+      )
+      .action(() => {
+        engineSubcommand.showHelp();
+        Deno.exit(1);
+      });
+    engine.populateCommand(engineSubcommand);
+    engineCommand.command(name, engineSubcommand);
+  }
+});