在前端开发中，我们常常需要使用一些 npm 包来帮忙完成一些工作，比如搭建开发环境、进行模块化管理等等。今天介绍的 npm 包 fury.cli 可以帮助我们更便捷地管理 API 文档，提高开发效率。
什么是 fury.cli
fury.cli 是一个命令行工具，可以通过命令行对 API 文档进行操作和管理。它可以将 API 文档转换成多种格式，如 OpenAPI、RAML、Swagger、API Blueprint 等。同时，它还能够将这些格式的 API 文档进行合并、分割、校验等操作。
fury.cli 使用 TypeScript 编写，适应于多种环境，包括命令行、Node.js、浏览器等。它的功能强大、易于使用，是一个非常优秀的 API 文档工具。
fury.cli 的安装
安装 fury.cli 非常简单，只需要在命令行中输入以下命令即可：
npm install -g fury
这个命令会全局安装 fury.cli，也就是说，你可以在任何目录下使用 fury 命令来操作 API 文档。如果你希望将 fury.cli 安装到本地项目中，可以使用以下命令：
npm install fury
fury.cli 的基本使用
fury.cli 支持许多命令，这里我们介绍一些常见的命令。
解析 API 文档
如果你已经有了一个 API 文档文件，并且知道它的类型，那么可以使用以下命令将其解析成对应的 JSON 格式：
fury parse -s swagger -i path/to/swagger.yaml -o path/to/swagger.json
这个命令将会将 path/to/swagger.yaml 文件解析成 Swagger 格式，并将解析结果输出到 path/to/swagger.json 文件中。
转换 API 文档格式
fury.cli 支持将多种格式的 API 文档转换成其他格式。例如，如果你有一个 Swagger 格式的 API 文档，并且希望将其转换成 OpenAPI 格式，可以使用以下命令：
fury transform -s swagger -i path/to/swagger.yaml -t openapi -o path/to/openapi.json
这个命令将会将 path/to/swagger.yaml 文件转换成 OpenAPI 格式，并将转换结果输出到 path/to/openapi.json 文件中。
合并多个 API 文档
如果你有多个 API 文档文件，并且希望将它们合并成一个文件，可以使用以下命令：
fury merge -i path/to/swagger1.yaml,path/to/swagger2.yaml,path/to/swagger3.yaml -o path/to/all-swagger.json
这个命令将会将 path/to/swagger1.yaml、path/to/swagger2.yaml 和 path/to/swagger3.yaml 三个文件合并成一个 Swagger 格式的文件，并将合并结果输出到 path/to/all-swagger.json 文件中。
分割 API 文档
如果你有一个很大的 API 文档文件，并且希望将其分割成多个文件，可以使用以下命令：
fury split -s swagger -i path/to/swagger.yaml -p path/to/output/directory -d 100
这个命令将会将 path/to/swagger.yaml 文件分割成若干个大小不超过 100 KB 的文件，并将分割结果输出到 path/to/output/directory 目录中。
总结
fury.cli 是一个非常优秀的 API 文档工具，它可以方便地管理 API 文档，提高开发效率。本文介绍了 fury.cli 的基本使用方法，希望对大家有所帮助。如果你想了解更多关于 fury.cli 的信息，可以查看它的官方文档：https://fury.io/cli/。
示例代码：
-- -------------------- ---- -------
-- --- -------- -------------------- --- ------- --
----- -- - --------------
----- ---- - ----------------
----- ---- - ----------------
------------------------------------------
----- -------- - -------------------- ------------------------
----- ------------- - -------------------------------------
----- --------- - --- -------
------------------------ -------------- ---------- ------------------------------ ----- -------
-------------- -------- -
-------------------------------------------------- ----- ----
-- -------- ------- -
-------------------
---来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055ffb81e8991b448ddcb5