Welcome to gitutor. This tool will get you up and running using Git in the shortest time possible while learning on the go.
Gitutor is a command line application that wraps Git and provides beginner friendly versions of git's commands. It makes git easy.
In this tutorial you'll learn how tu use git with the aid of gitutor. Once you feel comfortable using git this way, read what is going on behind gitutor's commands on the last chapters.
The command line includes a summarized version of this tutorial so you'll always have it at hand. To access it run:
$ gt lesson
Don't worry, if you forget how to use a command you just need to run
$ gt <command> --help
and a useful guide will be displayed.
If you have any problems please send us an email at email@example.com or open an issue in our repo, we usually answer in less than a day.
# Installation guide
NOTE: pipx and gitutor work with Python3.6+
In order to use gitutor without any dependencies version conflicts we recommend installing it using pipx. Pipx creates a virtual environment for your package and exposes its entry point so you can run gitutor from anywhere.
To install pipx and configure the $PATH run the following commands
$ python -m pip install pipx $ python -m pipx ensurepath
For MacOS use:
$ brew install pipx
For Linux use:
$ python3 -m pip install pipx $ python3 -m pipx ensurepath
NOTE: You may need to restart your terminal for the path updates to take effect.
Once pipx is installed, run the following to install gitutor:
$ pipx install gitutor
And to upgrade gitutor to its latest version you only need to run:
$ pipx upgrade gitutor
To install gitutor without using pipx just run:
$ pip install gitutor
# Additional notes
It's also recommended to store your GitHub credentials so you won't have to authenticate everytime you realize a push or pull. You can do this by running:
$ git config --global credential.helper store
This will store your credentials in a plain-text file (.git-gredentials) under your project directory. If you don't like this you can use any of the following approaches:
On Mac OS X you can use its native keystore with:
$ git config --global credential.helper oskeychain
For Windows you can install a helper called Git Credential Manager for Windows and then run:
$ git config --global credential.helper manager
Git 101 →