steamer-plugin-example

开发插件

npm i -g steamerjs

steamer develop --plugin [plugin name xxx]
// 或
steamer develop -p [plugin name xxx]
// 命令运行后,会下载 [steamer-plugin-example](https://github.com/steamerjs/steamer-plugin-example)

cd steamer-plugin-xxx

// 将你的插件链接至全局路径,就可以直接使用 `steamer example`
npm link

// 当你完成开发,可以 `unlink` 你的插件
npm unlink

steamer plugin 例子

  • 确认是否已安装steamer CLI工具,如果还未安装,请参考https://github.com/steamerjs/steamerjs

完成这个example plugin之后,可以这样使用这个插件:

steamer example -c config.js
// 或
steamer example --config config.js

如何写一个 steamerjs 插件

  • 创建一个类,继承 steamer-plugin。此插件有许多辅助方法,请此往插件文件进行查询。
class ExamplePlugin extends SteamerPlugin {
    constructor(args) {
        super(args);
        this.argv = args;
        this.pluginName = 'steamer-plugin-example';
        this.description = 'steamer plugin example';
    }

    init() {
        
    }

    help() {
        
    }
}

当在终端输入插件命令时,命令的参数将被传入这个函数

更多相关参数的文档,请参考 yargs.

  • init 函数

为类创建 init 方法, 插件命令在启动时会自动调用此函数。

init() {
        
}
// 导出此类
module.exports = ExamplePlugin;
  • help 函数

为插件创建 help 方法

help() {
        
}

当使用命令 steamer [plugin name] -h 或者 steamer [plugin name] --help 时,会自动调用 help 函数,用于输出插件帮助文档。

  • 在package.json中指定入口
"main": "index.js"