Разработка и Git

Состояние submodules

Показывает инициализированные, изменённые и конфликтующие submodules без изменения файлов.

Shell Linux macOS Новичок
Скачать git-submodule-status.sh
Описание

Что делает скрипт

Скрипт разбирает вывод git submodule status --recursive и объясняет префиксы: минус означает неинициализированный модуль, плюс - другой коммит, U - конфликт. Отчёт помогает быстро понять, почему сборка видит не ту версию зависимости.

Запуск

Быстрый старт

bash git-submodule-status.sh --repo .

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

Другие варианты

  • bash git-submodule-status.sh --repo .
  • bash git-submodule-status.sh --repo ~/src/app
Зависимости

Что понадобится

Git 2.40+ Система контроля версий
Linux sudo apt install git
macOS brew install git
Bash 4+ Стандартные find, sed, sort и awk
Linux sudo apt install bash
macOS brew install bash
Исходник

git-submodule-status.sh

#!/usr/bin/env bash
set -euo pipefail

usage() {
    cat <<'EOF'
Использование: git-submodule-status.sh [--repo ПАПКА]
EOF
}

repo="."
while [[ $# -gt 0 ]]; do
    case "$1" in
        --repo) repo="${2:-}"; shift 2 ;;
        -h|--help) usage; exit 0 ;;
        *) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
    esac
done

[[ -d "$repo" ]] || { echo "Папка не найдена: $repo" >&2; exit 2; }
command -v git >/dev/null 2>&1 || { echo "Не найден git." >&2; exit 1; }
git -C "$repo" rev-parse --is-inside-work-tree >/dev/null 2>&1 || {
    echo "Это не git-репозиторий: $repo" >&2
    exit 2
}

root="$(git -C "$repo" rev-parse --show-toplevel)"
if [[ ! -f "$root/.gitmodules" ]]; then
    echo "В репозитории нет .gitmodules: submodules не настроены."
    exit 0
fi

ok=0
missing=0
changed=0
conflict=0

echo "Репозиторий: $root"
echo

while IFS= read -r line; do
    [[ -z "$line" ]] && continue
    state="${line:0:1}"
    rest="${line:1}"
    sha="${rest%% *}"
    path="${rest#* }"
    case "$state" in
        " ")
            echo "OK       $path ($sha)"
            ok=$((ok + 1))
            ;;
        "-")
            echo "НЕ ИНИЦИАЛИЗИРОВАН  $path"
            missing=$((missing + 1))
            ;;
        "+")
            echo "ДРУГОЙ КОММИТ       $path ($sha)"
            changed=$((changed + 1))
            ;;
        "U")
            echo "КОНФЛИКТ            $path"
            conflict=$((conflict + 1))
            ;;
        *)
            echo "НЕИЗВЕСТНО          $path"
            ;;
    esac
done < <(git -C "$repo" submodule status --recursive)

echo
echo "Итого: ok=$ok, не инициализировано=$missing, изменено=$changed, конфликтов=$conflict"

if [[ "$missing" -gt 0 ]]; then
    echo "Подсказка: git submodule update --init --recursive"
fi

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get dev-git-submodule-status
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Разработка и Git

Git, сборка, тесты, зависимости, логи и обслуживание проектов.