هدف این سند توصیف موارد عجیب و غریبی است که ممکن است هنگام مشارکت به دلیل ابزاری که منبع کپی کردن از مخزن داخلی Google را مدیریت میکند، ببینید. این ابزار Copybara نام دارد.
منبع درونی حقیقت
از آنجایی که منبع صحت کد موجود در این مخزن، مخزن داخلی گوگل است، Copybara هر زمان که کد وارد و صادر شود، تغییراتی را در کد انجام می دهد. این بدان معنی است که گاهی اوقات تغییرات به ظاهر طبیعی می توانند به روش های شگفت انگیزی در درون خود شکسته شوند.
وضعیت ادغام روابط عمومی و تناقضات متفاوت
از آنجایی که منبع حقیقت داخلی است، PR ها مستقیماً ادغام نمی شوند، آنها به مخزن داخلی Google وارد می شوند، جایی که تحت آزمایش های اضافی قرار می گیرند، و سپس آن تغییر داخلی ارائه می شود و به نویسنده روابط عمومی نسبت داده می شود. به دلیل تغییراتی که Copybara اعمال میکند، هیچ تضمینی وجود ندارد که تفاوت یکسان باشد (به عنوان مثال، Copybara قالببندی را هنگام واردات اعمال میکند).
به همین دلیل، Copybara روابط عمومی را بهعنوان ادغام شده علامتگذاری نمیکند، PR را میبندد و به طور جداگانه یک commit را اعمال میکند که باید بسیار نزدیک به PR نگاشت شود.
وابستگی به TSL با کپی
همانطور که در حال حاضر پیاده سازی شده است، برای جلوگیری از هر گونه تعهد شکسته موقت، XLA به TSL وابسته است نه با دانلود یک کپی با استفاده از http_archive
Bazel، بلکه با کپی کردن Copybara TSL در دایرکتوری third_party
XLA.