# .git directory tour~
### 基本環境建置
- 安裝git

sudo apt-get install git

- 建立 local repo

mkdir 你的專案名稱
cd 你的專案資料夾

- initialize git

git init // 生成 .git 目錄
tree .git // 看看有什麼

- 試著做第一次的 commit

touch hello.txt
echo 'Hello world' >> hello.txt
git add hello.txt // 將 hello.txt 檔案加入此次 commit
git commit -m 'Hello world' // commit 並留下 message

## What's in ```.git/```

tree .git/

.git
├── COMMIT_EDITMSG
├── HEAD
├── config
├── description
├── hooks
│   ├── applypatch-msg.sample
│   ├── commit-msg.sample
│   ├── ...
├── index
├── info
│   └── exclude // 不想要 git 紀錄的東西
├── logs
│   ├── HEAD
│   └── refs
│       └── heads
│           └── master
├── objects
│   ├── 38
│   │   └── 0bef7c0d6d05b254e55f3e9c5a8b467a046f04
│   ├── 80
│   │   └── 2992c4220de19a90767f3000a79a31b98d0df7
│   ├── a5
│   │   └── 0b30eb6b223aef893c367a0b93e9a5b21f155f
│   ├── info
│   └── pack
└── refs
    ├── heads
    │   └── master
    └── tags

- config：紀錄 git 的設定 ex. remote url, email, username
- object
## Git 怎麼做到版本控制？
- 存 file
- 存 snapshot (tree)
- 存 commit


tree .git/objects

.git/objects
├── 38
│   └── 0bef7c0d6d05b254e55f3e9c5a8b467a046f04 //commit
├── 80
│   └── 2992c4220de19a90767f3000a79a31b98d0df7 // file
├── a5
│   └── 0b30eb6b223aef893c367a0b93e9a5b21f155f // snapshot
├── info
└── pack

多了好幾串奇怪東東，那這些是什麼？
### hash

git 會以這個格式來做 [sha1](https://zh.wikipedia.org/wiki/SHA-1) hash 
這個不好講，直接來做看看

touch hello.txt
echo "hi" > hello.txt
cat hello.txt

那以這個檔案來說，就會是

hash 起來

![](https://i.imgur.com/VEdsVv4.png)
這就是 git 會對你檔案做的事，你也可以用這個指令來做

:::spoiler 有空可以玩玩看

import os
import zlib
from hashlib import sha1

content = 'hi\n'
header = 'blob {}\0'.format(len(content))
store = header + content
hash = sha1(store.encode('utf-8')).hexdigest()

zlib_content = zlib.compress(store.encode('utf-8'))

path = '.git/objects/{}/{}'.format(hash[:2], hash[2:])
os.makedirs(os.path.dirname(path), exist_ok=True)
with open(path, 'wb+') as file:
    file.write(zlib_content)

:::

:::info
#### commit 的時候 git 會做 2 件事
- 如果檔案沒有更動 -> 把檔案名稱記錄在 snapshot
- 如果檔案有更動，而且有讓 git 紀錄它 -> 把檔案壓縮成 blob ( Binary Large Object ） 後存在 object 裡面，再把他記錄在 snapshot
- 當我建立一個檔案並要 git 紀錄他的時候

touch README.md
git add README.md

├── objects
│   ├── 38
│   │   └── 0bef7c0d6d05b254e55f3e9c5a8b467a046f04
│   ├── 80
│   │   └── 2992c4220de19a90767f3000a79a31b98d0df7
│   ├── a5
│   │   └── 0b30eb6b223aef893c367a0b93e9a5b21f155f
│   ├── e6
│   │   └── 9de29bb2d1d6434b8b29ae775ad8c2e48c5391
git 就會把它儲存在這裡
:::
如果有兩個檔案的hash分別是
`380bef7c0d6d05b254e55f3e9c5a8b467a046f04` 和
`382992c4220de19a90767f3000a79a31b98d0df7` 時會被存成

├── 38
| ├── 0bef7c0d6d05b254e55f3e9c5a8b467a046f04
| └── 2992c4220de19a90767f3000a79a31b98d0df7

這樣可以省下一些空間
來看看第一個檔案裡是什麼
:::info
這個指令可以讓 git 幫你把檔案依照類型 pretty-print 出來，下面都是用這個指令解出來的 (解碼)

git cat-file -p 380bef7c0d6d05b254e55f3e9c5a8b467a046f04

這個指令可以知道檔案的類型：commit, tree, blob

git cat-file -t

:::
這邊可以看到這個 commit 裡面有存一個 tree，這個檔案就是這次 commit 的 snap shot

tree a50b30eb6b223aef893c367a0b93e9a5b21f155f //snapshot
author Chiyu Hsieh <[e-mail]> 1589095643 +0800
committer Chiyu Hsieh <[e-mail]> 1589095643 +0800


Hello world //commit message

:::info
通常第二行會是 parent, 用來紀錄上一次 commit 的 hash, 不過這是首次 commit 所以沒有 parent
:::
snapshot 裡的內容就是在紀錄 working directory 裡的所有檔案的 hash

100644 blob 802992c4220de19a90767f3000a79a31b98d0df7	hello.txt

而 hello.txt 這個檔案的內容也可以用一樣的指令解密出來

git cat-file -p 802992c4220de19a90767f3000a79a31b98d0df7
Hello world

- HEAD
## 我在哪？
在 ```HEAD``` 這個檔案中，git 會紀錄我們所在的分支，把它 cat 出來可以看到我們的位置是紀錄在 `refs/heads/master` 這個 ref 裡面

cat HEAD

ref: refs/heads/master

那打開這個 ref 就會看到我們剛才 commit 的 hash，意思就是我們的位置是在這一次 commit

cat refs/heads/master
380bef7c0d6d05b254e55f3e9c5a8b467a046f04

- tag

也可以用 ```git tag -a tagName ``` 這個指令，建立 一個名為 tagName 的 tag，再用 ```git tag -a tagName commitShortSha```這個指令標記為你的 commit 上 tag，commitShortSha：commit id 的前６碼。

那這個 tag 就會出現在 refs/tag/ 裡面，但是你 commit 的時候，tag 不會更新，因為 tag 是紀錄單一 commit 而不是整個 branch。