breadc 0.0.0 → 0.1.0

package/README.md

@@ -1,8 +1,8 @@
 # Breadc
 
-[![CI](https://github.com/yjl9903/Breadc/actions/workflows/ci.yml/badge.svg)](https://github.com/yjl9903/Breadc/actions/workflows/ci.yml)
+[![version](https://img.shields.io/npm/v/breadc?color=rgb%2850%2C203%2C86%29&label=Breadc)](https://www.npmjs.com/package/breadc) [![CI](https://github.com/yjl9903/Breadc/actions/workflows/ci.yml/badge.svg)](https://github.com/yjl9903/Breadc/actions/workflows/ci.yml)
 
-Yet another Command Line Application Framework powered by [minimist](https://www.npmjs.com/package/minimist).
+Yet another Command Line Application Framework powered by [minimist](https://www.npmjs.com/package/minimist), but with fully [TypeScript](https://www.typescriptlang.org/) support.
 
 ## Installation
 
@@ -15,11 +15,27 @@ npm i breadc
 ```ts
 import Breadc from 'breadc'
 
-const cli = Breadc('cli', { version: '1.0.0' })
+const cli = Breadc('vite', { version: '1.0.0' })
+  .option('--host <host>')
+  .option('--port <port>')
 
-cli.parse(process.argv.slice(2))
+cli.command('dev')
+  .action((option) => {
+    console.log(`Host: ${option.host}`);
+    console.log(`Port: ${option.port}`);
+  })
+
+cli.run(process.argv.slice(2))
+  .catch(err => cli.logger.error(err.message))
 ```
 
+If you are using IDEs that support TypeScript (like [Visual Studio Code](https://code.visualstudio.com/)), move your cursor to the parameter `option` in this `dev` command, and then you will find the `option` is automatically typed with `{ host: string, port: string }` or `Record<'host' | 'port', string>`.
+
+## Inspiration
+
++ [cac](https://github.com/cacjs/cac): Simple yet powerful framework for building command-line apps.
++ [TypeScript: Documentation - Template Literal Types](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html)
+
 ## License
 
 MIT License © 2021 [XLor](https://github.com/yjl9903)

package/dist/index.cjs

@@ -1,62 +1,259 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const kolorist = require('kolorist');
 const minimist = require('minimist');
+const createDebug = require('debug');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e["default"] : e; }
 
+const kolorist__default = /*#__PURE__*/_interopDefaultLegacy(kolorist);
 const minimist__default = /*#__PURE__*/_interopDefaultLegacy(minimist);
+const createDebug__default = /*#__PURE__*/_interopDefaultLegacy(createDebug);
+
+function createDefaultLogger(name) {
+  const debug = createDebug__default(name + ":breadc");
+  return {
+    println(message) {
+      console.log(message);
+    },
+    info(message, ...args) {
+      console.log(`${kolorist.blue("INFO")} ${message}`, ...args);
+    },
+    warn(message, ...args) {
+      console.log(`${kolorist.yellow("WARN")} ${message}`, ...args);
+    },
+    error(message, ...args) {
+      console.log(`${kolorist.red("ERROR")} ${message}`, ...args);
+    },
+    debug(message, ...args) {
+      debug(message, ...args);
+    }
+  };
+}
+
+const _Option = class {
+  constructor(format, config = {}) {
+    const match = _Option.OptionRE.exec(format);
+    if (match) {
+      if (match[3]) {
+        this.type = "string";
+      } else {
+        this.type = "boolean";
+      }
+      this.name = match[2];
+      if (match[1]) {
+        this.shortcut = match[1][1];
+      }
+    } else {
+      throw new Error(`Can not parse option format from "${format}"`);
+    }
+    this.description = config.description ?? "";
+    this.construct = config.construct ?? ((text) => text ?? config.default ?? void 0);
+  }
+};
+let Option = _Option;
+Option.OptionRE = /^(-[a-zA-Z], )?--([a-zA-Z.]+)( \[[a-zA-Z]+\]| <[a-zA-Z]+>)?$/;
+
+class Command {
+  constructor(format, config) {
+    this.options = [];
+    this.format = config.condition ? [format] : format.split(" ").map((t) => t.trim()).filter(Boolean);
+    this.description = config.description ?? "";
+    this.conditionFn = config.condition;
+    this.logger = config.logger;
+  }
+  option(format, configOrDescription = "", otherConfig = {}) {
+    const config = otherConfig;
+    if (typeof configOrDescription === "string") {
+      config.description = configOrDescription;
+    }
+    try {
+      const option = new Option(format, config);
+      this.options.push(option);
+    } catch (error) {
+      this.logger.warn(error.message);
+    }
+    return this;
+  }
+  shouldRun(args) {
+    if (this.conditionFn) {
+      return this.conditionFn(args);
+    } else {
+      const isArg = (t) => t[0] !== "[" && t[0] !== "<";
+      for (let i = 0; i < this.format.length; i++) {
+        if (isArg(this.format[i])) {
+          return true;
+        }
+        if (i >= args["_"].length || this.format[i] !== args["_"][i]) {
+          return false;
+        }
+      }
+      return true;
+    }
+  }
+  parseArgs(args) {
+    if (this.conditionFn) {
+      const argumentss2 = args["_"];
+      const options2 = args;
+      delete options2["_"];
+      return {
+        command: this,
+        arguments: argumentss2,
+        options: args
+      };
+    }
+    const isArg = (t) => t[0] !== "[" && t[0] !== "<";
+    const argumentss = [];
+    for (let i = 0; i < this.format.length; i++) {
+      if (isArg(this.format[i]))
+        continue;
+      if (i < args["_"].length) {
+        if (this.format[i].startsWith("[...")) {
+          argumentss.push(args["_"].slice(i));
+        } else {
+          argumentss.push(args["_"][i]);
+        }
+      } else {
+        if (this.format[i].startsWith("<")) {
+          argumentss.push(void 0);
+        } else if (this.format[i].startsWith("[...")) {
+          argumentss.push([]);
+        } else if (this.format[i].startsWith("[")) {
+          argumentss.push(void 0);
+        } else ;
+      }
+    }
+    const options = args;
+    delete options["_"];
+    return {
+      command: this,
+      arguments: argumentss,
+      options: args
+    };
+  }
+  action(fn) {
+    this.actionFn = fn;
+    return this;
+  }
+  async run(...args) {
+    this.actionFn && this.actionFn(...args);
+  }
+}
+Command.MaxDep = 4;
+function createVersionCommand(breadc) {
+  return new Command("-h, --help", {
+    condition(args) {
+      const isEmpty = !args["_"].length && !args["--"]?.length;
+      if (args.help && isEmpty) {
+        return true;
+      } else if (args.h && isEmpty) {
+        return true;
+      } else {
+        return false;
+      }
+    },
+    logger: breadc.logger
+  }).action(() => {
+    breadc.logger.println("Help");
+  });
+}
+function createHelpCommand(breadc) {
+  return new Command("-v, --version", {
+    condition(args) {
+      const isEmpty = !args["_"].length && !args["--"]?.length;
+      if (args.version && isEmpty) {
+        return true;
+      } else if (args.v && isEmpty) {
+        return true;
+      } else {
+        return false;
+      }
+    },
+    logger: breadc.logger
+  }).action(() => {
+    breadc.logger.println(`${breadc.name}/${breadc.version}`);
+  });
+}
 
 class Breadc {
   constructor(name, option) {
     this.options = [];
+    this.commands = [];
     this.name = name;
-    this.version = option.version;
+    this.version = option.version ?? "unknown";
+    this.logger = option.logger ?? createDefaultLogger(name);
+    const breadc = {
+      name: this.name,
+      version: this.version,
+      logger: this.logger,
+      options: this.options,
+      commands: this.commands
+    };
+    this.commands = [createVersionCommand(breadc), createHelpCommand(breadc)];
   }
-  option(text) {
+  option(format, configOrDescription = "", otherConfig = {}) {
+    const config = otherConfig;
+    if (typeof configOrDescription === "string") {
+      config.description = configOrDescription;
+    }
     try {
-      const option = new BreadcOption(text);
+      const option = new Option(format, config);
       this.options.push(option);
     } catch (error) {
+      this.logger.warn(error.message);
     }
     return this;
   }
-  command(text) {
-    return new Breadcommand(this, text);
+  command(format, config = {}) {
+    const command = new Command(format, { ...config, logger: this.logger });
+    this.commands.push(command);
+    return command;
   }
   parse(args) {
+    const allowOptions = [this.options, this.commands.map((c) => c.options)].flat();
+    const alias = allowOptions.reduce((map, o) => {
+      if (o.shortcut) {
+        map[o.shortcut] = o.name;
+      }
+      return map;
+    }, {});
     const argv = minimist__default(args, {
-      string: this.options.filter((o) => o.type === "string").map((o) => o.name),
-      boolean: this.options.filter((o) => o.type === "boolean").map((o) => o.name)
+      string: allowOptions.filter((o) => o.type === "string").map((o) => o.name),
+      boolean: allowOptions.filter((o) => o.type === "boolean").map((o) => o.name),
+      alias
     });
-    return argv;
-  }
-}
-class Breadcommand {
-  constructor(breadc, text) {
-    this.breadc = breadc;
-  }
-}
-const _BreadcOption = class {
-  constructor(text) {
-    if (_BreadcOption.BooleanRE.test(text)) {
-      this.type = "boolean";
-    } else {
-      this.type = "string";
+    for (const shortcut of Object.keys(alias)) {
+      delete argv[shortcut];
     }
-    const match = _BreadcOption.NameRE.exec(text);
-    if (match) {
-      this.name = match[1];
-    } else {
-      throw new Error(`Can not extract option name from "${text}"`);
+    for (const command of this.commands) {
+      if (command.shouldRun(argv)) {
+        return command.parseArgs(argv);
+      }
     }
+    const argumentss = argv["_"];
+    const options = argv;
+    delete options["_"];
+    return {
+      command: void 0,
+      arguments: argumentss,
+      options
+    };
   }
-};
-let BreadcOption = _BreadcOption;
-BreadcOption.BooleanRE = /^--[a-zA-Z.]+$/;
-BreadcOption.NameRE = /--([a-zA-Z.]+)/;
+  async run(args) {
+    const parsed = this.parse(args);
+    if (parsed.command) {
+      parsed.command.run(...parsed.arguments, parsed.options);
+    }
+  }
+}
 
 function breadc(name, option = {}) {
-  return new Breadc(name, { version: option.version ?? "unknown" });
+  return new Breadc(name, option);
 }
 
-module.exports = breadc;
+exports.kolorist = kolorist__default;
+exports.minimist = minimist__default;
+exports.createDebug = createDebug__default;
+exports["default"] = breadc;

package/dist/index.d.ts

@@ -1,24 +1,107 @@
-import minimist from 'minimist';
+import { ParsedArgs } from 'minimist';
+export { default as minimist } from 'minimist';
+export { default as kolorist } from 'kolorist';
+export { default as createDebug } from 'debug';
 
-declare class Breadc {
-    private readonly name;
-    private readonly version;
-    private readonly options;
-    constructor(name: string, option: {
-        version: string;
-    });
-    option(text: string): this;
-    command(text: string): Breadcommand;
-    parse(args: string[]): minimist.ParsedArgs;
+interface OptionConfig<T = string> {
+    description?: string;
+    default?: T;
+    construct?: (rawText?: string) => T;
 }
-declare class Breadcommand {
-    private readonly breadc;
-    constructor(breadc: Breadc, text: string);
+/**
+ * Option
+ *
+ * Option format must follow:
+ * + --option
+ * + -o, --option
+ * + --option <arg>
+ * + --option [arg]
+ */
+declare class Option<T extends string = string, U = ExtractOption<T>> {
+    private static OptionRE;
+    readonly name: string;
+    readonly shortcut?: string;
+    readonly description: string;
+    readonly type: 'string' | 'boolean';
+    readonly construct: (rawText: string | undefined) => any;
+    constructor(format: T, config?: OptionConfig);
+}
+
+declare type ConditionFn = (args: ParsedArgs) => boolean;
+interface CommandConfig {
+    description?: string;
+}
+declare class Command<F extends string = string, GlobalOption extends string | never = never, CommandOption extends string | never = never> {
+    private static MaxDep;
+    private readonly conditionFn?;
+    private readonly logger;
+    readonly format: string[];
+    readonly description: string;
+    readonly options: Option[];
+    private actionFn?;
+    constructor(format: F, config: CommandConfig & {
+        condition?: ConditionFn;
+        logger: Logger;
+    });
+    option<OF extends string>(format: OF, description: string, config?: Omit<OptionConfig, 'description'>): Command<F, GlobalOption, CommandOption | ExtractOption<OF>>;
+    option<OF extends string>(format: OF, config?: OptionConfig): Command<F, GlobalOption, CommandOption | ExtractOption<OF>>;
+    shouldRun(args: ParsedArgs): boolean;
+    parseArgs(args: ParsedArgs): ParseResult;
+    action(fn: ActionFn<ExtractCommand<F>, GlobalOption | CommandOption>): this;
+    run(...args: any[]): Promise<void>;
 }
 
-interface Option {
+interface AppOption {
     version?: string;
+    help?: string | string[] | (() => string | string[]);
+    logger?: Logger;
 }
-declare function breadc(name: string, option?: Option): Breadc;
+interface Logger {
+    println: (message: string) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    debug: (message: string, ...args: any[]) => void;
+}
+interface ParseResult {
+    command: Command | undefined;
+    arguments: any[];
+    options: Record<string, string>;
+}
+declare type Lowercase = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z';
+declare type Uppercase = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z';
+declare type Letter = Lowercase | Uppercase;
+/**
+ * Extract option name type
+ *
+ * Examples:
+ * + const t1: ExtractOption<'--option' | '--hello'> = 'hello'
+ * + const t2: ExtractOption<'-r, --root'> = 'root'
+ */
+declare type ExtractOption<T extends string> = T extends `-${Letter}, --${infer R} [${infer U}]` ? R : T extends `-${Letter}, --${infer R} <${infer U}>` ? R : T extends `-${Letter}, --${infer R}` ? R : T extends `--${infer R} [${infer U}]` ? R : T extends `--${infer R} <${infer U}>` ? R : T extends `--${infer R}` ? R : never;
+declare type Push<T extends any[], U> = [...T, U];
+declare type ActionFn<T extends any[], Option extends string = never> = (...arg: Push<T, Record<Option, string>>) => void;
+/**
+ * Max Dep: 4
+ *
+ * Generated by: npx tsx scripts/genType.ts 4
+ */
+declare type ExtractCommand<T extends string> = T extends `[${infer P1}] [${infer P2}] [${infer P3}] [...${infer P4}]` ? [string | undefined, string | undefined, string | undefined, string[]] : T extends `[${infer P1}] [${infer P2}] [${infer P3}] [${infer P4}]` ? [string | undefined, string | undefined, string | undefined, string | undefined] : T extends `<${infer P1}> [${infer P2}] [${infer P3}] [...${infer P4}]` ? [string, string | undefined, string | undefined, string[]] : T extends `<${infer P1}> [${infer P2}] [${infer P3}] [${infer P4}]` ? [string, string | undefined, string | undefined, string | undefined] : T extends `<${infer P1}> <${infer P2}> [${infer P3}] [...${infer P4}]` ? [string, string, string | undefined, string[]] : T extends `<${infer P1}> <${infer P2}> [${infer P3}] [${infer P4}]` ? [string, string, string | undefined, string | undefined] : T extends `<${infer P1}> <${infer P2}> <${infer P3}> [...${infer P4}]` ? [string, string, string, string[]] : T extends `<${infer P1}> <${infer P2}> <${infer P3}> [${infer P4}]` ? [string, string, string, string | undefined] : T extends `<${infer P1}> <${infer P2}> <${infer P3}> <${infer P4}>` ? [string, string, string, string] : T extends `${infer P1} [${infer P2}] [${infer P3}] [...${infer P4}]` ? [string | undefined, string | undefined, string[]] : T extends `${infer P1} [${infer P2}] [${infer P3}] [${infer P4}]` ? [string | undefined, string | undefined, string | undefined] : T extends `${infer P1} <${infer P2}> [${infer P3}] [...${infer P4}]` ? [string, string | undefined, string[]] : T extends `${infer P1} <${infer P2}> [${infer P3}] [${infer P4}]` ? [string, string | undefined, string | undefined] : T extends `${infer P1} <${infer P2}> <${infer P3}> [...${infer P4}]` ? [string, string, string[]] : T extends `${infer P1} <${infer P2}> <${infer P3}> [${infer P4}]` ? [string, string, string | undefined] : T extends `${infer P1} <${infer P2}> <${infer P3}> <${infer P4}>` ? [string, string, string] : T extends `${infer P1} ${infer P2} [${infer P3}] [...${infer P4}]` ? [string | undefined, string[]] : T extends `${infer P1} ${infer P2} [${infer P3}] [${infer P4}]` ? [string | undefined, string | undefined] : T extends `${infer P1} ${infer P2} <${infer P3}> [...${infer P4}]` ? [string, string[]] : T extends `${infer P1} ${infer P2} <${infer P3}> [${infer P4}]` ? [string, string | undefined] : T extends `${infer P1} ${infer P2} <${infer P3}> <${infer P4}>` ? [string, string] : T extends `${infer P1} ${infer P2} ${infer P3} [...${infer P4}]` ? [string[]] : T extends `${infer P1} ${infer P2} ${infer P3} [${infer P4}]` ? [string | undefined] : T extends `${infer P1} ${infer P2} ${infer P3} <${infer P4}>` ? [string] : T extends `[${infer P1}] [${infer P2}] [...${infer P3}]` ? [string | undefined, string | undefined, string[]] : T extends `[${infer P1}] [${infer P2}] [${infer P3}]` ? [string | undefined, string | undefined, string | undefined] : T extends `<${infer P1}> [${infer P2}] [...${infer P3}]` ? [string, string | undefined, string[]] : T extends `<${infer P1}> [${infer P2}] [${infer P3}]` ? [string, string | undefined, string | undefined] : T extends `<${infer P1}> <${infer P2}> [...${infer P3}]` ? [string, string, string[]] : T extends `<${infer P1}> <${infer P2}> [${infer P3}]` ? [string, string, string | undefined] : T extends `<${infer P1}> <${infer P2}> <${infer P3}>` ? [string, string, string] : T extends `${infer P1} [${infer P2}] [...${infer P3}]` ? [string | undefined, string[]] : T extends `${infer P1} [${infer P2}] [${infer P3}]` ? [string | undefined, string | undefined] : T extends `${infer P1} <${infer P2}> [...${infer P3}]` ? [string, string[]] : T extends `${infer P1} <${infer P2}> [${infer P3}]` ? [string, string | undefined] : T extends `${infer P1} <${infer P2}> <${infer P3}>` ? [string, string] : T extends `${infer P1} ${infer P2} [...${infer P3}]` ? [string[]] : T extends `${infer P1} ${infer P2} [${infer P3}]` ? [string | undefined] : T extends `${infer P1} ${infer P2} <${infer P3}>` ? [string] : T extends `${infer P1} ${infer P2} ${infer P3}` ? [] : T extends `[${infer P1}] [...${infer P2}]` ? [string | undefined, string[]] : T extends `[${infer P1}] [${infer P2}]` ? [string | undefined, string | undefined] : T extends `<${infer P1}> [...${infer P2}]` ? [string, string[]] : T extends `<${infer P1}> [${infer P2}]` ? [string, string | undefined] : T extends `<${infer P1}> <${infer P2}>` ? [string, string] : T extends `${infer P1} [...${infer P2}]` ? [string[]] : T extends `${infer P1} [${infer P2}]` ? [string | undefined] : T extends `${infer P1} <${infer P2}>` ? [string] : T extends `${infer P1} ${infer P2}` ? [] : T extends `[...${infer P1}]` ? [string[]] : T extends `[${infer P1}]` ? [string | undefined] : T extends `<${infer P1}>` ? [string] : T extends `${infer P1}` ? [] : never;
+
+declare class Breadc<GlobalOption extends string | never = never> {
+    private readonly name;
+    private readonly version;
+    private readonly options;
+    private readonly commands;
+    readonly logger: Logger;
+    constructor(name: string, option: AppOption);
+    option<F extends string>(format: F, description: string, config?: Omit<OptionConfig, 'description'>): Breadc<GlobalOption | ExtractOption<F>>;
+    option<F extends string>(format: F, config?: OptionConfig): Breadc<GlobalOption | ExtractOption<F>>;
+    command<F extends string>(format: F, config?: CommandConfig): Command<F, GlobalOption>;
+    parse(args: string[]): ParseResult;
+    run(args: string[]): Promise<void>;
+}
+
+declare function breadc(name: string, option?: AppOption): Breadc<never>;
 
 export { breadc as default };

package/dist/index.mjs

@@ -1,56 +1,249 @@
+import { blue, yellow, red } from 'kolorist';
+export { default as kolorist } from 'kolorist';
 import minimist from 'minimist';
+export { default as minimist } from 'minimist';
+import createDebug from 'debug';
+export { default as createDebug } from 'debug';
+
+function createDefaultLogger(name) {
+  const debug = createDebug(name + ":breadc");
+  return {
+    println(message) {
+      console.log(message);
+    },
+    info(message, ...args) {
+      console.log(`${blue("INFO")} ${message}`, ...args);
+    },
+    warn(message, ...args) {
+      console.log(`${yellow("WARN")} ${message}`, ...args);
+    },
+    error(message, ...args) {
+      console.log(`${red("ERROR")} ${message}`, ...args);
+    },
+    debug(message, ...args) {
+      debug(message, ...args);
+    }
+  };
+}
+
+const _Option = class {
+  constructor(format, config = {}) {
+    const match = _Option.OptionRE.exec(format);
+    if (match) {
+      if (match[3]) {
+        this.type = "string";
+      } else {
+        this.type = "boolean";
+      }
+      this.name = match[2];
+      if (match[1]) {
+        this.shortcut = match[1][1];
+      }
+    } else {
+      throw new Error(`Can not parse option format from "${format}"`);
+    }
+    this.description = config.description ?? "";
+    this.construct = config.construct ?? ((text) => text ?? config.default ?? void 0);
+  }
+};
+let Option = _Option;
+Option.OptionRE = /^(-[a-zA-Z], )?--([a-zA-Z.]+)( \[[a-zA-Z]+\]| <[a-zA-Z]+>)?$/;
+
+class Command {
+  constructor(format, config) {
+    this.options = [];
+    this.format = config.condition ? [format] : format.split(" ").map((t) => t.trim()).filter(Boolean);
+    this.description = config.description ?? "";
+    this.conditionFn = config.condition;
+    this.logger = config.logger;
+  }
+  option(format, configOrDescription = "", otherConfig = {}) {
+    const config = otherConfig;
+    if (typeof configOrDescription === "string") {
+      config.description = configOrDescription;
+    }
+    try {
+      const option = new Option(format, config);
+      this.options.push(option);
+    } catch (error) {
+      this.logger.warn(error.message);
+    }
+    return this;
+  }
+  shouldRun(args) {
+    if (this.conditionFn) {
+      return this.conditionFn(args);
+    } else {
+      const isArg = (t) => t[0] !== "[" && t[0] !== "<";
+      for (let i = 0; i < this.format.length; i++) {
+        if (isArg(this.format[i])) {
+          return true;
+        }
+        if (i >= args["_"].length || this.format[i] !== args["_"][i]) {
+          return false;
+        }
+      }
+      return true;
+    }
+  }
+  parseArgs(args) {
+    if (this.conditionFn) {
+      const argumentss2 = args["_"];
+      const options2 = args;
+      delete options2["_"];
+      return {
+        command: this,
+        arguments: argumentss2,
+        options: args
+      };
+    }
+    const isArg = (t) => t[0] !== "[" && t[0] !== "<";
+    const argumentss = [];
+    for (let i = 0; i < this.format.length; i++) {
+      if (isArg(this.format[i]))
+        continue;
+      if (i < args["_"].length) {
+        if (this.format[i].startsWith("[...")) {
+          argumentss.push(args["_"].slice(i));
+        } else {
+          argumentss.push(args["_"][i]);
+        }
+      } else {
+        if (this.format[i].startsWith("<")) {
+          argumentss.push(void 0);
+        } else if (this.format[i].startsWith("[...")) {
+          argumentss.push([]);
+        } else if (this.format[i].startsWith("[")) {
+          argumentss.push(void 0);
+        } else ;
+      }
+    }
+    const options = args;
+    delete options["_"];
+    return {
+      command: this,
+      arguments: argumentss,
+      options: args
+    };
+  }
+  action(fn) {
+    this.actionFn = fn;
+    return this;
+  }
+  async run(...args) {
+    this.actionFn && this.actionFn(...args);
+  }
+}
+Command.MaxDep = 4;
+function createVersionCommand(breadc) {
+  return new Command("-h, --help", {
+    condition(args) {
+      const isEmpty = !args["_"].length && !args["--"]?.length;
+      if (args.help && isEmpty) {
+        return true;
+      } else if (args.h && isEmpty) {
+        return true;
+      } else {
+        return false;
+      }
+    },
+    logger: breadc.logger
+  }).action(() => {
+    breadc.logger.println("Help");
+  });
+}
+function createHelpCommand(breadc) {
+  return new Command("-v, --version", {
+    condition(args) {
+      const isEmpty = !args["_"].length && !args["--"]?.length;
+      if (args.version && isEmpty) {
+        return true;
+      } else if (args.v && isEmpty) {
+        return true;
+      } else {
+        return false;
+      }
+    },
+    logger: breadc.logger
+  }).action(() => {
+    breadc.logger.println(`${breadc.name}/${breadc.version}`);
+  });
+}
 
 class Breadc {
   constructor(name, option) {
     this.options = [];
+    this.commands = [];
     this.name = name;
-    this.version = option.version;
+    this.version = option.version ?? "unknown";
+    this.logger = option.logger ?? createDefaultLogger(name);
+    const breadc = {
+      name: this.name,
+      version: this.version,
+      logger: this.logger,
+      options: this.options,
+      commands: this.commands
+    };
+    this.commands = [createVersionCommand(breadc), createHelpCommand(breadc)];
   }
-  option(text) {
+  option(format, configOrDescription = "", otherConfig = {}) {
+    const config = otherConfig;
+    if (typeof configOrDescription === "string") {
+      config.description = configOrDescription;
+    }
     try {
-      const option = new BreadcOption(text);
+      const option = new Option(format, config);
       this.options.push(option);
     } catch (error) {
+      this.logger.warn(error.message);
     }
     return this;
   }
-  command(text) {
-    return new Breadcommand(this, text);
+  command(format, config = {}) {
+    const command = new Command(format, { ...config, logger: this.logger });
+    this.commands.push(command);
+    return command;
   }
   parse(args) {
+    const allowOptions = [this.options, this.commands.map((c) => c.options)].flat();
+    const alias = allowOptions.reduce((map, o) => {
+      if (o.shortcut) {
+        map[o.shortcut] = o.name;
+      }
+      return map;
+    }, {});
     const argv = minimist(args, {
-      string: this.options.filter((o) => o.type === "string").map((o) => o.name),
-      boolean: this.options.filter((o) => o.type === "boolean").map((o) => o.name)
+      string: allowOptions.filter((o) => o.type === "string").map((o) => o.name),
+      boolean: allowOptions.filter((o) => o.type === "boolean").map((o) => o.name),
+      alias
     });
-    return argv;
-  }
-}
-class Breadcommand {
-  constructor(breadc, text) {
-    this.breadc = breadc;
-  }
-}
-const _BreadcOption = class {
-  constructor(text) {
-    if (_BreadcOption.BooleanRE.test(text)) {
-      this.type = "boolean";
-    } else {
-      this.type = "string";
+    for (const shortcut of Object.keys(alias)) {
+      delete argv[shortcut];
     }
-    const match = _BreadcOption.NameRE.exec(text);
-    if (match) {
-      this.name = match[1];
-    } else {
-      throw new Error(`Can not extract option name from "${text}"`);
+    for (const command of this.commands) {
+      if (command.shouldRun(argv)) {
+        return command.parseArgs(argv);
+      }
     }
+    const argumentss = argv["_"];
+    const options = argv;
+    delete options["_"];
+    return {
+      command: void 0,
+      arguments: argumentss,
+      options
+    };
   }
-};
-let BreadcOption = _BreadcOption;
-BreadcOption.BooleanRE = /^--[a-zA-Z.]+$/;
-BreadcOption.NameRE = /--([a-zA-Z.]+)/;
+  async run(args) {
+    const parsed = this.parse(args);
+    if (parsed.command) {
+      parsed.command.run(...parsed.arguments, parsed.options);
+    }
+  }
+}
 
 function breadc(name, option = {}) {
-  return new Breadc(name, { version: option.version ?? "unknown" });
+  return new Breadc(name, option);
 }
 
 export { breadc as default };

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "breadc",
-  "version": "0.0.0",
-  "description": "",
+  "version": "0.1.0",
+  "description": "Yet another Command Line Application Framework",
   "keywords": [
-    "cli"
+    "cli",
+    "framework",
+    "command-line",
+    "minimist"
   ],
   "homepage": "https://github.com/yjl9903/Breadc#readme",
   "bugs": {
@@ -30,13 +33,17 @@
     "dist"
   ],
   "dependencies": {
+    "debug": "^4.3.4",
+    "kolorist": "^1.5.1",
     "minimist": "^1.2.6"
   },
   "devDependencies": {
+    "@types/debug": "^4.1.7",
     "@types/minimist": "^1.2.2",
     "@types/node": "^17.0.43",
     "bumpp": "^8.2.1",
     "prettier": "^2.7.1",
+    "tsx": "^3.4.3",
     "typescript": "^4.7.4",
     "unbuild": "^0.7.4",
     "vite": "^2.9.12",