git - sistema di controllo versione distribuito

# Struttura interna
.git/
├── HEAD          ← punta al branch corrente ("ref: refs/heads/main")
├── config        ← configurazione locale del repo (remote, user, ecc.)
├── index         ← staging area — file pronti per il prossimo commit
├── objects/      ← database di tutti i commit, tree, blob (i dati reali)
│   ├── ab/       ← primi 2 char dell'hash → subdirectory
│   └── cd/       ← ogni oggetto identificato dal suo SHA-1
├── refs/
│   ├── heads/    ← branch locali (main, feature, ecc.)
│   └── remotes/  ← branch remoti (origin/main, ecc.)
└── logs/         ← storia di tutti i movimenti di HEAD (reflog)

# Vedere a cosa punta HEAD
cat .git/HEAD

# Vedere l'hash dell'ultimo commit
cat .git/refs/heads/main

# Recuperare commit "persi" (anche dopo reset --hard)
git reflog

# GIT_DIR può essere impostato manualmente per puntare
# a un gitdir in una posizione non standard
GIT_DIR=/path/al/gitdir git status

# Bare repo — solo il gitdir, nessun file di lavoro
# È quello che gira su GitHub dietro le quinte
git init --bare repo.git

# Verificare se sei in un bare repo
git rev-parse --is-bare-repository

# Vedere il path del gitdir corrente
git rev-parse --git-dir

# Output tipico:
# /Users/barno/progetti/obsidian-vault/.git

# Problema: iCloud sincronizza .git/ → conflitti, file duplicati, corruzione repo
# Soluzione: cartella di lavoro su iCloud, gitdir fuori

# Crea il gitdir in una posizione fuori da iCloud
git init --separate-git-dir /Users/barno/gitdirs/obsidian-vault ~/Library/Mobile\ Documents/obsidian-vault

# Risultato:
# ~/Library/Mobile Documents/obsidian-vault/   ← su iCloud (file di lavoro)
#   └── .git                                   ← file di testo con path al gitdir
#                                                 NON una cartella, solo un puntatore
# /Users/barno/gitdirs/obsidian-vault/         ← fuori da iCloud (il vero gitdir)

# Il file .git nella cartella di lavoro contiene solo:
cat ~/Library/Mobile\ Documents/obsidian-vault/.git
# gitdir: /Users/barno/gitdirs/obsidian-vault

# prima:   D───E───F    ← 3 commit separati
# dopo:    D'           ← squashati in 1 solo commit
git rebase -i HEAD~3

git checkout feature
git rebase main           # sposta i commit di feature sopra main
git rebase -i HEAD~3      # rebase interattivo: modifica/squash ultimi 3 commit
git rebase --abort        # annulla il rebase se ci sono conflitti
git rebase --continue     # continua dopo aver risolto i conflitti

# Differenza tag leggero vs annotato
git tag v1.0              # leggero — solo un puntatore
git tag -a v1.0 -m "msg"  # annotato — ha metadati propri (autore, data, messaggio)

# Scenario: hai pushato una password per errore

# 1. Riscrivi la storia locale rimuovendo il commit con il segreto
git rebase -i HEAD~2

# 2. Sovrascrivi il remote con la storia riscritta
git push --force
# Il commit con hash 12345 non esiste piu' nella storia del remote.
# Chi fa git clone ORA non vedra' mai la password.

git cherry-pick <hash-commit>   # applica quel commit sul branch corrente
git cherry-pick A..F            # range di commit
git cherry-pick --no-commit     # applica le modifiche senza creare il commit
git cherry-pick --abort         # annulla se ci sono conflitti

git reset --soft HEAD~1    # annulla il commit → file restano in staging
git reset --mixed HEAD~1   # annulla il commit → file tornano a untracked
git reset --hard HEAD~1    # annulla il commit → file cancellati

# Recuperare un commit perso dopo reset --hard
git reflog                        # trova l'hash del commit perso
git checkout <hash>               # ispeziona
git cherry-pick <hash>            # o ripristina sul branch corrente

git mv vecchio-nome.md nuovo-nome.md
git add .
git commit -m "rename: vecchio-nome → nuovo-nome"

git mv guide guide_temp
git mv guide_temp Guide
git add .
git commit -m "fix: rename guide → Guide"

# Struttura tipica
cyber-appunti/               ← repo padre (pubblico, Hugo)
├── themes/
│   └── dark-theme-editor/   ← submodule (repo del tema)
├── content/
│   └── notes/               ← submodule (repo Obsidian privato)
└── hugo.toml

git submodule add https://github.com/user/repo.git path/destinazione
git commit -m "feat: aggiunto submodule X"

# I submodule arrivano vuoti dopo il clone
git clone <url>
git submodule update --init                  # popola i submodule
git submodule update --init --recursive      # submodule annidati

git submodule update --remote path/submodule  # aggiorna all'ultimo commit remoto
git add .
git commit -m "update: submodule X aggiornato"

git submodule status           # stato di tutti i submodule
git submodule foreach git pull # pull in tutti i submodule in un colpo

git submodule deinit path/submodule
git rm path/submodule
rm -rf .git/modules/path/submodule
git commit -m "remove: submodule X rimosso"

# repo padre vede:              non vede:
# .gitmodules    ← url + path   i file dentro il submodule
# commit hash    ← ABC123       le modifiche interne

git clone https://github.com/target/repo
git log --all --oneline   # cerca commit tipo "remove credentials", "fix config"
git show abc1234          # mostra il contenuto di quel commit

git diff --staged | grep -i "password\|secret\|key\|token"

# Ispeziona la storia cercando commit sospetti
git log --all --oneline
# cerca messaggi tipo: "fix info leak", "remove credentials", "fix config"

# Metodo 1 — mostra il diff di un commit specifico
git show abc1234

# Metodo 2 — confronta due commit esplicitamente
git diff abc1234 def5678

# Verifica prima del push
git diff --staged | grep -i "password\|secret\|key\|token\|api"

.git/objects/
├── d0/
│   └── cf2ab7dd7e...    # il commit con la password — sempre qui
├── b0/
│   └── 354c7be30f...    # il commit "fix info leak"
└── pack/                # oggetti compressi insieme dopo git gc

# Vedere tutti gli oggetti nel database locale
git cat-file --batch-all-objects --batch-check

- `.pack` — gli oggetti compressi (i dati reali: commit, system, alberi)
- `.idx` — l'indice per trovare velocemente un oggetto nel pack per hash
- `.rev` — indice inverso, da posizione nel pack → hash

# Forzare la pulizia degli oggetti non referenziati
git gc --prune=now