cytopia/goimports

goimports Docker镜像

基于Alpine的轻量级多阶段构建Docker化版本的goimports^[1]，通过shell包装器添加了额外的--ci参数^[2]，确保当文件存在差异时退出码>0。镜像每晚基于多个稳定版本构建并推送到Dockerhub。

• ^{[1] 官方项目: [***]}
• ^{[2] 参见用法获取帮助}

支持的架构

amd64, i386, arm64, arm/v7

可用的Docker镜像版本

滚动发布

以下Docker镜像标签为滚动发布版本，每晚构建和更新。

https://github.com/cytopia/docker-goimports/workflows/nightly/badge.svg](https://github.com/cytopia/docker-goimports/actions?query=workflow%3Anightly)

时间点发布

以下Docker镜像标签为一次性构建，可用于可重复构建。其版本永不改变，因此需要定期更新管道中的标签以保持最新。

https://github.com/cytopia/docker-goimports/workflows/build/badge.svg](https://github.com/cytopia/docker-goimports/actions?query=workflow%3Abuild)

其中<tag>指本仓库中选择的git标签。

Docker挂载

Docker容器内的工作目录为**/data/**，应本地挂载到项目根目录。

用法

通用帮助

bash
$ docker run --rm cytopia/goimports --help

用法: cytopia/goimports [标志] [路径...]
       cytopia/goimports [--ci] [-local] [-srcdir] [路径...]
       cytopia/goimports --help

Docker化版本的goimports，添加了文件变更时失败（退出码1）的功能。

额外的包装器功能:
----------------------------
 --ci   此选项将 diff 输出到标准输出（类似'-d'），如果存在 diff，将以退出码1失败。
        只能与'-e'、'-local'和'-srcdir'组合使用。
        用于持续集成中的显式失败场景。

默认goimports标志:
----------------------------
 -cpuprofile string
        CPU配置文件输出
 -d     显示差异而非重写文件
 -e     报告所有错误（不仅仅是不同行上的前10个）
 -format-only
        如果为true，不修复导入，仅格式化。在此模式下，goimports实际上等同于goimports，
        但会将导入分组为多个部分。
 -l     列出格式与goimports不同的文件
 -local string
        将以此字符串开头的导入放在第三方包之后；逗号分隔的列表
 -memprofile string
        内存配置文件输出
 -memrate int
        如果>0，设置runtime.MemProfileRate
 -srcdir dir
        选择导入，如同源代码来自dir。操作单个文件时，dir也可以是完整文件名。
 -trace string
        跟踪配置文件输出
 -v     详细日志
 -w     将结果写入（源）文件而非标准输出

默认goimports用法

bash
# 输出diff到标准输出并退出码0
$ docker run --rm -v $(pwd):/data cytopia/goimports -d .

CI包装器用法

bash
# 输出diff到标准输出，如有diff则退出码>0
$ docker run --rm -v $(pwd):/data cytopia/goimports --ci .

相关 https://github.com/topics/awesome-ci 项目

Docker镜像

避免安装大量依赖，选择以下Docker化版本的linter用于可重复的本地或远程CI测试：

^[1] 使用shell包装器添加了原始项目不具备的增强功能。

Makefile

访问 https://github.com/cytopia/makefiles 获取无依赖、无缝的项目集成