6

Is there a command to set the same branch name for all existing Git Submodules

git submodule add -b develop *

Basically I need a way to recursively set the branch for each module in the .gitmodules file.

2 Answers 2

15

Looking for a way to recursive set the branch in the .gitmodules file

With Git 2.22 (Q2 2019, four years later), you will be able to use git submodule set-branch -b <abranch>, because git submodule learns set-branch subcommand that allows the submodule.*.branch settings to be modified.

See commit b57e811, commit c89c494 (08 Feb 2019), and commit 7a4bb55 (07 Feb 2019) by Denton Liu (Denton-L).
(Merged by Junio C Hamano -- gitster -- in commit 01f8d78, 25 Apr 2019)

submodule: teach set-branch subcommand

This teaches git-submodule the set-branch subcommand which allows the branch of a submodule to be set through a porcelain command without having to manually manipulate the .gitmodules file.

In your case, for all submodules, using git submodule foreach:

git submodule foreach 'git submodule set-branch --branch aBranch -- ${sm_path}'
git submodule foreach 'git submodule set-branch --default -- ${sm_path}'

(the last line set the master branch, which is the default)


Before Git 2.22, you would use the command I mentioned in "How can I specify a branch/tag when adding a Git submodule?"

 git submodule foreach 'git config -f .gitmodules submodule.${sm_path}.branch <branch>'

Note: Git 2.24 (Q4 2019) makes clear the --default and --branch options are mutually exclusive.

See commit 40e747e (16 Sep 2019) by Denton Liu (Denton-L).
(Merged by Junio C Hamano -- gitster -- in commit 7f17913, 07 Oct 2019)

12
  • 1
    how do you get ${sm_path}? Is that from foreach? When I try your command: git submodule foreach 'git submodule set-branch --branch development -- ${sm_path}' I get this error: fatal: run_command returned non-zero status for api api is one of my submodules Commented May 16, 2019 at 3:57
  • @JoshuaDyck It is set by git submodule foreach: git-scm.com/docs/git-submodule#Documentation/…. What version of Git are you using? On which OS and which shell? Are you using it from the root folder of the parent repo hosting those submodules?
    – VonC
    Commented May 16, 2019 at 4:30
  • I installed the latest from git-scm.com which was 2.21. That must be it. I assumed the latest release would have it. But as you stated above it is 2.22. How would you go about getting 2.22 if git-scm.com only has 2.21? Thanks! Commented May 17, 2019 at 19:47
  • @JoshuaDyck Correct. You now have the 2.22rc0 for you to test.
    – VonC
    Commented May 17, 2019 at 19:50
  • hi @VonC I just installed Git 2.23 in windows and have same problems as Joshua...
    – YaP
    Commented Nov 4, 2019 at 15:25
4

See git submodule foreach.

Evaluates an arbitrary shell command in each checked out submodule.

git submodule foreach git checkout -b develop
1
  • Looking for a way to recursive set the branch in the .gitmodules file. Updated to clarify
    – DarVar
    Commented Jan 14, 2015 at 10:55

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.