126

I am new to shell scripting and can't figure this out. If you are unfamiliar, the command git branch returns something like

* develop
  master

, where the asterisk marks the currently checked out branch. When I run the following in the terminal:

git branch | grep "*"

I get:

* develop

as expected.

However, when I run

test=$(git branch | grep "*")

or

test=`git branch | grep "*"`

And then

echo $test

, the result is just a list of files in the directory. How do we make the value of test="* develop"?

Then the next step (once we get "* develop" into a variable called test), is to get the substring. Would that just be the following?

currentBranch=${test:2} 

I was playing around with that substring function and I got "bad substitution" errors a lot and don't know why.

3
  • Try this blog post. Jan 21, 2010 at 16:51
  • What if you use single quotes around the asterisk: '*' instead of "*" Jan 21, 2010 at 17:21
  • @glenn that's not where the expansion happens, it's in the echo, as marco already elaborated upon.
    – wich
    Jan 22, 2010 at 8:09

6 Answers 6

139

Expanding on Noufal Ibrahim's answer, use the --short flag with git-symbolic-ref, no need to fuss with sed.

I've been using something like this in hooks and it works well:

#!/bin/bash

branch=$(git symbolic-ref --short HEAD)

echo
echo "**** Running post-commit hook from branch $branch"
echo

That outputs "**** Running post-commit hook from branch master"

Note that git-symbolic-ref only works if you're in a repository. Luckily .git/HEAD, as a leftover from Git's early days, contains the same symbolic ref. If you want to get the active branch of several git repositories, without traversing directories, you could use a bash one-liner like this:

for repo in */.git; do branch=$(cat $repo/HEAD); echo ${repo%/.git} :  ${branch##*/}; done

Which outputs something like:

repo1 : master  
repo2 : dev  
repo3 : issue12

If you want to go further, the full ref contained in .git/HEAD is also a relative path to a file containing the SHA-1 hash of the branch's last commit.

2
  • 5
    alias currentgitbranch='git symbolic-ref --short HEAD'
    – Pat
    Jul 29, 2015 at 1:43
  • 2
    This is the best answer, using --short gets you just the string you are looking for. Thanks!
    – 0atman
    Jul 25, 2016 at 11:50
132

The * is expanded, what you can do is use sed instead of grep and get the name of the branch immediately:

branch=$(git branch | sed -n -e 's/^\* \(.*\)/\1/p')

And a version using git symbolic-ref, as suggested by Noufal Ibrahim

branch=$(git symbolic-ref HEAD | sed -e 's,.*/\(.*\),\1,')

To elaborate on the expansion, (as marco already did,) the expansion happens in the echo, when you do echo $test with $test containing * master then the * is expanded according to the normal expansion rules. To suppress this one would have to quote the variable, as shown by marco: echo "$test". Alternatively, if you get rid of the asterisk before you echo it, all will be fine, e.g. echo ${test:2} will just echo master. Alternatively you could assign it anew as you already proposed:

branch=${test:2}
echo $branch

This will echo master, like you wanted.

5
  • 3
    It would be courteous of you to mention my answer if you used elements from it to update yours. Jan 21, 2010 at 17:24
  • Of course, my apologies, I updated quickly before leaving, missed the attribution.
    – wich
    Jan 22, 2010 at 8:07
  • 2
    ok, so I tried both the methods, and I must say that symbolic-ref won't always work. eg: if you checkout some old commit, it throws error, whereas the sed command gives something like (HEAD detached at 1qw23er)
    – zhirzh
    Oct 30, 2015 at 1:22
  • 3
    Note: the first technique works even if there are forward slashes in the branch name (e.g., because it is an issue URL), why the second one only takes the last segment in that case. Mar 30, 2016 at 13:09
  • sed makes this even easier, actually! branch=$(git branch | sed '/^ /d;s/^\* //')
    – wilbur4321
    May 24, 2022 at 20:41
38

I would use the git-symbolic-ref command in the git core. If you say git-symbolic-ref HEAD, you will get the name of the current branch.

2
  • 15
    In later version of git, you will have to use git symbolic-ref HEAD instead. Jan 22, 2010 at 13:03
  • 6
    You'd want to use the --short flag to only get the branch name. For an example: While on the master branch git-symbolic-ref HEAD outputs refs/heads/master but ` git-symbolic-ref --short HEAD` only outputs master Apr 5, 2019 at 12:11
23

I use this git describe --contains --all HEAD in my git helper scripts

example:

#!/bin/bash
branchname=$(git describe --contains --all HEAD)
git pull --rebase origin $branchname

I have that in a file called gpull in ~/scripts

Edit:

for a lot of CI environments, they'll check your code out in a "detached head" state, so then I'll use:

BRANCH=$(\
  git for-each-ref \
  --format='%(objectname) %(refname:short)' refs/heads \
  | awk "/^$(git rev-parse HEAD)/ {print \$2}"\
)
3
  • git describe --contains --all HEAD does not give me the current branch as highlighted by a star with git branch.
    – hakre
    Mar 12, 2014 at 10:57
  • this was useful in a jenkins build script, thanks Feb 18, 2015 at 16:21
  • 1
    Attention: With git describe, if you have a tag on HEAD it will give you the tag name instead of branch name. Mar 2, 2021 at 15:47
8

The problem relies on:

echo $test

In fact the variable test contains a wildcard which is expanded by the shell. To avoid that just protect $test with double quotes:

echo "$test"
0
1

disable subshell glob expansion,

test=$(set -f; git branch)
1
  • 1
    that's not where the expansion happens, it's in the echo, as marco already elaborated upon.
    – wich
    Jan 22, 2010 at 8:11

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