Validando com check

Execute buildprint check antes de cada buildprint apply. O check valida as alterações pendentes no workspace em relação às regras de sistema de arquivos, esquema, referência, workflow, expressão, layout e project-test do Buildprint.

buildprint check

Escopo padrão

Por padrão, o check compara o workspace com o snapshot atual do Bubble para o branch e valida os arquivos alterados. Arquivos de canvas alterados são expandidos para a raiz de canvas relevante para que as relações de elementos e workflows possam ser verificadas em contexto.

No momento, não há uma flag para todos os arquivos. Para satisfazer o buildprint apply, execute o comando sem filtros:

buildprint check

Um check sem filtros bem-sucedido registra um "fingerprint" de atualização para a baseline atual do Bubble e as alterações pendentes atuais. O apply usa esse registro para garantir que nada mudou após o check.

Segmentar caminhos específicos

Você pode verificar caminhos específicos do workspace enquanto edita:

buildprint check pages/home/page.json
buildprint check pages/home/elements/card
buildprint check tests/smoke/checkout.json

Diretórios incluem os arquivos abaixo deles. Verificações de caminho explícito ignoram as regras de todo o workspace e não registram o marcador de atualização exigido pelo apply. Use verificações segmentadas para uma iteração rápida e, em seguida, execute o buildprint check simples antes de aplicar.

Formatação JSON e correções automáticas

O check formata os arquivos JSON alterados antes de executar as regras. Se a formatação canônica alterou um arquivo, o relatório incluirá essa informação de autofix. Analise o git diff após o check se quiser ver as alterações do formatador.

Filtrando regras

buildprint check --rule canonical-form
buildprint check --rule 'children-manifest/*'
buildprint check --level warning --json

• --rule <id> executa apenas uma regra com o ID exato ou um padrão de prefixo terminando em /*.

• --level <error|warning|info> controla a severidade mínima impressa. O padrão é info.

• --json imprime o relatório como JSON.

Checks filtrados por regras são úteis para depuração, mas não satisfazem a atualização do apply.

Dicas de esquema de expressão

Quando o check encontra problemas relacionados a expressões, ele pode gravar um artefato de dicas de esquema de expressão e imprimir o caminho do artefato. Use esse arquivo para inspecionar os formatos de expressão esperados enquanto corrige o problema.

Aplicar automaticamente

buildprint check --auto-apply

--auto-apply executa o apply imediatamente quando o check sem filtros não apresenta problemas de nível de erro bloqueadores. Avisos e descobertas de informações não bloqueiam o auto-apply.

--auto-apply não pode ser combinado com --rule, --json ou caminhos explícitos.

Comportamento de saída

Se o check encontrar qualquer problema de nível de erro, ele sairá com um código diferente de zero e imprimirá Check failed: errors present. Corrija os arquivos relatados, execute novamente o buildprint check e, em seguida, aplique.

Se não houver arquivos alterados, o check imprime No changed files. No checks run. e o --auto-apply ignora o apply.