ys-cli

YS 架构之命令行工具，用来快速创建项目、插件以及快速生成各模块代码的一个工具。它还支持插件的命令行功能，插件能够为琪扩展快速开发功能或者其他功能。

Install

npm i ys-cli -g

我们不必担心升级的问题，因为工具会自行检测升级，一旦检测到有版本更新，工具会强制自动为您升级。

Create a new project

ys new <project_name>

工具会提示您选择的框架和使用的路由，您只要按照提示选择即可。

Create worker module files

我们可以通过命令自动创建各自文件夹下的文件。

如果我们在 app/controller 文件夹下

ys add <new_file> # new_file: 不需要制定文件类型 比如你 `index.js`，那么你直接写 `index`

在具体模块文件夹下您不需要写入-c -m -s等文件类型，系统已经自动判断。

这样我们就可以在这里创建一个controller，当然你可以通过明确指定创建类型来创建这个文件。同样的，你可以在项目根目录创建其他模块的文件。

ys add <new_file> -c # 创建controller文件
ys add <new_file> -m # 创建middleware文件
ys add <new_file> -s # 创建service文件

如果您在app/controller文件夹下，使用ys add xxx -s那么，工具将为您创建在 app/service下。

注意：该命令只能在项目或者插件文件夹下使用

Install or uninstall plugin

ys install <plugin>
ys i <plugin>
ys uninstall <plugin>
ys d <plugin>
ys d

当我们需要卸载一个插件，而没有指定插件名的时候，系统将自动为您列出已经安装的插件，您只需要选择卸载即可。

注意：该命令只能在项目文件夹下使用

Create dev Plugin

ys create <plugin_name>

一旦创建，你就是可以在应用中使用path来指定到本插件目录进行调试。

Create plugin commander

我们可以通过插件定义的命令来调用功能。插件需要做的是：

{root}/.ys.command.js

/**
 * 我们通过导出一个class对象用来描述这个插件运行过程
 * @param thread `object` 单步线程对象
 * @param installer `object` cli工具提供的运行时对象
 */
module.exports = class CommanderModule {
  constructor(thread, installer) {
    this.installer = installer;
    this.thread = thread;
  }

  /**
   * 当我们处于项目文件夹下，我们额外提供给工具的命令支持
   * @param app `object` 模块`cmdu`的全局app对象 see: http://npmjs.com/cmdu
   * @param installer `object` cli工具提供的运行时对象
   */
  static ['command:framework'](app, installer) {
    app.command('test')
      .action(installer.task('../command'));
  }

  /**
   * 嵌入在{project root}/config/plugin.js中的代码
   * 它可以是一个json对象，也可以是一个字符床
   */
  ['options:plugin']() {
    return {
      enable: true,
      package: 'xxxx',
      agent: ['agent'],
      dependencies: []
    };
  }

  /**
   * 自定义安装逻辑
   * @param cwd `string` 项目或者插件根目录地址
   * @param name `string` 插件名称
   * @param cname `string` 插件别名
   */
  async ['life:created']({ cwd }) {}

  /**
   * 自定义卸载逻辑
   * @param cwd `string` 项目或者插件根目录地址
   * @param name `string` 插件名称
   */
  async ['life:destroyed']({ cwd }) {}
}

一旦安装了这个插件，那么我们就可以根据他提供的命令运行

ys test

License

It is MIT licensed.