Este artigo fornece definições para as métricas e pontuações usadas por Code Quality.
Você pode ver os resultados baseados em regras para o repositório na guia Security and quality, na guia Descobertas padrão em " Qualidade do código".
Definições de Métrica
A tabela a seguir fornece definições para cada métrica relatada para seu repositório.
| Métrica | Definition | Descobertas de exemplo |
|---|---|---|
| Reliability | Avalie se o código executa a função pretendida corretamente, previsível e consistentemente. O código confiável é livre de bugs (erros), lida com erros com segurança e opera conforme o esperado em condições normais e de limite. | Problemas com desempenho, simultaneidade, tratamento de erros, correção |
| Facilidade de manutenção | Avalie como é fácil entender, modificar e estender o código ao longo do tempo. O código mantenedível segue as práticas recomendadas, evita a complexidade desnecessária e é organizado para facilitar as alterações futuras e a colaboração. | Código não utilizado/morto, legibilidade, complexidade, nomenclatura conflitante, separação ruim de preocupações |
Níveis de severidade
Os níveis de gravidade são usados para indicar o impacto potencial ou a urgência de uma descoberta de qualidade de código. Eles ajudam os usuários a priorizar os esforços de correção e comunicar riscos aos stakeholders. A gravidade é determinada pela regra que detectou o problema, seguindo as convenções de CodeQL e padrões do setor.
| Severity | Definition |
|---|---|
| Error | Indica um problema de alta gravidade que provavelmente causará bugs, falhas ou principais riscos de manutenção. |
| Aviso | Indica um problema de gravidade moderada que pode afetar a qualidade ou a confiabilidade do código, mas não é imediatamente crítico. |
| Observação | Indica um problema de baixa gravidade, um pequeno aprimoramento ou uma recomendação. Essas descobertas são úteis para a integridade e a manutenção contínuas do código. |
Definições de pontuação
Esses escores são usados para resumir a confiabilidade geral e a manutenibilidade de um repositório com base na gravidade dos resultados baseados em regras encontrados por verificações CodeQL de toda a branch padrão:
| Pontuações | Definition | Critérios (com base em descobertas) |
|---|---|---|
| Excelente | O Codebase demonstra as melhores práticas de confiabilidade e manutenção. | Nenhuma descoberta de qualidade de código detectada |
| Boa | A base de código tem problemas de baixa gravidade ou pequenas melhorias são sugeridas. | ≥1 conclusão de nível "Nota" |
| Razoável | O Codebase tem problemas de gravidade moderada que podem afetar a qualidade, mas não são críticos. | ≥1 conclusão de nível "Aviso" |
| Pobre | O Codebase tem problemas de alta gravidade, incluindo bugs ou principais riscos de manutenção. | ≥1 conclusão de nível "Erro" |
Cobertura de código
Para obter detalhes sobre como Code Quality mede e relata a cobertura de código, consulte Code coverage reference.