Posodobi uvod
This commit is contained in:
Martin Vuk
parent
4ae9fed0ec
commit
6546899abb
2 changed files with 1831 additions and 1582 deletions
3226
git-intro.pdf
3226
git-intro.pdf
File diff suppressed because it is too large
Load diff
187
git-intro.typ
187
git-intro.typ
|
|
@ -1,97 +1,124 @@
|
|||
#set page("a4", margin: 20mm)
|
||||
#set text(lang: "sl")
|
||||
#show link: set text(blue)
|
||||
#import "@preview/fletcher:0.5.8" as fletcher: diagram, node, edge
|
||||
#import fletcher.shapes: house, chevron, pill
|
||||
#import "@preview/fletcher:0.5.8" as fletcher: diagram, edge, node
|
||||
#import fletcher.shapes: chevron, house, pill
|
||||
|
||||
#let note(content) = rect(stroke: 0.5pt, width: 100%, fill: green.lighten(50%), content)
|
||||
|
||||
#include "git-figure.typ"
|
||||
|
||||
#align(center)[
|
||||
= Git za gike
|
||||
= Git za matematike
|
||||
]
|
||||
Dokument opiše delovanje sistema za nadzor različic #link("https://git-scm.com/")[Git] za nekoga, ki želi vedeti,
|
||||
kako stvari delujejo.
|
||||
#v(2em)
|
||||
|
||||
Naučili se bomo, *kako Git deluje*. Spoznali bomo, da so v ozadju Gita
|
||||
*vsebinsko naslovljiva shramba podatkov*, *Merklejeva drevesa* in *usmerjen aciklični graf*.
|
||||
|
||||
*Cilj:* Razumeti _logiko_ Gita. Ko razumemo, kaj je v ozadju, lahko operacije, kot so `merge`,
|
||||
`rebase` in `reset` preporsto razložimo s preoblikovanjem grafa in premikanjem kazalcev po grafu.
|
||||
|
||||
*Čas branja:* 30 min
|
||||
|
||||
== Kaj je Git?
|
||||
|
||||
#link("https://git-scm.com/")[Git] je sistem za upravljanje različic. Kaj to pomeni?
|
||||
#note[Git hrani vsebino direktorija z datotekami in celotno zgodovino sprememb.
|
||||
Zgodovina sprememb se hrani v obliki posnetkov celotne vsebine v določenih trenutkih.]
|
||||
#link("https://git-scm.com/")[Git] je kot *časovni stroj* za datoteke. Uporabniku omogoča, da vidi *pretekle različice* datotek,
|
||||
sprememinja datoteke, *brez skrbi, da bi kaj pokvaril* in datoteke *deli z drugimi*.
|
||||
Git namreč hrani vsebino direktorija z datotekami in celotno zgodovino različic datotek iz preteklosti.
|
||||
Za vsako različico hrani Git zapis o avtorju, datumu in opis sprememb, ki so nastale v primerjavi s predhodno
|
||||
različico.
|
||||
|
||||
#note[
|
||||
Sisteme, ki omogočajo hranjenje preteklih različic datotek, imenujemo
|
||||
#link("https://en.wikipedia.org/wiki/Version_control")[sistemi za nadzor različic] (angl. version control system (VCS)) ali
|
||||
_sistemi za upravljanje z izvorno kodo_ (angl. Source Code Management (SCM)).
|
||||
|
||||
Poleg nadzora različic Git omogoča, da datoteke spreminja več uporabnikov na različnih računalnikih hkrati.
|
||||
Zato je Git #link("https://en.wikipedia.org/wiki/Distributed_version_control")[distribuiran sistem za nadzor različic]
|
||||
(angl. Distributed Version Control System (DVCS)).
|
||||
]
|
||||
|
||||
|
||||
== Git repozitorij
|
||||
|
||||
Git repozitorij je direktorij v katerem je poddirektorij `.git`, ki vsebuje vso zgodovino sprememb in ostale podatke, ki jih Git potrebuje.
|
||||
Git repozitorij je direktorij v katerem je poddirektorij `.git`, ki vsebuje vso zgodovino sprememb in ostale podatke,
|
||||
ki jih Git potrebuje.
|
||||
|
||||
== Vnos: posnetek stanja
|
||||
Osnovna enota v Gitu je *vnos* (angl. *commit*). Vnos je posnetek stanja zabeleženih datotek v trenutku,
|
||||
ko je bil ustvarjen. Poleg vsebine datotek vsak vnos vsebuje še metapodatke o avtorju, datumu vnosa in opisom
|
||||
sprememb. Vsakemu vnosu je prirejena *zgoščena vrednost vnosa* (angl. *hash*), ki je 40-mestna heksadecimalna vrednost,
|
||||
izračunana s SHA-1, in je natanko določena z vsebino shranjenih datotek in metapodatkov vnosa.
|
||||
izračunana s SHA-1, in je natanko določena z vsebino shranjenih datotek in metapodatkov vnosa.
|
||||
#note[Git obravnava podatke v repozitoriju kot *posnetke stanja* in ne zgolj kot zaporedje *sprememb*. To je ena glavnih razlik med Gitom in predhodnimi sistemi za upravljanje različic (glej #link("https://git-scm.com/book/en/v2/Getting-Started-What-is-Git%3F")[Kaj je Git?]).]
|
||||
|
||||
Vnose in vsebino datotek hrani Git v #link("https://git-scm.com/book/en/v2/Git-Internals-Git-Objects")[skladišču objektov].
|
||||
Do objektov v skladišču lahko dostopamo, če poznamo njihovo _zgoščeno vrednost_. Objekti, ki jih Git hrani v skladišču
|
||||
so *vnosi*, *posnetki direktorijev* in *posnetki posameznih datotek*.
|
||||
Do objektov v skladišču lahko dostopamo, če poznamo njihovo _zgoščeno vrednost_. Objekti, ki jih Git hrani v skladišču
|
||||
so *vnosi*, *posnetki direktorijev* in *posnetki posameznih datotek*.
|
||||
#figure(
|
||||
table(columns: 1, [*zgoščena vrednost*: 8dd6d4bdaeff93016bd49474b54a911131759648],
|
||||
```
|
||||
tree 65c47feec7465e80492620a48206793e078702e0
|
||||
parent 16f2994757f1213935b8edb9ae7fee3a8e9ec98d
|
||||
author MV <mv@example.com> 1765235698 +0100
|
||||
committer MV <mv@example.com> 1765235698 +0100
|
||||
|
||||
Dodaj bla
|
||||
```,
|
||||
stroke: 1pt, align: left),
|
||||
table(
|
||||
columns: 1,
|
||||
[*zgoščena vrednost*: 8dd6d4bdaeff93016bd49474b54a911131759648],
|
||||
```
|
||||
tree 65c47feec7465e80492620a48206793e078702e0
|
||||
parent 16f2994757f1213935b8edb9ae7fee3a8e9ec98d
|
||||
author MV <mv@example.com> 1765235698 +0100
|
||||
committer MV <mv@example.com> 1765235698 +0100
|
||||
|
||||
Dodaj bla
|
||||
```,
|
||||
stroke: 1pt,
|
||||
align: left,
|
||||
),
|
||||
caption: [Primer vnosa v Gitu. Vnos vsebuje zgoščeno vrednost posnetka direktorija(`tree`), zgoščeno vrednost
|
||||
starševskega vnosa (`parent`) in metapodatke. Tudi sam vnos je natančno določen z zgoščeno vrednostjo.],
|
||||
starševskega vnosa (`parent`) in metapodatke. Tudi sam vnos je natančno določen z zgoščeno vrednostjo.],
|
||||
)
|
||||
Posnetki direktorijev so v Gitu posebne vrste objekti tipa `tree`. Vsebujejo zgoščene vrednosti in metapodatke o
|
||||
datotekah in direktorijih, ki jih vsebuje.
|
||||
#figure(table(columns: 1, stroke:1pt, [*zgoščena vrednost*: `d934342ca420dd0d9828782c7103103f2922d2a6`],
|
||||
```
|
||||
100644 blob 76018072e09c5d31c8c6e3113b8aa0fe625195ca bar.txt
|
||||
100644 blob ba0e162e1c47469e3fe4b393a8bf8c569f302116 foo.txt
|
||||
040000 tree 3b8bfca88b2cc4127ce5909eb3a7395e8b5f2b6a podmapa
|
||||
```
|
||||
),
|
||||
caption: [Primer posnetka direktorija v Gitu (objekt tipa `tree`). Posnetek vsebuje zgoščene vrednosti datotek in direktorija, ki jih vsebuje. Uporaba zgoščenih vrednosti natančno določa vsebino posnetka direktorija.])
|
||||
#figure(
|
||||
table(
|
||||
columns: 1,
|
||||
stroke: 1pt,
|
||||
[*zgoščena vrednost*: `d934342ca420dd0d9828782c7103103f2922d2a6`],
|
||||
```
|
||||
100644 blob 76018072e09c5d31c8c6e3113b8aa0fe625195ca bar.txt
|
||||
100644 blob ba0e162e1c47469e3fe4b393a8bf8c569f302116 foo.txt
|
||||
040000 tree 3b8bfca88b2cc4127ce5909eb3a7395e8b5f2b6a podmapa
|
||||
```,
|
||||
),
|
||||
caption: [Primer posnetka direktorija v Gitu (objekt tipa `tree`). Posnetek vsebuje zgoščene vrednosti datotek in direktorija, ki jih vsebuje. Uporaba zgoščenih vrednosti natančno določa vsebino posnetka direktorija.],
|
||||
)
|
||||
#note[
|
||||
Skladišča objektov v Gitu je
|
||||
#link("https://en.wikipedia.org/wiki/Content-addressable_storage")[skladišče vsebinsko naslovljivih objektov].
|
||||
Dostop do objekta je mogoč, če poznamo *zgoščeno vrednost* njegove vsebine. Dejansko je referenca na
|
||||
posamezen objekt v Gitu preprosto zgoščena vrednost vsebine tega objekta. Poleg tega deluje zgoščena vrednost vsebine kot kontrolna vsota. To pomeni, da lahko enostavno preverimo verodostojnost vsebine, ki je shranjena v Gitu. Skladišče objektov je v direktoriju `.git/objects`.
|
||||
]
|
||||
== Zgodovinski graf sprememb
|
||||
Posamezni vnosi so povezani v *usmerjen acikličen graf* (angl. kratica *DAG*), ki ponazarja zgodovino sprememb.
|
||||
Vsak *vnos* je *vozlišče* v grafu in izhaja iz enega ali več starševskih vnosov. Izjema je prvi vnos.
|
||||
Skladišča objektov v Gitu je
|
||||
#link("https://en.wikipedia.org/wiki/Content-addressable_storage")[skladišče vsebinsko naslovljivih objektov].
|
||||
Dostop do objekta je mogoč, če poznamo *zgoščeno vrednost* njegove vsebine. Dejansko je referenca na
|
||||
posamezen objekt v Gitu preprosto zgoščena vrednost vsebine tega objekta. Poleg tega deluje zgoščena vrednost vsebine kot kontrolna vsota. To pomeni, da lahko enostavno preverimo verodostojnost vsebine, ki je shranjena v Gitu. Skladišče objektov je v direktoriju `.git/objects`.
|
||||
]
|
||||
== Zgodovinski graf sprememb
|
||||
Posamezni vnosi so povezani v *usmerjen acikličen graf* (angl. kratica *DAG*), ki ponazarja zgodovino sprememb.
|
||||
Vsak *vnos* je *vozlišče* v grafu in izhaja iz enega ali več starševskih vnosov. Izjema je prvi vnos.
|
||||
*Povezave* v grafu povezujejo vnose z njihovimi starši.
|
||||
|
||||
#figure(
|
||||
diagram(node-stroke: 1pt, node-shape: pill,
|
||||
{
|
||||
let (Ah, Bh, Ch, Dh, Eh, Fh, Gh) = ("d93434", "2ca420", "dd0d98", "28782c", "710310", "3f2922","d2a671")
|
||||
let (A, B, C, D, E, F, G) = ((0, 0), (1, 0), (2, 0), (3, 0), (4, 0), (2, 1), (3, 1))
|
||||
node(A, raw(Ah))
|
||||
node(B, raw(Bh))
|
||||
node(C, raw(Ch))
|
||||
node(D, raw(Dh))
|
||||
node(E, raw(Eh))
|
||||
node(F, raw(Fh))
|
||||
node(G, raw(Gh))
|
||||
edge(B, A, "->")
|
||||
edge(C, B, "->")
|
||||
edge(D, C, "->")
|
||||
edge(E, D, "->")
|
||||
edge(G, F, "->")
|
||||
edge(F, B, "->")
|
||||
edge(D, F, "->")
|
||||
|
||||
}
|
||||
),
|
||||
caption: [Vnosi v Gitu kot usmerjen graf. Vsak vnos(razen prvega) ima povezavo na vnose iz katerih izhaja.]
|
||||
diagram(node-stroke: 1pt, node-shape: pill, {
|
||||
let (Ah, Bh, Ch, Dh, Eh, Fh, Gh) = ("d93434", "2ca420", "dd0d98", "28782c", "710310", "3f2922", "d2a671")
|
||||
let (A, B, C, D, E, F, G) = ((0, 0), (1, 0), (2, 0), (3, 0), (4, 0), (2, 1), (3, 1))
|
||||
node(A, raw(Ah))
|
||||
node(B, raw(Bh))
|
||||
node(C, raw(Ch))
|
||||
node(D, raw(Dh))
|
||||
node(E, raw(Eh))
|
||||
node(F, raw(Fh))
|
||||
node(G, raw(Gh))
|
||||
edge(B, A, "->")
|
||||
edge(C, B, "->")
|
||||
edge(D, C, "->")
|
||||
edge(E, D, "->")
|
||||
edge(G, F, "->")
|
||||
edge(F, B, "->")
|
||||
edge(D, F, "->")
|
||||
}),
|
||||
caption: [Vnosi v Gitu kot usmerjen graf. Vsak vnos(razen prvega) ima povezavo na vnose iz katerih izhaja.],
|
||||
)
|
||||
|
||||
== Reference: veje in značke
|
||||
|
|
@ -99,8 +126,7 @@ Vsak *vnos* je *vozlišče* v grafu in izhaja iz enega ali več starševskih vno
|
|||
Poleg objektov kot so _vnosi_, _posnetki direktorijev_ in _posnetki datotek_ pozna Git še reference. Reference so kazalci z določenim imenom na posamezen vnos.
|
||||
|
||||
#figure(
|
||||
diagram(node-stroke: 0.5pt,
|
||||
{
|
||||
diagram(node-stroke: 0.5pt, {
|
||||
node((2, -1), [main], shape: chevron, name: <main>)
|
||||
node((-1, 0), [`e23d19`], shape: pill, name: <commit1>)
|
||||
node((0, 0), [`3943eb`], shape: pill, name: <commit2>)
|
||||
|
|
@ -112,21 +138,19 @@ Poleg objektov kot so _vnosi_, _posnetki direktorijev_ in _posnetki datotek_ poz
|
|||
edge(<commit4>, <commit3>, "->")
|
||||
edge(<main>, <commit4>, "->")
|
||||
edge(<tag>, <commit2>, "->")
|
||||
}
|
||||
),
|
||||
caption: [Veja (angl. branch) ali značka(angl. tag) je preprost kazalec na posamezen vnos(angl. commit). ]
|
||||
}),
|
||||
caption: [Veja (angl. branch) ali značka(angl. tag) je preprost kazalec na posamezen vnos(angl. commit). ],
|
||||
)
|
||||
|
||||
Referenc Git ne hrani v skladišču objektov, temveč posebej v direktoriju `.git/refs`. Zato so reference vezane na posamezen repozitorij in se lahko razlikujejo med različnimi kloni določenega repozitorija.
|
||||
Referenc Git ne hrani v skladišču objektov, temveč posebej v direktoriju `.git/refs`. Zato so reference vezane na posamezen repozitorij in se lahko razlikujejo med različnimi kloni določenega repozitorija.
|
||||
|
||||
*Veja* (angl. *branch*) je posebne vrste referenca, ki se premika, ko dodajamo nove vnose. Vsakič ko ustvarimo nov vnos, se trenutno aktivna veja premakne na novo ustvarjeni vnos.
|
||||
*Veja* (angl. *branch*) je posebne vrste referenca, ki se premika, ko dodajamo nove vnose. Vsakič ko ustvarimo nov vnos, se trenutno aktivna veja premakne na novo ustvarjeni vnos.
|
||||
|
||||
*Značka* (angl. *tag*) je referenca, ki je statična in se ne premika več, ko jo enkrat ustvarimo.
|
||||
|
||||
#figure(
|
||||
diagram(node-stroke: 0.5pt,
|
||||
{
|
||||
node((1, -1), [main], shape: chevron, name: <main-old>, stroke:(dash: "dotted"))
|
||||
diagram(node-stroke: 0.5pt, {
|
||||
node((1, -1), [main], shape: chevron, name: <main-old>, stroke: (dash: "dotted"))
|
||||
node((-1, 0), [`e23d19`], shape: pill, name: <commit1>)
|
||||
node((0, 0), [`3943eb`], shape: pill, name: <commit2>)
|
||||
node((1, 0), [`98ff21`], shape: pill, name: <commit3>)
|
||||
|
|
@ -139,22 +163,20 @@ Referenc Git ne hrani v skladišču objektov, temveč posebej v direktoriju `.gi
|
|||
edge(<main-old>, <commit3>, "->", stroke: (dash: "dotted"))
|
||||
edge(<tag>, <commit3>, "->")
|
||||
edge(<main>, <commit4>, "->")
|
||||
}
|
||||
),
|
||||
caption: [Ko ustvarimo nov vnos, se aktivna veja `main` premakne naprej, značka `v-1.0` pa ostane tam, kjer je bila. ]
|
||||
}),
|
||||
caption: [Ko ustvarimo nov vnos, se aktivna veja `main` premakne naprej, značka `v-1.0` pa ostane tam, kjer je bila. ],
|
||||
)
|
||||
|
||||
#note[
|
||||
Veje in značke nimajo v Gitu nobenega posebnega pomena, razen tega, da so reference na vnose. Pomen posamenznih vej je stvar dogovora med uporabniki. Tako se pogosto uporablja različne veje za različne namene: `main` ali `master` je navadno glavna veja razvoja, veje z imeni `stable`, `production`, `development` in podobno označujejo različne stopnje razvoja programske opreme, veje s predpono `feature-` označujejo razvoj novih funkcionalnosti.
|
||||
Veje in značke nimajo v Gitu nobenega posebnega pomena, razen tega, da so reference na vnose. Pomen posamenznih vej je stvar dogovora med uporabniki. Tako se pogosto uporablja različne veje za različne namene: `main` ali `master` je navadno glavna veja razvoja, veje z imeni `stable`, `production`, `development` in podobno označujejo različne stopnje razvoja programske opreme, veje s predpono `feature-` označujejo razvoj novih funkcionalnosti.
|
||||
|
||||
Vse te pomene damo vejam ljudje, ki sodelujemo v nekem Git repozitoriju. Za Git so vse veje in značke zgolj preprosti kazalci na določen vnos.
|
||||
Vse te pomene damo vejam ljudje, ki sodelujemo v nekem Git repozitoriju. Za Git so vse veje in značke zgolj preprosti kazalci na določen vnos.
|
||||
]
|
||||
|
||||
*HEAD* je posebna referenca, ki kaže na trenutno aktiven vnos. Vnos, na katerega kaže _HEAD_ bo starševski vnos naslednjeg vnosa, ki ga bomo dodali.
|
||||
|
||||
#figure(
|
||||
diagram(node-stroke: 0.5pt,
|
||||
{
|
||||
diagram(node-stroke: 0.5pt, {
|
||||
node((-1, 0), [`e23d19`], shape: pill, name: <commit1>)
|
||||
node((0, 0), [`3943eb`], shape: pill, name: <commit2>)
|
||||
node((1, 0), [`98ff21`], shape: pill, name: <commit3>)
|
||||
|
|
@ -169,9 +191,8 @@ Vse te pomene damo vejam ljudje, ki sodelujemo v nekem Git repozitoriju. Za Git
|
|||
edge(<index>, <commit4>, "->", stroke: (dash: "dotted"))
|
||||
edge(<head>, <commit3>, "->")
|
||||
edge(<main>, <commit3>, "->")
|
||||
}
|
||||
),
|
||||
caption: [*HEAD* je referenca na trenutno aktiven vnos/vejo.]
|
||||
}),
|
||||
caption: [*HEAD* je referenca na trenutno aktiven vnos/vejo.],
|
||||
)
|
||||
|
||||
== Delo z Git
|
||||
|
|
@ -187,11 +208,11 @@ Samostalniki:
|
|||
- *Zgoščena vrednost vnosa* (angl. *commit hash*) je 40-mestna heksadecimalna vrednost, izračunana s SHA-1, ki enolično identificira vnos na podlagi njegove vsebine.
|
||||
- *Veja* (angl. *branch*) je premična oznaka, ki kaže na določen vnos v zgodovini in se samodejno premakne naprej, ko dodajamo nove vnose. Veje omogočajo vzporedne razvojne linije z različnimi spremembami.
|
||||
- *Oznaka* (angl. *tag*) je statična oznaka, ki trajno kaže na določen vnos. Za razliko od veje se oznaka, nikoli ne premika samodejno, zato se uporablja predvsem za označevanje pomembnih točk v zgodovini, kot so izdaje ali stabilne verzije.
|
||||
- *Delovna kopija* (angl. *workout copy*) je direktorij v katerem urejamo datoteke, ki jih nato vnesemo v Git. V delovni kopiji imajo na začetku datoteke isto vsebino kot je vsebina trenutno aktivnega vnosa (`HEAD`). Spremembe, ki jih naaredimo na delovni kopiji lahko zabeležimo v nov vnos.
|
||||
- *Delovna kopija* (angl. *workout copy*) je direktorij v katerem urejamo datoteke, ki jih nato vnesemo v Git. V delovni kopiji imajo na začetku datoteke isto vsebino kot je vsebina trenutno aktivnega vnosa (`HEAD`). Spremembe, ki jih naaredimo na delovni kopiji lahko zabeležimo v nov vnos.
|
||||
- *Oddaljen repozitorij* (angl. *remote*) je povezava(url) na oddaljen repozitorij, s katerim izmenjujemo vsebino.
|
||||
|
||||
Glagoli (akcije):
|
||||
- *Checkout* prenese vsebino vnosa v delovno kopijo: `git checkout neka-veja`
|
||||
- *Checkout* prenese vsebino vnosa v delovno kopijo: `git checkout neka-veja`
|
||||
- *Commit* ustvari nov vnos: `git commit -m 'Sporočilo'`
|
||||
- *Add* doda vsebino, ki bo v naslednjem vnosu: `git add dodaj_me.txt`
|
||||
- *Pull* poberi vsebino iz oddaljenega repozitorija in uskladi lokalno vejo z oddaljeno: `git pull`
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue