7.1 Git Tools - Düzeltme Seçimi

Herhangi tek bir katkıyı 40 karakterlik tam bir SHA-1 karmasıyla (hash) gösterebilirsiniz, ancak katkıları daha insan dostu yollarla da belirtebilirsiniz. Bu bölüm, herhangi bir katkıyı belirtmek için kullanabileceğiniz çeşitli yolları açıklar.

Bir katkıyı belirtmek için SHA-1 karmasının ilk birkaç karakterini yazarsanız, yazdığınız karma en az dört karakter uzunluğunda ve belirsiz olmadığı sürece, Git hangi katkıya atıfta bulunduğunuzu anlayacak kadar akıllıdır. Başka bir deyişle, nesne veritabanında aynı önek ile başlayan başka bir nesne olmadığı müddetçe sorun yaşamazsınız.

Örneğin, belirli bir işlev eklediğinizi bildiğiniz bir katkıyı incelemek için, ilk önce git log komutunu çalıştırarak o katkıyı bulabilirsiniz:

Diyelim ki, SHA-1 özetinin 1c002dd... ile başladığı bir katkıyla ilgileniyorsunuz. Bu katkıyı incelemek için aşağıdaki git show çeşitlemelerinden herhangi birini kullanabilirsiniz (kısa versiyonların belirsiz olmadığı varsayılmaktadır):

Git, SHA-1 değerleriniz için kısa, benzersiz bir kısaltma bulabilir. git log komutuna --abbrev-commit seçeneğini eklerseniz, çıktı daha kısa değerler kullanacak ancak bunları benzersiz tutacaktır; SHA-1’in belirsiz olmaması (benzersiz olması) için, varsayılan olarak yedi karakter kullanır ancak bu onu daha uzun hale getirir:

Genellikle, bir projenin içinde benzersiz olması için sekiz ila on karakter yeterlidir. Örneğin, - Şubat 2019 itibarıyla 875.000’den fazla katkı ve neredeyse yedi milyon nesne içeren - oldukça büyük bir proje olan Linux çekirdeğinde, SHA-1’leri ilk 12 karakteri aynı olan hiçbir nesne bulunmuyor.

Belirli bir katkıya başvurmanın basit bir yolu, o dalın uç noktasındaki bir katkı olduğunda; bu durumda, bir katkı başvurusunu bekleyen herhangi bir Git komutunda sadece dal adını kullanabilirsiniz. Örneğin, bir daldaki son katkı nesnesini incelemek istiyorsanız, topic1 dalının ca82a6d... katkısına işaret ettiğini varsayarsak, aşağıdaki komutlar eşdeğerdir:

Bir dalın hangi SHA-1’e işaret ettiğini görmek istiyorsanız veya bu örneklerden herhangi birinin SHA-1’ler açısından neye denk geldiğini görmek istiyorsanız, rev-parse adlı bir Git aracını kullanabilirsiniz. Daha fazla bilgi için Git Internals adresine bakabilirsiniz; temelde, rev-parse daha düşük düzeyli işlemler için var ve günlük işlemlerde kullanılmak üzere tasarlanmamıştır. Ancak, bazen gerçekte ne olduğunu görmek gerektiğinde yardımcı olabilir. Burada dalınız üzerinde rev-parse çalıştırabilirsiniz.

Git’in arka planda çalışırken yaptığı şeylerden biri, "reflog" olarak adlandırılan, HEAD ve dal referanslarınızın son birkaç ay boyunca nerede olduğunu kaydettiği bir günlük tutmaktır.

Referans günlügünüzü git reflog komutunu kullanarak görebilirsiniz:

Herhangi bir nedenle dal ucu güncellendiğinde, Git bu bilgiyi geçici bir geçmişte sizin için saklar. Reflog verilerinizi eski katkılara başvurmak için de kullanabilirsiniz. Örneğin, repo ucunuzun beş önceki değerini görmek istiyorsanız, reflog çıktısında gördüğünüz @{5} referansını kullanabilirsiniz:

Bu sözdizimini ayrıca bir dalın belirli bir süre önce nerede olduğunu görmek için de kullanabilirsiniz. Örneğin, master dalınızın dün nerede olduğunu görmek için şunu yazabilirsiniz:

Bu, master dalınızın ucunun dün nerede olduğunu gösterir. Bu teknik, hala referans günlüğünüzde olan veriler için çalışır, bu nedenle birkaç aydan daha eski katkıları aramak için kullanamazsınız.

git log çıktısı gibi biçimlendirilmiş referans günlüğü bilgilerini görmek için git log -g komutunu çalıştırabilirsiniz:

Reflog bilgilerinin kesinlikle yerel olduğunu bilmelisinizi - yalnızca sizin kendi reponuzda yaptığınız işlemlerin günlüğüdür. Referanslar, başkasının repo kopyasında aynı olmayacaktır; ayrıca bir repoyu başlangıçta klonladıktan hemen sonra, henüz repoda herhangi bir etkinlik olmadığından boş bir referans günlüğünüz olacaktır. git show HEAD@{2.months.ago} komutunu çalıştırmak; eğer projeyi en az iki ay önce kopyaladıysanız, yalnızca eşleşen katkıyı gösterecektir; eğer bundan daha yeni bir tarihte kopyaladıysanız, yalnızca ilk yerel katkınızı göreceksiniz.

Başka bir katkıyı belirtmenin ana yolu, onun kökenidir. Bir referansın sonuna bir ^ (caret) işareti koyarsanız, bunun Git’te temsil ettiği şey, o katkının öncelidir. Projenizin geçmişine bir göz atarsanız:

Ardından, HEAD^ belirterek önceki katkıyı görebilirsiniz, bu da "HEAD’in önceli" anlamına gelir:

Kaçıncı önceli istediğinizi belirtmek için ^ karakterinin hemen ardından bir sayı belirtebilirsiniz: örneğin, d921970^2, "d921970’nin ikinci önceli" anlamına gelir. Bu sözdizimi, birden fazla önceli olan birleştirme katkıları için yararlıdır: bir birleştirme katkısının ilk önceli, birleştirdiğinizde üzerinde bulunduğunuz dalın (genellikle master) olduğu dal, bir birleştirme katkısının ikinci önceli ise birleştirilen dalın (örneğin, topic) olduğu daldır:

Diğer ana soy belirteci de ~ (tilde) karakteridir. Bu da ilk öncele atıfta bulunur, bu yüzden HEAD~ ve HEAD^ eşdeğerdir. Fark, bir sayı belirttiğinizde ortaya çıkar. HEAD~2, "ilk öncelin önceli" veya "ikinci öncel" anlamına gelir - belirttiğiniz sayı kadar birinci önceli geçer. Örneğin, önceki listede, HEAD~3 şöyle olurdu:

Bu, HEAD~~~ olarak da yazılabilir, yani yine ilk öncelin ilk öncelidir.

Bu sözdizimlerini birleştirebilirsiniz: (bir birleştirme katkısı olduğunu varsayarsak) önceki referansın ikinci önceline HEAD~3^2 kullanarak ulaşabilirsiniz, vs.

Şimdi tek tek katkıları belirtebildiğimize göre, katkı aralıklarını nasıl belirleyeceğimizi görelim. Özellikle dallarınızı yönetmek için oldukça kullanışlı bir yöntemdir: eğer birçok dalınız varsa, aralık belirlemelerini kullanarak "Bu dalda, henüz ana dalıma birleştirmediğim hangi işler var?" gibi soruları yanıtlayabilirsiniz.