手把手教你发布一个deno模块

Node.js的包管理工具是npm，而对于deno而言，任何一个资源服务器都可以是资源的提供方，一般来说，它是一个CDN网站。
除了比较知名的用来转换node包的https://cdn.skypack.dev/和https://esm.sh/之外，官方的CDN地址是这里：https://deno.land/x。

如何发布模块

如何发布一个deno的模块？
操作其实很简单。

前提是你有一个github账号，新建一个对外开放的工程。
发布前，在你的工程里，最好先配置好标签与描述。标签用来在deno.land中搜索，描述便于其他开发者了解你的用图。

回到https://deno.land/x页面。点击Publish a module，出现以下弹窗：

点击下一步
填写一个唯一的模块名称，比如xx_test。如果没有重复的，就可以点击下一步。
填写要发布的工程中文件夹路径，一般情况下我们都是根目录，不填即可。

下一步是提示页面
按上一步的提示一步步就可以完成了。这里我再详细点，到我们的github工程，找到设置-Webhooks，点击增加webhook按钮。
填写Payload URL为提示页面的地址；修改Content-type为application/json。
选择Which events would you like to trigger this webhook?的最后一项。只勾选第一个。
点击Add webhook按钮
页面会自动回到这里，看到有了一条记录。
点击编辑，会有2个tab页，第一个就是你刚才配置的页面，第二个是你以后所有hooks的状态。如果失败了，可以在这里看详细信息。
你的工程使用git打标签，如git tag -a v0.0.1 -m "feat: xxx"，推送到github，就会触发hooks。
回到https://deno.land/x，在下面就能看到你新推送的模块了。
点击你的带版本号的工程，可以看到弹出的地址是https://deno.land/x/xx_test@v...。每有一个新tag的推送，就会有一个新的版本。

需要注意的一点是，deno对个人发布模块的数量限制为15个，超过需要向管理员发邮件（[email protected]）申请，所以没事儿不要发垃圾的包上去，撤销也是需要向管理员申请的，而且也不一定会通过。

快速发布

一般情况下，我们需要在根目录下创建一个README.md，说明你的模块功能与使用方法。
以我的工程oak_nest为例，通常有段使用示例：

import {
  Body,
  Context,
  UseGuards,
} from "https://deno.land/x/[email protected]/mod.ts";

示例里有你的模块地址，这个地址的版本号如果每次发布都要手动修改，那就太麻烦了。

全局安装一个命令：

deno install --allow-read --allow-write --allow-run --unstable -n deno_tag -f https://deno.land/x/[email protected]/cli/tag/mod.ts

在根目录下创建一个scripts.yml文件，内容大致如下：

version: 0.0.1
name: xx_test

之后就可以使用deno_tag来更新版本，并推送到服务器。详细说明具体见这里。

版本更新

版本号更新的命令使用patch/minor/major，与npm的一样。

deno_tag
deno_tag patch # 与上面等价
deno_tag minor
deno_tag major

会更新根目录下的scripts.yml文件和README.md，如果后者有使用scripts.yml中配置的name，将会对应替换。
比如工程的名称为[email protected]，那么执行deno_tag后，README.md中[email protected]会对应替换为[email protected]。
如果执行deno_tag minor后，README.md中[email protected]会对应替换为[email protected]。
如果执行deno_tag major后，README.md中[email protected]会对应替换为[email protected]。

版本号不以v开头

假设你推送的tag版本号不想以v开头，那么可以添加一个参数-L或者--local：

deno_tag patch -L

添加自定义信息

打标签时默认提交信息是版本号，如果想自定义信息，可以使用-M或者--msg：

deno_tag minor -M "feat: change some"

更新所有目录的README.md文件

如果想要更新所有目录的README.md文件，可以使用-D或者--deep：

deno_tag -D

本地调试

如果你的另一个项目中使用这个模块，那可能会遇到调试问题，如果每次发布都推送一次，那太不合理了（虽然你可以这么干，github的hooks也是秒级的）。
你可以在本地启动一个服务器。

全局安装file_server

deno install --allow-net --allow-read https://deno.land/[email protected]/http/file_server.ts

在你的模块目录下，执行命令：

$ file_server .
Downloading https://deno.land/[email protected]/http/file_server.ts...
[...]
HTTP server listening on http://0.0.0.0:4507/

这样打开http://0.0.0.0:4507/就可以看到当前目录的文件了。
你在另一个工程里使用这个地址就可以进行调试了。需要注意的一点是，你原来是这样运行代码的：
```
deno run -A aa.ts 
```
现在需要换成：
```
deno run -A --reload=http://localhost:4507/ aa.ts 
```
不然永远用的是旧的代码。

总结

本文介绍了如何利用github的hooks来发布一个deno模块到deno.land上，如何快速更新版本，如何本地调试。