Keunikan Copybara

Tujuan dokumen ini adalah untuk menjelaskan keanehan yang mungkin Anda lihat saat berkontribusi karena alat yang mengelola penyalinan sumber bolak-balik dari repositori internal Google. Alat ini disebut Copybara.

Sumber kebenaran internal

Karena sumber tepercaya untuk kode dalam repositori ini adalah repositori internal Google, Copybara akan melakukan transformasi ke kode setiap kali kode diimpor dan diekspor. Artinya, perubahan yang tampak normal terkadang dapat rusak secara internal dengan cara yang tidak terduga.

Status penggabungan PR dan inkonsistensi perbedaan

Karena sumber tepercaya bersifat internal, PR tidak digabungkan secara langsung, PR diimpor ke repo internal Google tempat PR menjalani pengujian tambahan, lalu perubahan internal tersebut dikirimkan, dan diatribusikan ke penulis Humas. Karena transformasi yang diterapkan oleh Copybara, tidak ada jaminan bahwa perbedaan tersebut akan sama (misalnya, Copybara menerapkan pemformatan saat proses impor).

Karena alasan ini, Copybara tidak akan menandai PR sebagai gabungan, tetapi akan menutup PR dan secara terpisah menerapkan commit yang seharusnya dipetakan sangat dekat dengan PR.

Dependensi pada TSL oleh salinan

Seperti yang diterapkan saat ini, untuk mencegah commit sementara yang rusak, XLA bergantung pada TSL, bukan dengan mendownload salinan menggunakan http_archive Bazel, tetapi dengan meminta Copybara menyalin TSL ke direktori third_party XLA.