psampaz/go-mod-outdated

go-mod-outdated 镜像说明

镜像概述

go-mod-outdated是针对Go项目的依赖管理工具，它将go list -u -m -json all命令的JSON输出转换为直观的表格视图，方便开发者快速查看依赖的当前版本、可用更新版本，并支持多种过滤条件，提升依赖管理效率。

核心功能

1. JSON转表格：将Go模块依赖的JSON输出转换为包含模块名、版本、新版本、是否直接依赖、时间戳有效性的结构化表格。
2. 灵活过滤：支持-direct（仅显示直接依赖）、-update（仅显示有更新的依赖）等参数组合筛选结果。
3. CI集成：通过-ci参数，在发现过时依赖时返回非零退出码，可用于中断CI流水线，确保代码质量。
4. 时间戳验证：新增"VALID TIMESTAMPS"列，检测更新版本是否比当前版本新，避免误升级到旧版本。

使用场景

1. 日常开发：快速检查项目依赖的更新状态，优先处理直接依赖的过时问题。
2. CI流水线：集成到持续集成流程中，强制检查依赖更新，防止引入过时组件。
3. 依赖审计：全面分析所有依赖的版本情况，评估升级风险和必要性。

配置说明

工具支持以下命令行参数：

• -direct：仅列出直接依赖。
• -update：仅列出有可用更新的依赖。
• -ci：发现过时依赖时退出码非零（用于CI）。
• -help：查看参数说明。

Docker部署示例

在包含go.mod的项目目录下执行以下命令：

查看所有依赖

bash
go list -u -m -json all | docker run -i psampaz/go-mod-outdated

仅显示有更新的依赖

bash
go list -u -m -json all | docker run -i psampaz/go-mod-outdated -update

仅显示直接依赖且有更新的

bash
go list -u -m -json all | docker run -i psampaz/go-mod-outdated -direct -update

CI模式（发现过时依赖则失败）

bash
go list -u -m -json all | docker run -i psampaz/go-mod-outdated -ci