Liste des submodules dans un dépôt Git

Vous pouvez utiliser le même mécanisme que git submodule init utilise lui-même, à savoir, regardez .gitmodules. Ce fichier répertorie chaque sous-module de chemin d'accès et l'URL il se réfère.

Par exemple, à partir de la racine du référentiel, cat .gitmodules permettra d'imprimer le contenu de l'écran (en supposant que vous avez cat).

Parce que .gitmodule fichiers ont le Git format de configuration, vous pouvez utiliser la commande git config pour analyser ces fichiers:

git config --file .gitmodules --name-only --get-regexp path

Serait de vous montrer tous les sous-module d'entrées, et avec

git config --file .gitmodules --get-regexp path | awk '{ print $2 }'

vous n'aurez que le sous-module chemin lui-même.

Renvoyer simplement le nom de la personne inscrite submodules, vous pouvez utiliser cette commande:

grep path .gitmodules | sed 's/.*= //'

Pense que git submodule --list qui n'existe pas.

Utilisation:

$ git submodule

Il fournira la liste de tous les submodules dans le dépôt Git.

J'ai remarqué que la commande fournie dans la réponse à cette question m'a donné les renseignements que je cherchais:

Pas de sous-module de cartographie trouvé dans .gitmodule pour un chemin qui n'est pas un sous-module

git ls-files --stage | grep 160000

Vous pouvez utiliser:

git submodule | awk '{ print $2 }'

À la liste de tous les submodules par nom:

git submodule --quiet foreach --recursive 'echo $name'

Juste la sous-module chemins s'il vous plaît, madame...

git config --list | grep \^submodule | cut -f 2 -d .

Vendor/BaseModel
Vendor/ObjectMatcher
Vendor/OrderedDictionary
Vendor/_ObjC
Vendor/XCodeHelpers

Dans ma version de Git ^[1], tous Git sous-module a un name et un path. Ils n'ont pas nécessairement être la même ^[2]. Avoir à la fois de manière fiable, sans vérifier les submodules première (git update --init), est un peu difficile de shell de sorcellerie.

Obtenir une liste de sous-module names

Je n'ai pas trouver un moyen de réaliser cela à l'aide de git config ou de tout autre git de commande. Par conséquent, nous sommes de retour à la regex sur .gitmodules (super moche). Mais il semble être un peu fort depuis git limites du possible code de l'espace autorisé pour les sous-module names. En outre, puisque vous voudrez probablement utiliser cette liste pour de plus amples shell de traitement, la solution ci-dessous des entrées séparées avec NULL-octets (\0).

$ sed -nre \
  's/^\[submodule \"(.*)\"]$/\x0/p' \
  "$(git rev-parse --show-toplevel)/.gitmodules" \
| tr -d '\n' \
| xargs -0 -n1 printf "%b
$ sed -nre \
's/^\[submodule \"(.*)\"]$/\1\x0/p' \
"$(git rev-parse --show-toplevel)/.gitmodules" \
| tr -d '\n' \
| xargs -0 -n1 printf "%b\0"
"

Et dans votre script:

#!/usr/bin/env bash

while IFS= read -rd '' submodule_name; do
  echo submodule name: "${submodule_name}"
done < <(
  sed -nre \
    's/^\[submodule \"(.*)\"]$/\x0/p' \
    "$(git rev-parse --show-toplevel)/.gitmodules" \
  | tr -d '\n' \
  | xargs -0 -n1 printf "%b
#!/usr/bin/env bash
while IFS= read -rd '' submodule_name; do
echo submodule name: "${submodule_name}"
done < <(
sed -nre \
's/^\[submodule \"(.*)\"]$/\1\x0/p' \
"$(git rev-parse --show-toplevel)/.gitmodules" \
| tr -d '\n' \
| xargs -0 -n1 printf "%b\0"
)
"
)

Note: read -rd '' nécessite bash et ne fonctionne pas avec sh.

Obtenir une liste de sous-module paths

Dans mon approche, j'essaie pas pour traiter la sortie de git config --get-regexp avec awk, tr, sed, ... mais au lieu de le passer de zéro octet séparés dos à git config --get. C'est pour éviter les problèmes avec les sauts de ligne, les espaces et autres caractères spéciaux (par exemple Unicode) dans le sous-module paths. En outre, puisque vous voudrez probablement utiliser cette liste pour de plus amples shell de traitement, la solution ci-dessous des entrées séparées avec NULL-octets (\0).

$ git config --null --file .gitmodules --name-only --get-regexp '\.path$' \
| xargs -0 -n1 git config --null --file .gitmodules --get

Par exemple, dans un script Bash, vous pouvez:

#!/usr/bin/env bash

while IFS= read -rd '' submodule_path; do
  echo submodule path: "${submodule_path}"
done < <(
  git config --null --file .gitmodules --name-only --get-regexp '\.path$' \
  | xargs -0 -n1 git config --null --file .gitmodules --get
)

Note: read -rd '' nécessite bash et ne fonctionne pas avec sh.

---

Notes de bas de page

^[1] de version Git

$ git --version
git version 2.22.0

^[2] sous-module avec divergentes name et path

Configurer dépôt de test:

$ git init test-name-path
$ cd test-name-path/
$ git checkout -b master
$ git commit --allow-empty -m 'test'
$ git submodule add ./ submodule-name
Cloning into '/tmp/test-name-path/submodule-name'...
done.
$ ls
submodule-name

$ cat .gitmodules
[submodule "submodule-name"]
    path = submodule-name
    url = ./

Déplacer sous module pour faire name et path divergent:

$ git mv submodule-name/ submodule-path

$ ls
submodule-path

$ cat .gitmodules
[submodule "submodule-name"]
    path = submodule-path
    url = ./

$ git config --file .gitmodules --get-regexp '\.path$'
submodule.submodule-name.path submodule-path

Tests

Configurer dépôt de test:

$ git init test
$ cd test/
$ git checkout -b master
$ git commit --allow-empty -m 'test'
$
$ git submodule add ./ simplename
Cloning into '/tmp/test/simplename'...
done.
$
$ git submodule add ./ 'name with spaces'
Cloning into '/tmp/test/name with spaces'...
done.
$
$ git submodule add ./ 'future-name-with-newlines'
Cloning into '/tmp/test/future-name-with-newlines'...
done.
$ git mv future-name-with-newlines/ 'name
> with
> newlines'
$
$ git submodule add ./ 'name-with-unicode-'
Cloning into '/tmp/test/name-with-unicode-'...
done.
$
$ git submodule add ./ sub/folder/submodule
Cloning into '/tmp/test/sub/folder/submodule'...
done.
$
$ git submodule add ./ name.with.dots
Cloning into '/tmp/test/name.with.dots'...
done.
$
$ git submodule add ./ 'name"with"double"quotes'
Cloning into '/tmp/test/name"with"double"quotes'...
done.
$
$ git submodule add ./ "name'with'single'quotes"
Cloning into '/tmp/test/name'with'single'quotes''...
done.
$ git submodule add ./ 'name]with[brackets'
Cloning into '/tmp/test/name]with[brackets'...
done.
$ git submodule add ./ 'name-with-.path'
Cloning into '/tmp/test/name-with-.path'...
done.

.gitmodules:

[submodule "simplename"]
    path = simplename
    url = ./
[submodule "name with spaces"]
    path = name with spaces
    url = ./
[submodule "future-name-with-newlines"]
    path = name\nwith\nnewlines
    url = ./
[submodule "name-with-unicode-"]
    path = name-with-unicode-
    url = ./
[submodule "sub/folder/submodule"]
    path = sub/folder/submodule
    url = ./
[submodule "name.with.dots"]
    path = name.with.dots
    url = ./
[submodule "name\"with\"double\"quotes"]
    path = name\"with\"double\"quotes
    url = ./
[submodule "name'with'single'quotes"]
    path = name'with'single'quotes
    url = ./
[submodule "name]with[brackets"]
    path = name]with[brackets
    url = ./
[submodule "name-with-.path"]
    path = name-with-.path
    url = ./

Obtenir la liste des sous-module names

$ sed -nre \
  's/^\[submodule \"(.*)\"]$/\x0/p' \
  "$(git rev-parse --show-toplevel)/.gitmodules" \
| tr -d '\n' \
| xargs -0 -n1 printf "%b
$ sed -nre \
's/^\[submodule \"(.*)\"]$/\1\x0/p' \
"$(git rev-parse --show-toplevel)/.gitmodules" \
| tr -d '\n' \
| xargs -0 -n1 printf "%b\0" \
| xargs -0 -n1 echo submodule name:
submodule name: simplename
submodule name: name with spaces
submodule name: future-name-with-newlines
submodule name: name-with-unicode-
submodule name: sub/folder/submodule
submodule name: name.with.dots
submodule name: name"with"double"quotes
submodule name: name'with'single'quotes
submodule name: name]with[brackets
submodule name: name-with-.path
" \
| xargs -0 -n1 echo submodule name:
submodule name: simplename
submodule name: name with spaces
submodule name: future-name-with-newlines
submodule name: name-with-unicode-
submodule name: sub/folder/submodule
submodule name: name.with.dots
submodule name: name"with"double"quotes
submodule name: name'with'single'quotes
submodule name: name]with[brackets
submodule name: name-with-.path

Obtenir la liste des sous-module paths

$ git config --null --file .gitmodules --name-only --get-regexp '\.path$' \
| xargs -0 -n1 git config --null --file .gitmodules --get \
| xargs -0 -n1 echo submodule path:
submodule path: simplename
submodule path: name with spaces
submodule path: name
with
newlines
submodule path: name-with-unicode-
submodule path: sub/folder/submodule
submodule path: name.with.dots
submodule path: name"with"double"quotes
submodule path: name'with'single'quotes
submodule path: name]with[brackets
submodule path: name-with-.path

Voici une autre façon d'analyser Git sous-module noms de .gitmodules sans la nécessité pour les sed ou de fantaisie FI paramètres. 🙂

#!/bin/env bash

function stripStartAndEndQuotes {
  temp="${1%\"}"
  temp="${temp#\"}"
  echo "$temp"
}

function getSubmoduleNames {
  line=$1
  len=${#line} # Get line length
  stripStartAndEndQuotes "${line::len-1}" # Remove last character
}

while read line; do
  getSubmoduleNames "$line"
done < <(cat .gitmodules | grep "\[submodule.*\]" | cut -d ' ' -f 2-)