This repository will help you practice the basics of the GitHub flow and how to work on open source projects.
Here is a link to a presentation to git in general: https://docs.google.com/presentation/d/1vfsG__2-T7xJYGKFs9HfPKmaoMN1Je0V0h7gLyiY1AU/edit?usp=sharing
These steps assume that you have installed git locally, that you have created a GitHub account, and have added your local ssh key to it.
-
Fork this repo, using the fork button in the top right corner.
-
Clone your forked repo locally.
git clone [email protected]:<your-github-handle>/git-tuto.git
-
Add the original project as a distant repo.
git remote add upstream https://github.com/zaccharieramzi/git-tuto.git
-
Create a new branch to add your name to the list of people who have participated to the tutorial.
git checkout -b <your-name-or-pseudonym>
-
Add your name to the
participants.csv
file.echo '<your-name-or-pseudonym>,\n' >> participants.csv
-
Stage and commit your changes.
git add participants.csv && git commit -m'Added <your-name-or-pseudonym> to the participants file'
-
Push your local branch to your distant repo.
git push origin <the-name-of-your-branch>
-
Open a new Pull Request (PR): https://github.com/zaccharieramzi/git-tuto/compare. You have an example PR here.
-
Iterate with feedback.
-
Once the PR is (squashed and) merged, don't forget to update your local repo (
git checkout master && git pull upstream master
) and your distant repo (git push origin master
).
Once you have understood how the GitHub flow works, you can try to take part in the continuous integration (CI) tutorial. But first, what is CI? CI is a process that can be best described as the continuous testing of the code as parts are added to it. This makes sure that a new addition to the codebase does not alter unexpectedly the behaviour of the code.
Many tools exist but we will here use only Travis CI. To set it up you just need to register to their website, add your repo to the list of watched repositories, and then add a travis config file to your project. The travis config file is a YAML file containing a list of instructions on how to run the tests correctly.
This assumes you have taken the steps 1-4 of the git tutorial.
-
Add a file _function.py to the functions folder.
-
In this file, write a simple function that can be easily tested. An example is my function file. The function doesn't have to be about numbers but can be about all the built-in data structures python provides.
-
Add a corresponding unit test for this new function. An example of a corresponding unit test is mine.
-
Perform the steps 6-10 of the git-tutorial with the slight exception that you need to have a more suited commit message.
You are free to suggest improvements both on the presentation and on this tutorial using the Issues of this repo. A first good contribution might be for example to add the Contributing guidelines.