O objetivo deste documento é descrever as peculiaridades que você pode encontrar ao contribuir devido à ferramenta que gerencia a cópia de origens de e para o repositório interno do Google. Essa ferramenta é chamada de Copybara.
Fonte interna da verdade
Como a fonte da verdade do código nesse repositório é o repositório interno do Google, o Copybara faz transformações no código sempre que ele é importado e exportado. Isso significa que, às vezes, mudanças aparentemente normais podem ocorrer internamente de maneiras surpreendentes.
Status da fusão de RP e inconsistências de diferenças
Como a fonte de verdade é interna, as RPs não são mescladas diretamente. Elas são importadas para o repositório interno do Google, onde passam por outros testes. Em seguida, essa mudança interna é enviada e atribuída ao autor da RP. Devido às transformações aplicadas ao Copybara, não há garantia de que a diferença será idêntica (por exemplo, a Copybara aplica formatação na importação).
Por esse motivo, a Copybara não marcará o PR como mesclado, ele o fechará e aplicará separadamente uma confirmação que precisa ser mapeada muito bem ao PR.
Dependência do TSL por cópia
Conforme implementado atualmente, para evitar confirmações temporárias interrompidas, o XLA
depende do TSL não fazendo o download de uma cópia usando o http_archive
do Bazel, mas
fazendo com que o Copybara copie a TSL no diretório third_party
do XLA.