本周在我的开源课程中,我和我的同学的任务是将我们自己的每个程序发布到包注册表。
当你听到有人说代码注册表、包注册表或注册表时,我喜欢将这些词视为代表开发人员和公司发布代码供其他人下载的地方。想要更准确的描述,可以阅读Mozilla的这篇文章:
我们的包管理器之旅到此结束。我们的下一步行动是建立一个示例工具链,将我们迄今为止学到的所有知识付诸实践。
gimme_readme 是一个由 AI 提供支持的命令行工具,可为您的项目生成全面的 README.md 文件。它一次分析多个源代码文件,提供每个文件的用途、功能和关键组件的简明解释。最新版本:1.0.0,最后发布:16 小时前。通过运行“npm i gimme_readme”开始在项目中使用 gimme_readme。 npm 注册表中没有其他项目使用 gimme_readme。
正如您在上面所看到的,有很多文件夹和文件对于用户(而不是开发人员)来说是不必要的。例如,您认为我的用户会希望我的“tests”文件夹来测试我的程序代码吗? 可能不是。您认为我的用户需要格式化和检查我的源代码所需的配置文件吗? 可能不是。您认为我的用户是否出于任何特定原因需要使用我的“.github”文件夹? 可能不是。
为此,我一直在努力寻找一种解决方案来最大程度地减少用户下载的内容;具体来说,我希望他们只拥有我的程序运行所需的源代码。
当我考虑重新发布我的代码时,我也在和我的朋友 Uday Rana 讨论使用 .npmignore 文件来“忽略”我不想发布的文件的想法。
就在我提到这个主题之后,Uday 在 Google 上搜索了 .npmignore,并找到了 Jeff D 撰写的一篇关于为什么人们应该永远不使用 .npmignore 文件的文章。需要明确的是,我完全同意杰夫的文章。
本质上,这个想法是我们应该明确我们想要发布的内容(白名单),而不是说明我们不 想要发布(列入黑名单)。
使用 npm 将我们想要发布的文件列入白名单非常简单。我们需要做的就是通过添加“files”选项来编辑 package.json 文件,该选项指示我们要为程序发布哪些文件。下面,我截取了 package.json 的“files”选项的屏幕截图,该选项指出“发布此程序时包含 src/ 目录”。我已经提交了这些更改,并且这些更改可在我的代码 v1.0.0 版本中使用。
注意:默认情况下,某些文件始终发布到 npm,无论您在“文件”选项中指定或未指定什么。如果你想了解更多如何使用“files”选项,请查看 npm 的官方文档如何使用 file 选项。
使用更新后的 package.json 将我的代码发布到 npm 后,安装/重新安装 gimme_readme 的用户现在计算机上的膨胀会少很多!请参阅以下差异:
除了增强用户体验(通过减少通过 npm 安装 gimme_readme 带来的臃肿)之外,我还添加了一个持续开发管道(简称 cd 管道),当我创建新的项目时,它可以将我的发布过程自动化到 npm在 GitHub 上发布。有关如何执行此操作的具体详细信息,您可以参阅 GitHub 的发布 Node.js 包指南。现在感觉很好,因为只需点击几个按钮,我就可以发布我知道稳定的代码(根据我的 CI 管道),来自 GitHub。
您可以在这里找到我的 cd 管道的代码。
正如我之前提到的,我正在与我的朋友 Uday Rana 一起进行测试。在撰写本文时,他能够安装我的工具,并像这样使用它:
事情对我来说看起来不错,而且我的工具的大多数选项或多或少都符合他的预期。但我必须再次重复这个过程,因为我想添加一些进一步的优化!
我最近还听说了进一步优化我的代码的方法。特别是,我致力于学习如何通过了解复合操作以及与 GitHub 操作相关的可重用工作流程来改进我的 CI 和 CD 管道。我希望这些技术能够帮助我减少编写的代码量,并提供某种类型的性能提升!我对这些主题还不太了解,但你可以打赌我可能很快就会在博客上介绍它。
我的朋友们,结束了我想在这个博客中谈论的内容。
下次见!
以上是使用 GitHub Actions 将 gimme_readme 重新发布到 npm的详细内容。更多信息请关注PHP中文网其他相关文章!