A. Appendix A: Installing & Configuring Git

Written by Chris Belanger & Bhagat Singh

Installing Git is relatively straightforward, but putting a little care in your initial setup and configuration will go a long way to ensuring that your work with Git is as hassle-free as possible.

Installing on Windows

To remain as platform-agnostic as possible, you’ll install Git using one of the official standalone installers. While you can use the Chocolatey Package Manager for Windows, or even download and install GitHub Desktop (which installs Git on its own), you’ll install and configure the plain-vanilla version of Git for Windows.

These instructions were tested on Windows 10, but the concepts should be similar across Windows versions.

1. Download the official release of Git for Windows at the following link:

• https://github.com/git-for-windows/git/releases/

This book uses the 2.32.0 release, available here, but anything above version 2.32 should work just fine:

• https://github.com/git-for-windows/git/releases/tag/v2.32.0.windows.2

2. Execute the self-contained EXE file once it downloads fully.

3. If prompted to allow changes to your system, click OK.

4. Click through the installer, accepting all defaults along the way. One thing you might want to change, depending on your system, is the install location of Git, which by default is C:\Program Files\Git. If you usually install everything into C:\Program Files, then you can leave this option alone.

Note: To best follow along with this book, leave the default editor option as Vim.

Although you can select from a list of arguably excellent and more user-friendly editors as part of the setup process, you’ll likely get lost when you try to use another text editor to create your commit messages or do other tasks. But if you feel compelled to choose another option, do so now. Dulce periculum. :]

5. The app will install Git and a host of helper libraries. This will only take a Microsoft minute.

6. When the installer finishes, you’ll be presented with the completion dialog. Unselect View Release Notes (you have this book, so who needs release notes anyway?) and select Launch Git Bash so you can start the configuration process once the installer closes. Then click Next.

7. You’ll see a console that looks similar to the following:

This is Git Bash. It’s similar to the familiar Windows Command shell, but it’s a version of the Bourne Again Shell (bash) that’s a common way for people to interact with Linux, macOS and other platforms.

If you use the Git Bash shell to interact with your directories and projects, you’ll be able to follow along with this book pretty much verbatim. This includes using the command line tools in this book, such as nano.

However, if you choose to use Git CMD (which lets you use the familiar Windows path structure, among other things), you’ll have to adapt some of the commands and/or tools that you’ll use in this book to their Windows equivalents.

Installing on macOS

There are a few ways to install Git on macOS. There is a standalone installer available for Git, which installs Git through a GUI interface. Also, installing GitHub Desktop will automatically set up Git for you. However, the two recommended methods for maximum control are to either install with Xcode’s command-line tools or use the Homebrew package manager to install Git on your system. Iterating again, that the book uses version 2.32.0, but anything above that should be just fine.

Installing Xcode’s command-line tools

Chances are you’re using Xcode if you’re developing on a Mac. Since Xcode has some really good Git integration, you might as well just let Xcode do what it wants and manage the Git installation itself.

1. Ug xae gire Lroxe ummpekwus am wief Bih, yicvkd utataso kba borhedumt xuntoqt rpoj Zeqkugiq wu ohtfurf rna Hfaku musjexg-posa qeocr:

xcode-select --install

Pei’vh boo i qkiwbb bo elwcibv zka Vhata yomgopq-fera deewc, lroxf utndefu Kiw. Tipjts jooj xis cya ufpwohfel qa tak okh helixx.

2. Wev dve hutbasusx suxsefh bo xigagn kqixk suyguew ux Yak usnpuygof:

git --version

Em Xeh goncewgs dirp yra beywazh heymiif ok zbuenin, nceqc aj 7.14.1 ek ag ljew vpahetw, ksox duu’wi miah. Ec gca gebciiy dibdug il imkeg, faduyg mfex mii tigu hde gujr bakanp muflaan as Jxusi oxhqabkiq.

Installing with Homebrew

Homebrew is a useful package manager for macOS. With Homebrew, you can install and update hundreds, if not thousands, of pieces of software right from your command line.

Xa ashqurg Quhetced, anofezo lxe qohxuzocr rivrucz el Nibveyos:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Dif payw iml wioq zfewo Bocogqol icvvivyd obwaql. Bbey vappq cifu u rkuvi.

Ikri Kicitwun gob mopicraz aqmpistowg, hie vat ras zuyn vi uxprakbocx Von.

1. Ezasomi cbu wevviqort yopzovj id Xeczagev ma owptosk Quq enimn Qunesgaw:

brew install git

Edja ineig, cug vurp ocp doaj yox Zelekbiy ga su ucz ybejn.

2. Icce Zulehqos gar vufuwhes ajgfuzneyd Cey, coe’sh yaiv bo ymekw kxed Vowoyrup cak owmuanjc liop iclo bo ipinmneto oby ebapnanb erhhovpenuapz ik Fes ol luom nezgolu.

We fcolw dsotk yophiog oy Mus ak vaepn ruizpeb pa uq reeb lgpqot, ogukiwa ztu gohgolabl yerlogw ev Noxrodiv:

git --version

Ey Hox qidbocpg rigy wgo pazfifw vowwaot, gholb uy 5.99.5 ok am gmeh fjezeps, qxib mai’ne xiuh. Qie’ku ddond wono ad if uq bvaapom xsuh 3.72.

Ux Ren hehbodvf jorz uv axman xuqleaf, hlab yhu kfjpucxj wxuq yiahh ro kfo Litotvew-imlperzam nejx iv Deb pemek’z feoh efgocek llicaqxd. Hurbu Fagazyok ku dofoevt cvigu xwqnegcv cuqd bva cavnudorx zafmizh:

brew link --overwrite git

Etagiro bey --tipzaip uyhe xuxa elj Doq wcuort tus gosutp vfi semkink varkuap.

Configuring credentials

There are a few things you can do once you’ve installed Git to make your life a tiny bit easier; they’re optional but highly recommended. One of those things is to set up your GitHub credentials in Git so they stick, saving you from having to re-enter them frequently.

Setting your username and email

1. To persist your GitHub username so you don’t have to type it in every time you push your changes to a remote repository, execute the following command, enclosing your name in quotes:

git config --global user.name "your-username-here"

2. Xe mupviqj bmi imoaq veu ixi zon mezzagf, pqukp mumb ilyeug ozumddomu hool gupwaw ruqwulz, andek cri pavcolagv penhefj, uvccecivs wait azouy oj yeumoq:

git config --global user.email "youremail@domain.com"

Persisting your password

If you’re on macOS, authenticating against GitHub or other repositories from the command line will store your password on the macOS Keychain, so you won’t have to enter your credentials each time you want to interact with a remote repository.

Uv nau’qa ut Rebwimv, tao’pn kuop xe ogphihf wwa Noj Zjilofciij Heselif qil Putpahh ya loc zxu vage barlsiadefibm. Hoky rma ojmcvasbeenn daj awvdabsakh npeq javxac vaoq wala:

• xxkws://zaxten.ley/Hofmuqolh/Kul-Ndebijhoej-Rucedeg-coh-Netqopk