8.2 Prilagoditev Gita - Atributi Git

Eden izmed trikov, za katerega lahko uporabite atribute Git, je naročiti Gitu, katere datoteke so binarne (v primerih, ko morda ne more ugotoviti sam) in mu dati posebnih navodil o tem, kako s takimi datotekami ravnati. Na primer, nekatere besedilne datoteke so lahko strojno generirane in jih ni mogoče razlikovati, medtem ko je mogoče nekatere binarne datoteke razlikovati. Pokazali vam bomo, kako Gitu naročiti, katera vrsta datoteke je katera.

Stil razširjanja ključnih besed SVN ali CVS pogosto zahtevajo razvijalci, ki so navajeni teh sistemov. Glavni problem pri tem v Gitu je, da datoteke z informacijami o potrditvi ne morete spreminjati po tem, ko ste jih že potrdili, ker Git najprej preveri kontrolne vsote datoteke. Vendar pa lahko v datoteko vstavite besedilo, ko jo izpišete, in ga pred dodajanjem k potrditvi spet odstranite. Atributi Git vam ponujajo dva načina za to.

Najprej lahko samodejno vstavite kontrolno vsoto SHA-1 bloba v polje $Id$ v datoteki. Če to lastnost nastavite na datoteko ali sklop datotek, bo Git naslednjič, ko izvlečete tisto vejo, to polje nadomestil s SHA-1 bloba. Pomembno je opozoriti, da to ni SHA-1 potrditve, ampak SHA-1 samega bloba. V datoteko .gitattributes vnesite naslednjo vrstico:

Testni datoteki dodajte referenco $Id$:

Naslednjič, ko boste izvlekli to datoteko, bo Git injiciral SHA-1 bloba:

Vendar pa je ta rezultat omejenega pomena. Če ste uporabljali zamenjavo ključnih besed v CVS ali Subversion, lahko vključite datumski žig — SHA-1 ni v veliko pomoč, ker je dokaj naključen in ga ni mogoče razlikovati po starosti le z gledanjem nanj.

Izkaže se, da lahko napišete lastna filtra za zamenjave v datotekah ob potrditvi/izvleku. Ta se imenujeta filtra »clean« in »smudge«. V datoteki .gitattributes lahko nastavite filter za določene poti in nato nastavite skripte, ki bodo obdelali datoteke, tik preden jih izvlečete (za »smudge« poglejte sliko Filter »smudge« se požene pri izvleku) in tik preden jih shranite (za »clean« poglejte sliko Filter »clean« se požene, ko so datoteke v področju priprave). Te filtre lahko nastavite, da naredijo vse vrste zabavnih stvari.

Izvirno sporočilo potrditve za to funkcionalnost podaja preprost primer, kako poganjati vse svoje izvorne datoteke C skozi program indent pred potrditvijo. Nastavite lahko atribute filtra v datoteki .gitattributes za filtriranje datotek \*.c s filtrom »indent«:

Nato povejte Gitu, kaj filter »indent« naredi pri razmazovanju (angl. smudge) in čiščenju (angl. clean):

V tem primeru, ko shranite datoteke, ki se prilegajo *.c, bo Git te datoteke pred področjem priprave poslal skozi program indent in nato skozi program cat, preden jih znova izvleče nazaj na disk. Program cat v bistvu ne naredi ničesar: izpiše enake podatke, kot jih prejme. Ta kombinacija učinkovito filtrira vse izvorne datoteke C skozi indent pred potrjevanjem.

Še en zanimiv primer je vstavljanje ključne besede $Date$ v slogu RCS. Za pravilno izvedbo tega potrebujete majhen skript, ki vzame ime datoteke, ugotovi datum zadnje opravljene potrditve za ta projekt in vstavi datum v datoteko. Tu je kratek skript Ruby, ki to opravi:

Vse, kar skript naredi, je, da iz ukaza git log prebere zadnji datum potrditve in ga vstavi v vse nize $Date$ na stdin, nato pa izpiše rezultate — to bi moralo biti enostavno storiti v katerem koli jeziku, v katerem se najbolje počutite. Datoteko lahko poimenujete expand_date in jo postavite v svojo pot. Zdaj morate v Gitu nastaviti filter (poimenujte ga dater) in mu povedati, naj uporabi vaš filter expand_date za razmazovanje datotek pri izvleku. Za čiščenje tega na potrditvi boste uporabili regularni izraz Perl:

Ta del kode Perl odstrani vsebino niza $Date$, da se vrnete na izhodiščno stanje. Ko je filter pripravljen, ga lahko preizkusite z nastavitvijo atributa Git za datoteko, ki vključi nov filter, in ustvarite datoteko z vašo ključno besedo $Date$:

Če potrdite te spremembe in ponovno izvlečete datoteko, boste videli, da je bila beseda pravilno nadomeščena:

Vidite, kako zmogljiva tehnika je lahko ta pristop za prilagojene aplikacije. Vendar morate biti previdni, saj se datoteka .gitattributes potrdi in se prenaša s projektom, medtem ko gonilnika (v tem primeru dater) ni, zato ne bo deloval povsod. Ko načrtujete te filtre, morate narediti, da elegantno odpovejo izvedbo in projekt bi moral še vedno pravilno delovati.

Podatki atributov v Gitu vam omogočajo tudi izvajanje zanimivih operacij pri izvozu arhiva vašega projekta.

Atribute Git pa lahko tudi uporabite, da Gitu sporočite, naj za določene datoteke v svojem projektu uporabi različne strategije združevanja. Ena zelo uporabna možnost je, da Gitu sporočite, naj pri konfliktih ne poskuša združevati določenih datotek, ampak naj raje uporabi vašo stran združevanja pred drugimi.

To je koristno, če se je veja v vašem projektu razšla ali specializirala, vi pa želite združiti spremembe nazaj vanjo, hkrati pa želite prezreti določene datoteke. Recimo, da imate datoteko z nastavitvami podatkovne baze imenovano database.xml, ki se razlikuje v dveh vejah, in želite združiti spremembe iz druge veje, ne da bi pokvarili podatkovno datoteko. To lahko nastavite z atributom, kot je ta:

In nato definirate navidezno strategijo združevanja ours:

Če združite drugo vejo, boste videli nekaj takega, namesto da imate v datoteki database.xml konflikte združevanja:

V tem primeru ostane database.xml na katerikoli različici, ki ste jo prvotno imeli.