dev-call - new command to generate JSON information

Author: cscheid

src/command/command.ts

@@ -30,6 +30,7 @@ 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";
+import { devCallCommand } from "./dev-call/cmd.ts";
 
 // deno-lint-ignore no-explicit-any
 export function commands(): Command<any>[] {
@@ -59,5 +60,6 @@ export function commands(): Command<any>[] {
     buildJsCommand,
     editorSupportCommand,
     callCommand,
+    devCallCommand,
   ];
 }

src/command/dev-call/cmd.ts

@@ -0,0 +1,58 @@
+import { Command } from "cliffy/command/mod.ts";
+import { quartoConfig } from "../../core/quarto.ts";
+import { commands } from "../command.ts";
+
+type CommandOptionInfo = {
+  name: string;
+  description: string;
+  args: [];
+  flags: string[];
+  equalsSign: boolean;
+  typeDefinition: string;
+};
+
+type CommandInfo = {
+  name: string;
+  description: string;
+  options: CommandOptionInfo[];
+  // arguments: string[];
+  // subcommands: CommandInfo[];
+  // aliases: string[];
+  examples: { name: string; description: string }[];
+  // flags: string[];
+  usage: string;
+  commands: CommandInfo[];
+};
+
+const generateCliInfoCommand = new Command()
+  .name("cli-info")
+  .description("Generate JSON information about the Quarto CLI.")
+  .action(async () => {
+    const output: Record<string, unknown> = {};
+    output["version"] = quartoConfig.version();
+    const commandsInfo: CommandInfo[] = [];
+    output["commands"] = commandsInfo;
+    // deno-lint-ignore no-explicit-any
+    const cmdAsJson = (cmd: any): CommandInfo => {
+      return {
+        name: cmd.getName(),
+        description: cmd.getDescription(),
+        options: cmd.getOptions(),
+        usage: cmd.getUsage(),
+        examples: cmd.getExamples(),
+        commands: cmd.getCommands().map(cmdAsJson),
+      };
+    };
+    output["commands"] = commands().map(cmdAsJson);
+    console.log(JSON.stringify(output, null, 2));
+  });
+
+export const devCallCommand = new Command()
+  .name("dev-call")
+  .description(
+    "Access internals of Quarto - this command is not intended for general use.",
+  )
+  .action(() => {
+    devCallCommand.showHelp();
+    Deno.exit(1);
+  }).command("cli-info", generateCliInfoCommand);