A ideia#
Uma edição é um lote: uma lista de operações, cada uma um comando nomeado, como track.add ou item.move, com seus argumentos. O lote inteiro é aplicado ou nada é, e ele vira uma revisão e um passo de desfazer.
Todo lote informa a base_revision contra a qual foi planejado. Se o projeto avançou, o núcleo tenta reaplicar o seu lote sobre as revisões mais novas. Quando as mudanças se sobrepõem, ele responde E_REVISION_CONFLICT com um diff em texto do que mudou, para que você leia e planeje de novo.
Início rápido#
- Leia a revisão:
project_get, ou arevisiondo resultado da sua última edição. - Envie o lote com essa
base_revision. Dê o seu próprioida uma faixa ou item novo quando uma operação posterior do mesmo lote se referir a ele. - Use
dry_run: truepara conferir um lote sem salvá-lo. - Use uma
idempotency_keyquando puder repetir: a mesma chave com o mesmo lote devolve o primeiro resultado, comreplayed: true. A mesma chave com um lote diferente éE_IDEMPOTENCY_MISMATCH.
As operações estão no catálogo de comandos.
Erros comuns#
- Enviar uma
base_revisionà frente do projeto:E_VALIDATION. - Repetir um conflito sem mudar nada. Leia o diff antes.