gomodup

gomodup ✨: Ваш помощник по обновлению Go-модулей

gomodup — это CLI инструмент на Go, который помогает поддерживать ваши зависимости Go в актуальном состоянии. Он сканирует ваш файл go.mod, находит устаревшие пакеты, а затем интеллектуально определяет самые свежие совместимые версии с вашей текущей версией Go, чтобы избежать проблем с совместимостью.

🚀 Описание

В мире Go, где зависимости развиваются быстро, иногда бывает сложно понять, на какую версию можно безопасно обновиться, не сломав сборку или не потребовав обновления вашей версии Go. gomodup решает эту проблему, делая следующее:

1. Читает go.mod: Идентифицирует все прямые зависимости.
2. Проверяет актуальность: Обращается к прокси Go-модулей (proxy.golang.org) для получения всех доступных версий каждого модуля.
3. Проверяет совместимость с Go: Для каждой новой версии модуля скачивает её go.mod и проверяет, какая версия Go требуется для этого модуля.
4. Фильтрация по версии Go: Если новая версия модуля требует Go выше вашей текущей (например, у вас Go 1.23, а модуль требует 1.24), gomodup остановится и предложит самую последнюю версию, совместимую с вашей версией Go.
5. Игнорирование приватных модулей: Уважает переменную окружения GOPRIVATE, пропуская модули, к которым нет публичного доступа.
6. Параллельная обработка с Rate Limiting: Использует горутины для быстрой проверки множества модулей, но с настраиваемыми задержками для предотвращения перегрузки реестра пакетов.
7. Удобный вывод: Представляет список найденных совместимых версий в виде таблицы и генерирует команды go get для простого обновления.

Больше никаких ручных проверок и головной боли! Просто запустите gomodup и получите список готовых команд. (づ｡◕‿‿◕｡)づ

🛠️ Установка

Для установки gomodup, убедитесь, что у вас установлен Go 1.25+ и выполните команду:

go install github.com/AdamBrianBright/gomodup@latest

После этого исполняемый файл gomodup будет доступен в вашем $GOPATH/bin.

📖 Использование

Перейдите в корневую директорию вашего проекта Go, где находится go.mod, и запустите:

Базовое использование

gomodup

С подробным выводом (режим отладки)

gomodup -v

Указание другой директории

Если ваш файл go.mod находится не в текущей директории:

gomodup -dir /path/to/your/go/project

⚙️ Конфигурация

gomodup поддерживает конфигурацию через переменные окружения, что позволяет точно настроить его поведение:

Пример использования переменных окружения:

REQUEST_TIMEOUT=60s MAX_CONCURRENCY=10 RATE_LIMIT=50ms GOPRIVATE="git.mycompany.com/*,github.com/myuser/private-repo" gomodup -v

📊 Пример вывода

Найденные совместимые версии:

| Модуль                     | Совместимые версии                    |
|----------------------------|----------------------------------------|
| github.com/gin-gonic/gin   | v1.9.2, v1.9.3, v1.10.0              |
| github.com/stretchr/testify| v1.8.5, v1.9.0                       |

Предлагаемые обновления:
go get github.com/gin-gonic/[email protected]
go get github.com/stretchr/[email protected]

Если обновлений не найдено:

Совместимые обновления не найдены.

📦 Структура Проекта

Проект организован по пакетам для лучшей читаемости и поддерживаемости:

gomodup/
├── main.go               # Точка входа в приложение
├── config/               # Загрузка и управление конфигурацией
├── version/              # Парсинг и сравнение семантических версий
├── module/               # Логика обработки Go-модулей и зависимостей
├── fetcher/              # HTTP-клиент с Rate Limiting для получения данных
├── parser/               # Парсинг файла go.mod
└── table/                # Форматирование и вывод таблиц

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробнее смотрите файл LICENSE.

Сделано с ❤️ на Go.