feat(cli): Add apps command to interact with applications.

Author: brunomenezes

.changeset/thirty-trees-win.md

@@ -0,0 +1,5 @@
+---
+"@cartesi/cli": patch
+---
+
+Add new apps command to interact with cartesi application. First option is to enable and disable an application.

apps/cli/src/commands/apps.ts

@@ -0,0 +1,48 @@
+import { Command, Option } from "@commander-js/extra-typings";
+import chalk from "chalk";
+import { getProjectName } from "../base";
+import { getDeployments, setApplicationStatus } from "../exec/rollups";
+
+const choices = ["enabled", "disabled"] as const;
+
+export const createAppsCommand = () => {
+    return new Command("apps")
+        .description("Interact with applications.")
+        .showHelpAfterError(
+            chalk.cyan("use cartesi apps --help for additional information"),
+        )
+        .addOption(
+            new Option(
+                "--project-name <name>",
+                `name of project (used by docker compose and cartesi-rollups-node). ${chalk.cyan("(Default: Current working directory)")}`,
+            ),
+        )
+        .addOption(
+            new Option("--set <status>", "Change the application status")
+                .choices(choices)
+                .conflicts(["list"]),
+        )
+        .action(async (options) => {
+            const projectName = getProjectName(options);
+            if (options.set) {
+                const result = await setApplicationStatus({
+                    application: projectName,
+                    projectName: projectName,
+                    force: true,
+                    status: options.set,
+                });
+
+                if (result.ok) {
+                    console.log(chalk.green(result.message));
+                } else {
+                    console.log(chalk.red(result.message));
+                }
+            } else {
+                const deployments = await getDeployments({
+                    projectName: projectName,
+                });
+
+                console.log(chalk.cyan(JSON.stringify(deployments, null, " ")));
+            }
+        });
+};

apps/cli/src/exec/rollups.ts

@@ -62,6 +62,41 @@ const parseDeployment = (
     templateHash: deployment.template_hash as Hex,
 });
 
+type SetApplicationStatusReturn = { ok: boolean; message: string };
+export const setApplicationStatus = async (options: {
+    application: string | Address;
+    force: boolean;
+    projectName: string;
+    status: "disabled" | "enabled";
+}): Promise<SetApplicationStatusReturn> => {
+    try {
+        const args = [options.application, options.status];
+
+        if (options.force) {
+            args.push("--yes");
+        }
+
+        const { stdout: confirmation } = await execa("docker", [
+            "compose",
+            "--project-name",
+            options.projectName,
+            "exec",
+            "rollups_node",
+            "cartesi-rollups-cli",
+            "app",
+            "status",
+            ...args,
+        ]);
+
+        return { ok: true, message: confirmation };
+    } catch {
+        return {
+            ok: false,
+            message: `Failed to change ${options.application} status to ${options.status}`,
+        };
+    }
+};
+
 export const getDeployments = async (
     options: ComposeParams,
 ): Promise<RollupsDeployment[]> => {
@@ -549,7 +584,7 @@ export const removeApplication = async (options: {
     const removeArgs = [application];
 
     if (force) {
-        removeArgs.push("--force");
+        removeArgs.push("--yes");
     }
 
     return execa("docker", [

apps/cli/src/index.ts

@@ -1,6 +1,7 @@
 import { Command } from "@commander-js/extra-typings";
 import pkg from "../package.json" with { type: "json" };
 import { createAddressBookCommand } from "./commands/address-book.js";
+import { createAppsCommand } from "./commands/apps.js";
 import { createBuildCommand } from "./commands/build.js";
 import { createCleanCommand } from "./commands/clean.js";
 import { createCreateCommand } from "./commands/create.js";
@@ -29,6 +30,7 @@ const program = new Command()
     .version(pkg.version)
     .addHelpText("before", splash)
     .addCommand(createAddressBookCommand())
+    .addCommand(createAppsCommand())
     .addCommand(createBuildCommand())
     .addCommand(createCleanCommand())
     .addCommand(createCreateCommand())