Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nielsouvrard/git-workshop
Small workshop to discover Git and GitHub basic usage
https://github.com/nielsouvrard/git-workshop
git github
Last synced: 3 days ago
JSON representation
Small workshop to discover Git and GitHub basic usage
- Host: GitHub
- URL: https://github.com/nielsouvrard/git-workshop
- Owner: NielsOuvrard
- Created: 2023-10-31T09:15:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-09T13:37:35.000Z (about 1 year ago)
- Last Synced: 2023-11-10T11:36:10.098Z (about 1 year ago)
- Topics: git, github
- Homepage:
- Size: 1.96 MB
- Stars: 26
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Git and GitHub Workshop
## Workshop Overview
Welcome to the Git and GitHub Workshop my dear students ! In this workshop, you will deepen your understanding of Git and GitHub, focusing on collaboration, branching, and best practices. By the end of this workshop, you'll be well-equipped to work effectively with Git and GitHub for both personal and team projects.
## Why making branches ?
Branching make easier to work on a project with multiple people. Each person can work on a feature branch and merge their changes into the main branch when they're done. Branching also makes it easier to work on multiple features at the same time without affecting each other.
Example of issues you can have **without branches** :
Ho no ! I can't push my changes because someone else pushed changes to the remote repository. I need to pull their changes.
Ho no ! My pull has generated conflicts. I need to resolve them.
If you have this kind of issues, refer to the chapter 2.4. **Merge Branches**.
Your conflictual files will look like this (chapter 2.4).
We will see how to avoid this kind of issues with `branches`.
## Chapter 1: Creating and Cloning Repositories
Do this workshop by groups of 2 or 3. You will need to create a repository on GitHub and clone it to your local machine. Then, you will make changes to the repository and push them to the remote repository.
1.1. **Create a New Repository**
- (**Only one in the group**) Create a new Git repository on GitHub. Go to your GitHub page and click the "New" button, in green, on the left side of the page.
- Give it a name like "git-workshop".
1.2. **Clone a Repository**
- Clone this repository from GitHub to your local machine.
1.3. **Make Changes and Push to GitHub**
- (**Only one in the group**) Code something, commit your changes, and push them to the remote repository. Like a main.c file with a hello world.
# Branching and Merging
A branch will be useful for adding new features to your project without affecting the main branch. You can create a new branch for each feature you want to add to your project. Once you're done with a feature, you can merge the changes from your feature branch into the main branch.
## Chapter 2: Branching and Merging
2.1. **Create a New Branch**
- Create a new branch with `git checkout -b `. The `-b` flag creates a new branch. You can call it by your name, like `git checkout -b `.
#### Now every person of the group have a branch with their name. So you can work on your own branch and push your changes to your branch. You can also merge your branch with the main branch.
2.2. **Make Changes in a Branch**
- Make changes to files in your branch. You can create new files, edit existing files, or delete files. For this example, edit the main.c file and modify the hello world to print your name.
- Add and commit your changes.
- Push your branch to the remote repository with `git push --set-upstream origin `.
Now you have many branches, you can merge them with the main branch.
2.3. **Modify the main** (**Only one in the group**)
- Move to the main branch. `git checkout main`
- Modify the main.c file in the main branch. Change the hello world to print "Hello, world from main!".
- Return to your branch. `git checkout `
2.4. **Merge Branches**
- Merge changes from main to your branch. `git merge main`
- You'll see some conflict markers in the files that were modified in both branches. Open the files and resolve the merge conflicts.
#### on vscode
#### on emacs
2.5. **Resolve Merge Conflicts**
- `HEAD` is the most recent commit on your current branch. The other commit is the most recent commit on the branch you're merging from.
- `main` is the branch you're merging from.
- Remove the comments `<<<<<<< HEAD` and `>>>>>>> main` and keep the code you want to keep.
- Add, commit, and push your changes.
## Chapter 3: Collaborating on GitHub
3.1. **Create a Pull Request**
- Make changes in your repository is an easy way to merge changes from one branch to another.
- Discuss and review code changes with others.
#### go to branches on github
#### create a pull request
#### give a title
#### resolve conflicts
#### resolve conflicts and merge
3.2. **Review and Merge Pull Requests**
- Merge changes into the original repository.
## Chapter 4: Best Practices and Workflows
4.1. **.gitignore**
- Create a `.gitignore` file to exclude files and directories from version control. A gitignore is a file that tells Git which files and directories to ignore in a project. An example :
```.gitignore
*.log
*~
#*
a.out
*.o
*.exe
```
4.2. **Commit Messages**
- Write clear and descriptive commit messages. You can use emojis to make your commit messages more expressive :
```
# some emojis
🚀 :rocket: New release
🤖 :ci: Changes to our CI configuration files and scripts
🎉 :tada: Awesome new feature - let's celebrate!
📖 :docs: Documentation only changes
🌟 :feat: A new feature
🚑 :fix: A bug fix
⚡️ :perf: A code change that improves performance
♻️ :refactor: A code change that neither fixes a bug nor adds a feature
🎨 :ui: Changes that affect only UI/styles
✅ :test: Adding missing tests or correcting existing tests
💩 :dirty: Dirty code - needs to be refactored - think to add @debt in your code
🔀 :migration: Doctrine migrations
✏️ :typo: A typo fix
👷️ :ops: Code for infrastructure
🚧️ :wip: Work in progress
```
4.3. **Creating Tags**
- Create annotated and lightweight tags to mark significant points in your project's history.
## Chapter 6: Git Stash
6.1. **Stashing Changes**
- Stashing is a way to mark files as ready to be committed. You can use `git stash` to save changes that you don't want to commit yet.
6.2. **Applying Stashed Changes**
- Apply stashed changes to your working directory with `git stash apply`.
## Chapter 7: Github Actions
7.1. **Test your code**
- Create a directory `tests` in your project.
- Add a file `test.c` (or `test.sh` if you want to use bash) in your `tests` directory.
- Create a Makefile who compile your project. Now, add a new target to your Makefile who run your tests `make test`.
- Try and check if your tests are working (and return 0 if they are ok).
#### Here an example of a test.sh file :
```bash
#!/bin/bash
# Run your tests here
./my_program -arguments1 -arguments2
# Check if the tests passed and set the exit status accordingly
if [ $? -eq 0 ]; then
echo "Tests passed successfully!"
exit 0 # Success
else
echo "Tests failed."
exit 1 # Failure
fi
```
7.2. **Create a Github Action**
- Create a directory `.github/workflows` in your project.
- Add a file `test.yml` in your `.github/workflows` directory.
- Add this code in your `test.yml` file :
```yml
name: Build and Test C++ Project
on: [push] # action will be triggered on every push, exist also on: [pull_request]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout the code
uses: actions/checkout@v2
- name: Set up build environment
run: |
sudo apt-get -y install g++
shell: bash
- name: Build the project
run: |
make
working-directory: ${{ github.workspace }}
- name: Run tests
run: |
make test
working-directory: ${{ github.workspace }}
```
More informations about it:
`runs-on` is used to specify the operating system to run the job on. Here, we use ubuntu-latest.
> :warning: The OS windows-latest and macos-latest are not available in the EPITECH servers.
```yml
runs-on: ubuntu-latest
```
`Set up build environment` is used to install dependencies. Here, we install g++. You can add other dependencies like cmake, clang, etc.
```yml
- name: Set up build environment
run: |
sudo apt-get -y install g++
shell: bash
```
`Build the project` is used to build your project. Here, we use make to build our project.
```yml
- name: Build the project
run: |
make
working-directory: ${{ github.workspace }}
```
`Run tests` is used to run your tests. Here, we use make to run our tests.
```yml
- name: Run tests
run: |
make test
working-directory: ${{ github.workspace }}
```
7.3. **Push your changes**
- Push your changes to your remote repository.
- Go to the `Actions` tab on your repository page on GitHub.
- You should see your action running.
7.4. **Go to the `Actions` tab on your repository page on GitHub.**
7.5 **You can see the result of your tests directly on GitHub repository.**
#### If your tests are ok, you can see this :
#### If your tests are not ok, you can see this :
## Conclusion
Congratulations! You've completed the Git and GitHub Workshop. You are now equipped with the knowledge and skills to use Git and GitHub effectively in your programming projects. Remember to continue practicing and exploring advanced features to become a Git and GitHub expert.
Happy coding! 🚀