@gutenye/script.js 2.0.0 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gutenye/script.js",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Write shell scripts in JavaScript",
   "keywords": [
     "shell",

package/src/Command.ts

@@ -210,6 +210,7 @@ export class Command {
     context: Context,
   ) {
     const error =
+      Command.#validateRequired(command, positionals) ??
       Command.#validateOptions(command, options) ??
       Command.#validateChoices(command, positionals)
     if (error) {
@@ -229,6 +230,19 @@ export class Command {
     return this.arguments.map(String).join(' ')
   }
 
+  static #validateRequired(
+    command: Command,
+    positionals: any[],
+  ): string | null {
+    for (let i = 0; i < command.arguments.length; i++) {
+      const arg = command.arguments[i]
+      if (arg.required && positionals[i] == null) {
+        return `Missing required argument: ${arg.rawName}`
+      }
+    }
+    return null
+  }
+
   static #validateOptions(
     command: Command,
     options: Record<string, any>,

package/src/ake/README.md

@@ -4,17 +4,26 @@
 
 ## Start
 
+Install it
+
+```sh
+npm install -g @gutenye/script.js
+```
+
 1. Create an ake file
 
-edit `./ake` file, and make it executable `chmod +x ake`
+Create a `./ake` file, and make it executable `chmod +x ake`
 
 ```ts
-#!/usr/bin/env script.js
+#!/usr/bin/env bun
 
-app.cmd('greetings')
-  .add(() => {
-    console.log('greetings')
-  })
+import { app, $ } from "@gutenye/script.js";
+
+app.cmd("greetings").add(() => {
+  $`echo greetings`;
+});
+
+await app.run();
 ```
 
 2. Run it
@@ -23,7 +32,7 @@ app.cmd('greetings')
 ake greetings   # find the ake file and runs it
 ```
 
-3. Supports Shell Completion 
+3. Supports Shell Completion
 
 - Follow [guide](./completions) to setup
 
@@ -31,14 +40,12 @@ ake greetings   # find the ake file and runs it
 ake <Tab> # uses ake file's completion
 ```
 
-## Use a template
+## Use a template / another location
 
 Create `~/bin.src/ake/template`
 
-## Put ake file in another location
-
-Doesn't touch original project files
-
 ```sh
-akectl init remote # create in ~/bin.src/ake/<dir>
+akectl init local  # create a ake file from template in currenct directory
+akectl init remote  # create in ~/bin.src/ake/<dir>, doesn't touch original project files
+akectl edit # Opens a editor to edit the ake file
 ```