Entendendo por que sua solicitação de pull está bloqueada
Os administradores do repositório e os proprietários da organização podem definir portões de qualidade usando GitHub Code Quality. Ao abrir uma solicitação de pull, as verificações são executadas automaticamente para avaliar suas alterações em relação a esses padrões.
Há dois tipos de blocos:
- Descobertas de qualidade de código: suas alterações introduzem problemas que estão abaixo do limite de qualidade necessário.
-
**Limite de cobertura**: as alterações fazem com que a cobertura de código fique abaixo de um mínimo necessário ou façam com que a cobertura caia mais do que o permitido em relação à ramificação padrão.
Essas verificações ajudam a manter uma base de código íntegra e mantenedível e impedem que a dívida técnica se acumule.
Resolvendo um bloqueio por problemas de qualidade de código
Se o seu pull request introduzir código que fique abaixo do limite de qualidade exigido, você verá um aviso de bloqueio de mesclagem na parte inferior do pull request, na seção "Checks": "A mesclagem está bloqueada: foram detectados problemas de qualidade de código."
O portão de qualidade definido pelo administrador do repositório ou pelo proprietário da organização define o nível mínimo de severidade que bloqueará a mesclagem. Todos os resultados nesse nível de gravidade ou superior devem ser corrigidos ou descartados para que você possa mesclar. Se o banner de bloqueio de merge não especificar um nível de severidade, seu repositório exige que todos os resultados sejam tratados.
Para desbloquear a pull request, você precisa corrigir ou dispensar os resultados que atendam a ou excedem a gravidade do bloqueio:
- Revise os comentários deixados por
github-code-quality[bot]no seu pull request. Cada comentário é rotulado por severidade (Erro, Aviso, Observação). - Corrija ou ignore as conclusões relevantes. Para obter instruções detalhadas, confira Corrigindo descobertas de qualidade de código em uma solicitação de pull.
- Verifique se o banner de bloqueio de merge não está mais presente na seção "Verificações" do seu pull request.
Como resolver um bloqueio de limite de cobertura
Se a pull request for bloqueada por uma regra de limite de cobertura, você verá uma faixa de bloqueio de mesclagem na seção "Verificações", com uma mensagem descrevendo qual limite não foi atingido. Por exemplo:
- "A cobertura de 22,0% está abaixo do mínimo de 50,0%": a cobertura da ramificação de pull request está abaixo da porcentagem de cobertura mínima configurada no conjunto de regras.
- "A cobertura diminuiu em 2,5%, a queda máxima permitida é de 1,0%": as alterações fizeram com que a cobertura caísse mais do que o valor permitido em relação ao branch padrão.
Para desbloquear sua solicitação de pull, você precisa adicionar ou modificar testes para que mais da base de código seja executada:
- Examine o comentário de resumo de cobertura em sua solicitação de pull para identificar quais arquivos ou áreas não têm cobertura.
- Adicione ou atualize testes para aumentar a cobertura de execução. Copilot pode ajudá-lo a escrever e atualizar seus testes. Confira Como testar o código.
- Salve as alterações. A verificação de cobertura será executada novamente automaticamente.