@semaphore-protocol/cli 0.2.0 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
     <h1 align="center">
         Semaphore CLI
     </h1>
-    <p align="center">A command line tool to set up your Semaphore project and query groups.</p>
+    <p align="center">A command line tool to set up your Semaphore project and get group data.</p>
 </p>
 
 <p align="center">
@@ -46,23 +46,37 @@
     </h4>
 </div>
 
-| ... |
-| --- |
+| Setting up a project, although not particularly complex, can be a lengthy process for some people. The Semaphore CLI reduces the set-up time from a few minutes to a few seconds. In addition, it can also be used to obtain on-chain group data. |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 
 ## 🛠 Install
 
-### npm or yarn
-
-Install the `@semaphore-protocol/cli` package with npm:
+Install the `@semaphore-protocol/cli` package globally:
 
 ```bash
-npm i @semaphore-protocol/cli
+npm i -g @semaphore-protocol/cli
 ```
 
-or yarn:
+or run specific commands with `npx`:
 
 ```bash
-yarn add @semaphore-protocol/cli
+npx @semaphore-protocol/cli init my-app
 ```
 
 ## 📜 Usage
+
+```
+Usage: semaphore [options] [command]
+
+A command line tool to set up your Semaphore project and get group data.
+
+Options:
+-v, --version Show Semaphore CLI version.
+-h, --help Display this help.
+
+Commands:
+init <project-directory> Initialize a Semaphore project with a supported template.
+get-groups [options] Get the list of groups from a supported network (Goerli or Arbitrum).
+get-group [options] <group-id> Get the data of a group from a supported network (Goerli or Arbitrum).
+help [command] Display help for a specific command.
+```

package/dist/index.js

@@ -2,8 +2,8 @@
 
 /**
  * @module @semaphore-protocol/cli
- * @version 0.2.0
- * @file A command line tool to set up your Semaphore project and query groups.
+ * @version 0.4.0
+ * @file A command line tool to set up your Semaphore project and get group data.
  * @copyright Ethereum Foundation 2022
  * @license MIT
  * @see [Github]{@link https://github.com/semaphore-protocol/semaphore/tree/main/packages/cli}
@@ -38,10 +38,10 @@ class Spinner {
 }
 
 const packagePath = `${dirname(fileURLToPath(import.meta.url))}/..`;
-const { version } = JSON.parse(readFileSync(`${packagePath}/package.json`, "utf8"));
+const { description, version } = JSON.parse(readFileSync(`${packagePath}/package.json`, "utf8"));
 program
     .name("semaphore")
-    .description("A command line tool to set up your Semaphore project and query groups.")
+    .description(description)
     .version(version, "-v, --version", "Show Semaphore CLI version.")
     .addHelpText("before", `${figlet.textSync("Semaphore")}\n`)
     .addHelpText("after", "\r")
@@ -58,24 +58,38 @@ program
     .argument("<project-directory>", "Directory of the project.")
     // .option("-t, --template <template-name>", "Supported Semaphore template.", "hardhat")
     .action(async (projectDirectory) => {
-    // const originalDirectory = process.cwd()
-    const spinner = new Spinner(`Creating '${projectDirectory}' project`);
+    const currentDirectory = process.cwd();
+    const spinner = new Spinner(`Creating your project in ${chalk.green(`./${projectDirectory}`)}`);
     const templateURL = `https://registry.npmjs.org/@semaphore-protocol/cli-template-hardhat/-/cli-template-hardhat-${version}.tgz`;
     if (existsSync(projectDirectory)) {
         console.info(`\n ${logSymbols.error}`, `error: the '${projectDirectory}' folder already exists\n`);
         return;
     }
     spinner.start();
-    await download(templateURL, "./", { extract: true });
-    renameSync("package", projectDirectory);
+    await download(templateURL, currentDirectory, { extract: true });
+    renameSync(`${currentDirectory}/package`, `${currentDirectory}/${projectDirectory}`);
     spinner.stop();
-    console.info(` ${logSymbols.success}`, `Your '${projectDirectory}' project is ready!\n`);
+    console.info(` ${logSymbols.success}`, `Your project is ready!\n`);
+    console.info(` Please, install your dependencies by running:\n`);
+    console.info(`   ${chalk.cyan("cd")} ${projectDirectory}`);
+    console.info(`   ${chalk.cyan("npm i")}\n`);
+    const { scripts } = JSON.parse(readFileSync(`${currentDirectory}/${projectDirectory}/package.json`, "utf8"));
+    if (scripts) {
+        console.info(` Available scripts:\n`);
+        console.info(`${Object.keys(scripts)
+            .map((s) => `   ${chalk.cyan(`npm run ${s}`)}`)
+            .join("\n")}\n`);
+    }
 });
 program
     .command("get-groups")
-    .description("Get the list of groups from a supported network (Goerli or Arbitrum).")
+    .description("Get the list of groups from a supported network (goerli or arbitrum).")
     .option("-n, --network <network-name>", "Supported Ethereum network.", "goerli")
     .action(async ({ network }) => {
+    if (!["goerli", "arbitrum"].includes(network)) {
+        console.info(`\n ${logSymbols.error}`, `error: the network '${network}' is not supported\n`);
+        return;
+    }
     const subgraph = new Subgraph(network);
     const spinner = new Spinner("Fetching groups");
     spinner.start();
@@ -102,6 +116,10 @@ program
     .option("--members", "Show group members.")
     .option("--signals", "Show group signals.")
     .action(async (groupId, { network, members, signals }) => {
+    if (!["goerli", "arbitrum"].includes(network)) {
+        console.info(`\n ${logSymbols.error}`, `error: the network '${network}' is not supported\n`);
+        return;
+    }
     const subgraph = new Subgraph(network);
     const spinner = new Spinner(`Fetching group ${groupId}`);
     spinner.start();

package/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@semaphore-protocol/cli",
     "type": "module",
-    "version": "0.2.0",
-    "description": "A command line tool to set up your Semaphore project and query groups.",
+    "version": "0.4.0",
+    "description": "A command line tool to set up your Semaphore project and get group data.",
     "license": "MIT",
     "bin": {
         "semaphore": "dist/index.js"
@@ -32,6 +32,7 @@
         "access": "public"
     },
     "devDependencies": {
+        "@types/clear": "^0.1.2",
         "@types/figlet": "^1.5.5",
         "rollup-plugin-cleanup": "^3.2.1",
         "rollup-plugin-typescript2": "^0.31.2",
@@ -40,7 +41,6 @@
     },
     "dependencies": {
         "@semaphore-protocol/subgraph": "2.6.1",
-        "@types/clear": "^0.1.2",
         "chalk": "^5.1.2",
         "commander": "^9.4.1",
         "download": "^8.0.0",

package/src/index.ts

@@ -10,11 +10,11 @@ import { fileURLToPath } from "url"
 import Spinner from "./spinner.js"
 
 const packagePath = `${dirname(fileURLToPath(import.meta.url))}/..`
-const { version } = JSON.parse(readFileSync(`${packagePath}/package.json`, "utf8"))
+const { description, version } = JSON.parse(readFileSync(`${packagePath}/package.json`, "utf8"))
 
 program
     .name("semaphore")
-    .description("A command line tool to set up your Semaphore project and query groups.")
+    .description(description)
     .version(version, "-v, --version", "Show Semaphore CLI version.")
     .addHelpText("before", `${figlet.textSync("Semaphore")}\n`)
     .addHelpText("after", "\r")
@@ -32,8 +32,8 @@ program
     .argument("<project-directory>", "Directory of the project.")
     // .option("-t, --template <template-name>", "Supported Semaphore template.", "hardhat")
     .action(async (projectDirectory) => {
-        // const originalDirectory = process.cwd()
-        const spinner = new Spinner(`Creating '${projectDirectory}' project`)
+        const currentDirectory = process.cwd()
+        const spinner = new Spinner(`Creating your project in ${chalk.green(`./${projectDirectory}`)}`)
         const templateURL = `https://registry.npmjs.org/@semaphore-protocol/cli-template-hardhat/-/cli-template-hardhat-${version}.tgz`
 
         if (existsSync(projectDirectory)) {
@@ -43,20 +43,40 @@ program
 
         spinner.start()
 
-        await download(templateURL, "./", { extract: true })
+        await download(templateURL, currentDirectory, { extract: true })
 
-        renameSync("package", projectDirectory)
+        renameSync(`${currentDirectory}/package`, `${currentDirectory}/${projectDirectory}`)
 
         spinner.stop()
 
-        console.info(` ${logSymbols.success}`, `Your '${projectDirectory}' project is ready!\n`)
+        console.info(` ${logSymbols.success}`, `Your project is ready!\n`)
+        console.info(` Please, install your dependencies by running:\n`)
+        console.info(`   ${chalk.cyan("cd")} ${projectDirectory}`)
+        console.info(`   ${chalk.cyan("npm i")}\n`)
+
+        const { scripts } = JSON.parse(readFileSync(`${currentDirectory}/${projectDirectory}/package.json`, "utf8"))
+
+        if (scripts) {
+            console.info(` Available scripts:\n`)
+
+            console.info(
+                `${Object.keys(scripts)
+                    .map((s) => `   ${chalk.cyan(`npm run ${s}`)}`)
+                    .join("\n")}\n`
+            )
+        }
     })
 
 program
     .command("get-groups")
-    .description("Get the list of groups from a supported network (Goerli or Arbitrum).")
+    .description("Get the list of groups from a supported network (goerli or arbitrum).")
     .option("-n, --network <network-name>", "Supported Ethereum network.", "goerli")
     .action(async ({ network }) => {
+        if (!["goerli", "arbitrum"].includes(network)) {
+            console.info(`\n ${logSymbols.error}`, `error: the network '${network}' is not supported\n`)
+            return
+        }
+
         const subgraph = new Subgraph(network)
         const spinner = new Spinner("Fetching groups")
 
@@ -90,6 +110,11 @@ program
     .option("--members", "Show group members.")
     .option("--signals", "Show group signals.")
     .action(async (groupId, { network, members, signals }) => {
+        if (!["goerli", "arbitrum"].includes(network)) {
+            console.info(`\n ${logSymbols.error}`, `error: the network '${network}' is not supported\n`)
+            return
+        }
+
         const subgraph = new Subgraph(network)
         const spinner = new Spinner(`Fetching group ${groupId}`)