返回资讯中心
外部精选
软件工程
#开发者实时流

Groovyfmt:用 Rust 编写的 Groovy/Gradle/Jenkinsfile 快速格式化工具

来源标题:Show HN: Groovyfmt, a fast formatter for Groovy, Gradle and Jenkinsfiles

开发者 costajohnt 发布 Groovyfmt,一个用 Rust 基于 tree-sitter 语法编写的 Groovy、Gradle 构建脚本和 Jenkinsfile 格式化和 lint 工具,编译为单一静态二进制、无需 JVM。在 jenkins-infra/pipeline-library 上运行测试时,该工具报告 27 个文件全部需重新格式化,并发现 10 处 lint 违规(含 9 处未使用 import)。支持 brew、npm、cargo 安装,提供 Linux、macOS、Windows 预编译二进制,Gradle 插件和 Docker 镜像尚未发布。

Hacker News 最新costajohnt2026/11/17 · 今天8 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一个用于 Groovy、Gradle 构建脚本和 Jenkinsfile 的快速格式化和 lint 工具。单个静态二进制文件,无需 JVM。用 Rust 编写,基于 tree-sitter 语法。

$ groovyfmt --check Jenkinsfile test/groovy/BaseTest.groovy ... would reformat 27 of 27 files $ groovyfmt reformatted 27 of 27 files $ groovyfmt --lint test/groovy/BaseTest.groovy:2:1: UnusedImport: The [mock.CurrentBuild] import is never referenced (fixable) ... 10 violations in 27 files (UnnecessaryGroovyImport 1, UnusedImport 9)

在 jenkins-infra/pipeline-library 上运行。

brew install costajohnt/tap/groovyfmt # macOS, Linux npm install --save-dev groovyfmt # 或:npx groovyfmt --check cargo install --locked groovyfmt # Rust 1.90+ 和一个 C 编译器

Linux(静态 musl)、macOS 和 Windows 的预编译二进制文件均随每个 release 提供,每个都附带 .sha256。另见 Windows。尚未发布:Gradle Plugin Portal 上的 Gradle 插件(从检出即可使用)和 Docker 镜像。

命令 | 作用 groovyfmt | 就地格式化当前目录下的文件 groovyfmt --check | 列出会改动的文件,若有则退出码 1(--diff 显示具体改动) groovyfmt --lint | 报告 lint 违规,若有则退出码 1 groovyfmt --lint --fix | 修复可自动修复的问题(import、分号),报告其余问题 groovyfmt --syntax | 报告解析错误 groovyfmt --explain <Rule> | 解释某条 lint 规则 groovyfmt --suggest-style | 根据现有代码建议缩进设置

退出状态:0 表示干净,1 表示有待修复项,2 表示出错。会自动识别 .groovy、.gradle、Jenkinsfile 和带 groovy #! 的脚本。命令行包含所有选项。

.groovyfmt.toml,从每个文件向上查找:

indent = 4 continuation_indent = 8 # 默认:与 indent 相同 use_tabs = false normalize_spacing = false # 同时修正 token 之间的空格 max_line_length = 120 # 在安全的地方折行(默认:关闭) exclude = ["generated/**"] [lint] # 开启或关闭规则

// groovyfmt: off / // groovyfmt: on 可保护一个区域。更多内容见 Formatting 和 Configuration。

82 条规则,默认开启 58 条(groovyfmt --rules)。通用规则沿用 CodeNarc 的命名;Jenkinsfile、Gradle 和 Spock 规则能捕获那些通常只有构建运行时才会暴露的错误。从 CodeNarc 或 npm-groovy-lint 迁移过来?groovyfmt --import-codenarc <config> 可以转换你的配置。可用 // groovyfmt-ignore 或 @SuppressWarnings 抑制;用 --write-baseline 逐步采纳。

Lint 包含所有规则。输出格式支持 JSON、SARIF 和 GitHub 注解。

  • uses: actions/checkout@v5
  • uses: costajohnt/groovyfmt@v0.22.0 # 运行 groovyfmt --check --output-format github
  • run: groovyfmt --lint --output-format github

pre-commit: repos:

CI 覆盖了 action 输入、SARIF 上传、--strict 和 Gradle 插件。

groovyfmt --lsp 是一个 language server:提供格式化、解析错误和输入时的 lint,以及作为 code action 的修复。有 VS Code 和 JetBrains IDE 的扩展;Neovim、Helix 和 Zed 的配置见 Editors。

正在编辑 Jenkinsfile 的编程 agent 没有编译器来捕获损坏的文件。groovyfmt --syntax <file> 可在毫秒级给出答案。Coding agents 一节有 AGENTS.md 片段和 Claude Code hook。

测试、语料库工作流、语法变更和发布见 Development。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →