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.
- Limiar de cobertura: suas alterações fazem com que a cobertura de código fique abaixo de um mínimo exigido ou façam com que a cobertura de código caia mais do que o permitido em relação à branch 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 linha de 22,0% está abaixo do mínimo de 50,0%": a cobertura de linha no branch do pull request está abaixo do percentual mínimo de cobertura de linha definido no conjunto de regras.
- "A cobertura de linha diminuiu em 2,5%, a queda máxima permitida é de 1,0%": as alterações fizeram com que a cobertura de linha 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 linhas da base de código sejam executadas:
- 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 linha. 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.