Serverless Devs Cli 输出规范

[anycodes]

前言

Serverless Devs作为Serverless领域的开发者工具，其输出的标准化和规范化会在一定程度上对用户体验有比较明显的影响。

本Repo将会通过一些文字和案例，对Serverless Devs的命令行工具输出，进行规范化升级。也欢迎大家参与讨论。

规范详情

输出格式的规范目标是：

• 更清晰
• 更简约
• 不影响功能实用

基于以上三个原则，我们可以通过正常输出的形式、异常输出的形式等分别进行举例说明

基本输出

基本输出的形式，整体上包括两个部分：

1. 项目执行阶段

项目执行阶段主要包括一个基本格式:

⌛ Steps for process
====================

采用重写机制，不断的更新输出内容，每个项目执行完成可以输出相对应的结果，示例：

⌛ Steps for process
====================
✔ Pre-action completed (10s)

2. 结果输出阶段

项目执行阶段主要包括一个基本格式:

🚀 Result for process
====================

具体的项目输出采用Yaml的格式进行输出，输出时，项目名称要加下划线，如果没有输出则直接结束项目，示例：

🚀 Result for process
====================
✔ MyProject deployed (11s)
fc-deploy-test:
  region: cn-hangzhou
  service:
    name: fc-deploy-service
    memorySize: 128

单项目输出示例

多项目输出示例

调试模式

当用户使用--debug进入到调试模式，则会打印非常详细的信息在控制台，但是这些信息将会以灰色形式打印出来，以保持整体的层次感：

错误输出

当执行出现错误时，Serverless Devs要做到感知并输出相对应的内容：

⌛ Steps for process
====================
✔ MyProject pre-action completed (10s)
✖ MyProject failed to deploy:

Error Message: 
t[r] is not a function

Env:   darwin, node v15.14.0
Docs:  https://github.com/serverless-devs/docs
Bugs:  https://github.com/Serverless-Devs/Serverless-Devs/issues
Logs:  ~/demo/demo/demo/s.log

动态效果为：

[hanxie-crypto]

精简正常输出， 异常输出带上了 执行环境，和相关的解决问题的 issue这个设计比较有利于定位问题解决问题

[anycodes]

Serverless Framework是非常领先的开源框架，这一部分可以向前辈们学习：https://github.com/serverless/cli-design

[rsonghuster]

对于异常输出那个示例，是不是能自动汇报错报或者生成issue更好，当然需要用户的授权

[anycodes]

这个还是比较困难的。需要有用户在Devs怼Github授权。