Estranhos do Copybara

O objetivo deste documento é descrever peculiaridades que você pode encontrar ao contribuir devido à ferramenta que gerencia a cópia de origem do 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 PRs não são mescladas diretamente. Elas são importadas para o repositório interno do Google em que passam por mais testes. Depois, essa mudança interna é enviada e atribuída ao autor da RP. Devido às transformações aplicadas à Copybara, não há garantia de que a comparação será idêntica (por exemplo, a Copybara aplica formatação na importação).

Por esse motivo, o Copybara não marcará o PR como mesclado, ele o fechará e aplicará separadamente uma confirmação que precisa mapear muito de perto com o PR.

Dependência do TSL por cópia

Conforme implementado atualmente, para evitar confirmações temporárias temporárias, o XLA depende do TSL não fazendo o download de uma cópia usando o http_archive do Bazel, mas fazendo o Copybara copiar o TSL para o diretório third_party do XLA.