用于开发 Node.js 和 Python 项目的工具

dotrun利用Docker 映像为运行 Node 和 Python 项目提供可预测的沙箱。

特征：

• 使用标准package.json脚本入口点：
  • dotrunyarn run start在 Docker 容器中运行
  • dotrun fooyarn run foo在 Docker 容器中运行
• 检测变化package.json并仅yarn install在需要时运行
• 检测变化requirements.txt并仅pip3 install在需要时运行
• .env使用来自和.env.local文件的环境变量运行脚本
• 将python依赖项保存.venv在项目文件夹中以便于访问

用法

$ dotrun          # Install dependencies and run the `start` script from package.json
$ dotrun clean    # Delete `node_modules`, `.venv`, `.dotrun.json`, and run `yarn run clean`
$ dotrun install  # Force install node and python dependencies
$ dotrun exec     # Start a shell inside the dotrun environment
$ dotrun exec {command}          # Run {command} inside the dotrun environment
$ dotrun {script-name}           # Install dependencies and run `yarn run {script-name}`
$ dotrun -s {script}             # Run {script} but skip installing dependencies
$ dotrun --env FOO=bar {script}  # Run {script} with FOO environment variable

安装

要安装 dotrun 运行：

sudo pip3 install dotrun

要求

• Linux / macOS
• 码头工人（获取码头工人）
• Python > 3.6 和 PIP

macOS 性能

为了在 Docker 上获得最佳性能，我们建议启用一个名为 virtiofs 的新实验性文件共享实现。Virtiofs 仅适用于以下 macOS 版本的用户：

• macOS 12.2 及更高版本（适用于 Apple Silicon）
• macOS 12.3 及更高版本（适用于英特尔）

如何启用 virtiofs

在新项目上添加 dotrun

要在新项目中完全支持 dotrun，您应该执行以下操作：

• 对于 Python 项目，确保Talisker等于0.16.0或大于requirements.txt
• 添加.dotrun.json和.venv到.gitignore
• 创建一个start脚本package.json来完成设置本地开发所需的一切。例如： "start": "concurrently --raw 'yarn run watch' 'yarn run serve'"
  • 上面的命令同时使用- 你可能要考虑这个
• 旧版本的 Gunicorn与严格限制不兼容，因此我们需要 Gunicorn >= 20
  • 更新登陆 Talisker，但在撰写本文时尚未进入新版本
  • 如果没有新版本的 Talisker，只需添加gunicorn==20.0.4到底部requirements.txt

但是，一旦您准备好完全切换到dotrun，只需继续删除run脚本即可。

拉取请求的自动化测试

“PR”操作构建 Python 包并使用 dotrun 运行项目。这将针对每个拉取请求运行。

发布

对主分支所做的所有更改都将自动发布为 PyPI 上的新版本。