python_introduction/learning_git.md

6.9 KiB

About

Git is a Version Control System. It is an advanced open source project. That is the most popular VCS with his advantage like security, efficiency, speed etc. He was developed in 2005 by Linus Torvalds, the Linux's father. Many companies projects using Git (Google, Gnome, Netflix, etc). In 2016 12 million people were using Git.

All project histories were saved in the work file. You can publish, with all histories, projects in a Git platform like Gitea, GitHub, Bitbucket, GitLab, etc. With this tool, you can commit projects, compare projects. That is the best tool for teamwork.

git flow

Git via bash

Initialing a git repo

waldek@metal:~/Documents/my_first_git_repository$ git status
fatal: not a git repository (or any of the parent directories): .git
waldek@metal:~/Documents/my_first_git_repository$ git init .
hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint: 
hint: 	git config --global init.defaultBranch <name>
hint: 
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint: 
hint: 	git branch -m <name>
Initialized empty Git repository in /home/local/waldek/Documents/my_first_git_repository/.git/
waldek@metal:~/Documents/my_first_git_repository$ git status
On branch master

No commits yet

nothing to commit (create/copy files and use "git add" 

What's in this repo

waldek@metal:~/Documents/my_first_git_repository$ ls -la
total 12
drwxr-xr-x 3 waldek waldek 4096 May  2 22:06 .
drwxr-xr-x 4 waldek waldek 4096 May  2 22:06 ..
drwxr-xr-x 7 waldek waldek 4096 May  2 22:07 .git
waldek@metal:~/Documents/my_first_git_repository$ ls -la .git/
total 40
drwxr-xr-x 7 waldek waldek 4096 May  2 22:07 .
drwxr-xr-x 3 waldek waldek 4096 May  2 22:06 ..
drwxr-xr-x 2 waldek waldek 4096 May  2 22:06 branches
-rw-r--r-- 1 waldek waldek   92 May  2 22:06 config
-rw-r--r-- 1 waldek waldek   73 May  2 22:06 description
-rw-r--r-- 1 waldek waldek   23 May  2 22:06 HEAD
drwxr-xr-x 2 waldek waldek 4096 May  2 22:06 hooks
drwxr-xr-x 2 waldek waldek 4096 May  2 22:06 info
drwxr-xr-x 4 waldek waldek 4096 May  2 22:06 objects
drwxr-xr-x 4 waldek waldek 4096 May  2 22:06 refs
waldek@metal:~/Documents/my_first_git_repository$

Adding and tracking content

waldek@metal:~/Documents/my_first_git_repository$ cat readme.md 
# Hello world

I am a paragraph.
I can contain multiple sentences, each on one line.

A blank line separates multiple paragraphs.

1. lists
1. will
1. auto increment in most HTML render engines
	* sublists
	* are possible
	* on multiple
		* levels
1. but I keep counting...

[I will become](https://kernel.org) a link.

And I'm a line:

---

waldek@metal:~/Documents/my_first_git_repository$ git status
On branch master

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	readme.md

nothing added to commit but untracked files present (use "git add" to track)
waldek@metal:~/Documents/my_first_git_repository$ 

Now we can add and commit our changes.

waldek@metal:~/Documents/my_first_git_repository$ git add readme.md 
waldek@metal:~/Documents/my_first_git_repository$ git status
On branch master

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
	new file:   readme.md

waldek@metal:~/Documents/my_first_git_repository$ git commit -m "adds a readme file"
[master (root-commit) 8278e12] adds a readme file
 1 file changed, 22 insertions(+)
 create mode 100644 readme.md
waldek@metal:~/Documents/my_first_git_repository$ git status
On branch master
nothing to commit, working tree clean
waldek@metal:~/Documents/my_first_git_repository$ 

We can use git log to inspect the list of commits. Add the --no-pager to bypass less and print the output straight to the console.

waldek@metal:~/Documents/my_first_git_repository$ git --no-pager log
commit 8278e1273d1438920c1063cdca179eb70d5926d8 (HEAD -> master)
Author: waldek <waldek@mailbox.org>
Date:   Mon May 2 22:16:50 2022 +0200

    adds a readme file
waldek@metal:~/Documents/my_first_git_repository$ 

The main workflow

  1. edit your files
  2. git status to verify what's new or has been modified
  3. git add the files you want to commit
  4. git commit -m "A RELEVANT COMMIT MESSAGE"
  5. git push to wherever you have your repository
  6. repeat step one...

Git via Atom

Git via Pycharm

Starting a version controlled project

In Pycharm, you have to enable a version control integration. There are many choices, but we will use Git. As you can see, Git appears in the toolbar and a git window appear bottom of the window. And you can identify the current branch that you are in. So the default branch name is master.

screenhot

screenhot

screenhot

Let's try to write some code And add all contents that we write in a git repository.

screenhot

In the commit window, we can see file project. But we had three important things. We have a textBox and two buttons. In the textBox, you can write a comment when you commit. The Commit button is used to save all change in your project. The Commit and Push is used to commit and push the project in a Git.

screenhot

When you press the Commit and Push, a new window appears. You can see which branch and which commit that you push.

screenhot

Creating an online repository

screenhot

screenhot

screenhot

screenhot

screenhot

screenhot

Adding some changes to our local code

screenhot

screenhot

screenhot

Cloning the remote project into a new project

To arrive at the startup screen shown below you need to close all open projects.

screenhot

screenhot

screenhot

screenhot

screenhot

screenhot

screenhot

Updating the original project

screenhot

screenhot

screenhot