מוזרות קופיברה

מטרת המסמך הזה היא לתאר את הפרטים המוזרים שאתם עשויים להיתקל בהם במהלך הוספת התוכן, בגלל הכלי שמנהל את ההעתקה של המקור הלוך ושוב מהמאגר הפנימי של Google. הכלי הזה נקרא Copybara.

מקור האמת הפנימי

מכיוון שמקור האמת של הקוד במאגר הזה הוא המאגר הפנימי של Google, בכל פעם שמייבאים ומייצאים את הקוד, מתבצעת טרנספורמציות בקוד של Copybara. במילים אחרות, לפעמים שינויים שנראות נורמליים עלולים להשתבש באופן פנימי ומפתיע.

סטטוס מיזוג וחוסר עקביות של PR

מאחר שמקור האמת הוא פנימי, לא מתבצע מיזוג ישיר של אנשי יחסי הציבור, הם מיובאים למאגר הפנימי של Google ושם הם עוברים בדיקות נוספות. לאחר מכן, השינוי הפנימי נשלח ומיוחס למחבר יחסי הציבור. בגלל הטרנספורמציות ש-Copybara מחילה, לא מובטח שההבדלים יהיו זהים (לדוגמה, Copybara מחילים עיצוב על ייבוא).

מסיבה זו, Copybara לא תסמן את PR כמיזוג, היא תסגור את יח"צ ותחיל בנפרד התחייבות שצריך להיות ממופה קרוב מאוד ל-PR.

תלות ב-TSL לפי עותק

בהתאם להטמעה בשלב הזה, כדי למנוע ביצוע של פעולות פסולות זמניות, XLA תלוי ב-TSL לא בהורדת עותק באמצעות http_archive של Bazel, אלא על ידי העתקת מסמך ה-TSL של Copybara לספריית third_party של XLA.