Bu belgenin amacı, Google'ın dahili deposundan kaynak ileri veya 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 kod deposundaki kodun bilgi kaynağı Google'ın dahili deposu olduğundan, Copybara kod içe aktarılıp dışa aktarıldığında kodda dönüştürme işlemleri gerçekleştirir. Yani normal gibi görünen değişiklikler bazen dahilide ş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ırlar ve ek testlerden geçerler, daha sonra 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 sırasında 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 kaydetme uygular.
Kopya ile TSL'ye bağımlılık
Şu anda uygulanmakta olduğu gibi, geçici olarak bozulan kaydetme işlemlerini önlemek için XLA, TSL'ye bağımlıdır. Bunun için Bazel'ın http_archive
kullanarak bir kopya indirmez, bunun yerine TSL'nin TSL'yi XLA'nın third_party dizinine kopyalamasını sağlar.