Changebara'nın ilginç kolları

Bu belgenin amacı, Google'ın dahili deposundan kaynak ileri ve geri kopyalamayı yöneten araç nedeniyle, katkıda bulunurken karşılaşabileceğiniz tuhaflıkları açıklamaktır. Bu araca Copybara adı verilir.

Dahili veri kaynağı

Bu depodaki kodun doğru kaynağı Google'ın dahili deposudur. Bu nedenle Copybara, kod içe ve dışa aktarıldığında kodda dönüşüm işlemleri gerçekleştirir. Yani, normal gibi görünen değişiklikler bazen şirket içinde şaşırtıcı şekillerde bozulabilir.

PR birleştirme durumu ve farklılık tutarsızlıkları

Bilgilerin kaynağı dahili olduğundan, PR'ler doğrudan birleştirilmez. Google'ın dahili deposuna aktarılır ve ek testlerden geçer, ardından bu dahili değişiklik gönderilir ve PR yazarına atanır. Copybara'nın uyguladığı dönüştürmeler nedeniyle farkın aynı olacağının garantisi yoktur (örneğin, Copybara içe aktarma işlemine biçimlendirme uygular).

Bu nedenle, Copybara, PR'yi birleştirilmiş olarak işaretlemez, PR'yi kapatır ve ayrıca, PR ile çok yakından eşleşmesi gereken bir taahhüt uygular.

Kopya ile TSL'ye bağımlılık

Şu anda uygulandığı üzere XLA, geçici olarak bozulan kaydetme işlemlerini önlemek için TSL'ye bağlıdır. Bunun için XLA'nın bir kopyasını Bazel'in http_archive yöntemi ile indirmesi değil, Copybara'nın TSL'yi XLA'nın third_party dizinine kopyalaması gerekir.