Today I discovered the
git cherry command which lets you view the commits
from one branch which have not been picked into another.
Using it is pretty simple:
git checkout my-branch git cherry <upstream> <head>
<upstream> is the base branch, and
<head> is the branch containing the
Lets see a small example. Create a new directory, and inside it create a new git repo. We will also create an empty file, and commit it:
mkdir cherry-test && cd cherry-test git init touch file.txt git add file.txt git commit -m "First commit"
Now that we have a commit, let’s create a new branch off master:
git branch develop
develop branch will now have the single commit (“First commit” from above).
Still on master, lets create another file, and commit that too:
touch another_file.txt git add another_file.txt git commit -m "Second commit"
This leaves us in the place where we have a commit on master, which has not
yet been cherry-picked onto our “develop” branch. Now, if we checkout the
git checkout develop), we can use
git cherry to view the commits
which we can cherry-pick (in our case, just the one):
git cherry develop master
This will show all the commits we have not yet cherry-picked from master into develop. The output is something like:
$ git cherry develop master + 722610c62760255e587bc8fec91b917550f38e77
+ at the start. This indicates that the commit has not yet been
cherry-picked. If we were to cherry-pick this commit and re-run
git cherry as
above, we would see the same ID prefixed with
- instead of
that the commit has been cherry-picked already.
Viewing commit IDs on their own doesn’t give us a whole lot of information. We
can add the
-v option to
git cherry to include the subject of each commit
in the output:
$ git cherry develop master + 722610c62760255e587bc8fec91b917550f38e77 Second commit
Now we can see our message “Second commit” from earlier is displayed alongside
the ID. From here we can use
git show to view more information about any
particular commit in the list.
You can run
man git-cherry to read more about this command. It’s super useful,
and I wish I knew about it before now!