git: submodule helpers
Get a list of commits inside a submodule
Submodules are identified by SHA-1 hashes so you may need to get a list of them. Run the following inside the submodule folder (or inside the separate submodule repository):
git log --oneline
5bd722f commit 5
b5c1524 commit 4
2444bfa commit 3
e0eadd5 commit 2
c180c5a commit 1
702fc8a commit 0
View current submodule commit
git submodule status
5bd722fa26dcdd64128392aa28e08849fe37f111 sub (heads/master)
Compare a submodule state with another branch
If we are on a branch and want to compare the sub submodule state
with master, we can use git diff like this:
git diff master -- sub
diff --git a/sub b/sub
index 702fc8a..5bd722f 160000
--- a/sub
+++ b/sub
@@ -1 +1 @@
-Subproject commit 702fc8a7edcdf5ceba9929958bd6cd7f000eb369
+Subproject commit 5bd722fa26dcdd64128392aa28e08849fe37f111
Where -Subproject commit is another (master) branch state and
+Subproject commit is the current branch state.
View changes in submodule state on the current branch
To view submodule state changes, we can use git log -p
for the submodule folder (the sub in the example below):
git log -p sub
commit 261aa4bdb6944c77fc98e52748d656e56969ba6a
Author: name
Date: Thu Sep 13 15:20:48 2012 +0300
accidental sub switch to commit 5
diff --git a/sub b/sub
index b5c1524..5bd722f 160000
--- a/sub
+++ b/sub
@@ -1 +1 @@
-Subproject commit b5c15241fe40f122d5225e5c76457802de3ad605
+Subproject commit 5bd722fa26dcdd64128392aa28e08849fe37f111
commit 073aaf160706d705c6c95ab21327388cd6683486
Author: name
Date: Thu Sep 13 14:58:41 2012 +0300
sub commit 4
diff --git a/sub b/sub
index 2444bfa..b5c1524 160000
--- a/sub
+++ b/sub
@@ -1 +1 @@
-Subproject commit 2444bfa760b5d3cc974658bd18482f9679f52b69
+Subproject commit b5c15241fe40f122d5225e5c76457802de3ad605
...
Where -Subproject commit is a previous submodule state and
+Subproject commit is a new submodule state.