maak 是一个命令运行器,它的任务列表就是一个 Lisp 文件。你编写 maak.scm,一个完全普通的 Lisp(Guile Scheme)模块,其中每个过程都成为你可以在命令行上指定的任务。没有 DSL 要学,也没有第二语言要记在脑子里:构建就是程序。
仓库:https://github.com/jjba23/maak
(define-module (maak)
#:declarative? #t
#:use-module (maak maak))
(define (deploy host)
"Ship release.tar.gz to HOST."
(build)
(run (list "rsync" "-avz" "release.tar.gz"
(string-append host ":srv/www/"))))
$ maak deploy -- example.org
文档字符串就是 maak --list 打印的条目。lambda 列表就是参数语法。任务之间通过函数调用相互调用,而不是通过重新解析文件的子进程。没有第二语言,任务列表与运行它的代码之间也没有任何需要保持同步的东西。
run把程序和它的参数作为独立的字符串接收,所以带空格的路径仍然是一个参数。
run-pipeline用 pipe/dup2 连接各个阶段,报告每一个失败的阶段而不仅仅是最后一个,可以 tee 某个阶段写入的内容,还能把整条流水线作为后台作业运行,并提供一个可轮询的 pid。
maak -j 4 -- fmt,lint,test为每个任务 fork 一个 worker,并按照你指定的顺序把每个任务的输出打印成一个块。
- Dry run 和 quiet 是 Scheme 参数,所以测试可以对它们进行 parameterize,而不必把
--dry-run穿过五层传递下去。
- 任务可以声明
#:depends、#:hidden?和#:example,而-j会依据这些依赖来排序,而不只是扇出。
你也可以使用纯静态的 Maak 文件,maak.yaml、maak.toml 和 maak.json 都能配合同样的 --list、--plan 和 --watch 以及运行功能使用。
version: 1
tasks:
lint:
doc: Lint and format-check, failing on warnings.
commands:
- [cargo, clippy, --, -D, warnings]
- [cargo, fmt, --check]
maak --plan deploy -- example.org 不运行任何东西,而是打印带类型的计划:每个 argv、工作目录、环境、提权,以及它是否会在后台运行。加上 --json,同一个计划就是一个带版本的对象,CI 作业可以归档或做 diff。
maak explain deploy 打印调用图(deploy 调用了什么、什么调用了 deploy)、加载路径、提权情况,以及每个变量最终由哪个 .env 文件胜出。它回答“为什么这东西以 root 运行”,而不需要你去读文件。
还有 maak --watch TASK,它会在文件变化时重新运行并重新加载文件,以及 maak --list --json,这是带版本的任务描述,Emacs、Neovim、Vim、VS Code、Helix、IntelliJ、Zed 和 Sublime 的集成全都读取它。
为常见开发和 devex 提供了许多功能支持,cargo 和 rustup、uv 和 pyproject、npm/pnpm/yarn、Maven 和 Gradle、Guix 和 Nix(一个固定的 Guix 会解析为任务可以据以决策的值,而不是另一个工具重新读取的字符串)、Podman/Docker 和 Compose、git、tar 和 zip、curl 和 wget、GNU gettext、Emacs Lisp 打包、sift,以及 Veritas。
我很想听听你的想法、批评和点子!肯定还会有更多改进,目前正在积极研究改进一些 shell 补全以及更多东西 😄
Happy hacking :)