Tudo o que faz, tudo o que pode ajustar

Quando foi uma IA a escrever os testes

A cobertura perante uma suíte de testes gerada

A visão geral apresenta o argumento genérico. Aqui está ele aplicado à própria lista de funcionalidades, porque uma suíte gerada falha com um formato característico — cada linha tocada, metade das decisões nunca tomadas e algumas funções nomeadas nos títulos dos testes mas nunca realmente chamadas — e cinco dos pontos abaixo são exatamente o que torna esse formato visível.

• A cobertura de ramos e MC/DC, com o detalhe por arco e por decisão ao passar o cursor, separa a linha correu de a decisão foi exercitada. Uma suíte que só percorre o caminho feliz marca perto de 100% em linhas e perto de 50% em ramos, e é essa diferença o achado. Uma execução de testes toda verde não mostra nada disso.
• A pontuação composta é uma média harmónica, pelo que uma métrica forte não consegue mascarar uma fraca — exatamente a aritmética de que uma suíte gerada precisa. Fazer a média do número das linhas com o dos ramos enterraria o único número que vale a pena olhar.
• Os avisos de código morto criam uma entrada no painel Problems para qualquer função com linhas mensuráveis e cobertura zero. Uma suíte que nomeia uma função no título de um teste e nunca lá chega não falha em mais lado nenhum.
• A cobertura de diff face a uma ref base do git estreita tudo o que ficou dito às linhas que acabaram de mudar — o código que aceitou esta tarde, e não a média de toda a vida do repositório, com a qual uma suíte grande já existente continuará alegremente a parecer saudável.
• Copy Uncovered Lines devolve exatamente o que nunca correu, em Markdown — ou seja, algo que se cola diretamente de volta ao assistente que escreveu a suíte em primeiro lugar.

Nada disto lê um teste e o julga, e nada aqui deve ser entendido como essa pretensão: um teste sem uma única asserção continua a cobrir todas as linhas que toca. O que se mede é a parte que um revisor não consegue guardar na cabeça — que código nunca foi executado.

Único nesta extensão

A sua cobertura de linhas diz 100%. 312 bytes do seu binário nunca foram executados.

Todas as outras métricas aqui são medidas a partir do código-fonte: instrumentar o código, correr a compilação instrumentada, contar o que disparou. A cobertura de código objeto mede algo que nenhuma ferramenta baseada no código-fonte consegue alcançar — quanto do binário construído foi realmente executado, em bytes de instruções, observando o fluxo de instruções. Um compilador produz código que nenhuma linha do seu código-fonte justifica: verificações de limites de arrays, tabelas de salto de switch, despejos de registos, rotinas de execução para divisão ou vírgula flutuante. Nada disso aparece no seu código-fonte, pelo que nenhuma ferramenta baseada no código-fonte — incluindo esta extensão, para qualquer outra métrica que leia — consegue dizer se foi executado. É também a única métrica aqui que responde a isto cobre assembly?, já que o assembly escrito à mão nunca é instrumentado.

A DO-178C nomeia-o explicitamente: no nível A é exigido além do MC/DC. Nenhuma outra extensão do VS Code o lê. Como obtê-lo de um alvo embutido →

Capacidades

Funcionalidades principais

• Uma vista Cobertura de cada ficheiro medido, a régua de visão geral e o Annotated Source; na própria margem do editor, por predefinição, só o que merece uma marca — barras MC/DC, triângulos de desde-a-última-execução, pontos de linhas editadas — com barras apenas nas linhas não cobertas ou um mapa de calor de contagens de acertos a uma definição de distância.
• Cobertura por linha de instruções, ramos, funções, regiões, MC/DC e instanciações C++, consoante o que o ficheiro de trace fornecer.
• Ingestão multiformato e combinação determinística de várias execuções com proveniência registada.
• Remapeamento de caminhos — caminhos da máquina de build de CI → o seu espaço de trabalho local.
• Cobertura diferencial — decora apenas as linhas alteradas em relação a uma referência base do git.
• Emblemas do Explorer e um item de barra de estado global, colorido de acordo com a pontuação composta.
• Modo de vigilância — recarregamento automático quando um ficheiro de trace muda.
• Run Tests with Coverage — reconhece o executor de testes a partir da raiz do espaço de trabalho e executa-o com cobertura ligada, carregando o que escreve.
• Ficheiros de cobertura remotos — uma entrada de coverageFile.paths pode ser um URL https://: o artefacto de CI é descarregado condicionalmente (ETag / Last-Modified), com os cabeçalhos que configurar em remote.headers, carregado como um ficheiro local e voltado a descarregar por temporizador com remote.refreshMinutes; quando uma descarga falha, é carregada a última cópia descarregada.
• Variáveis nos caminhos — ${workspaceFolder}, ${workspaceFolderBasename}, ${userHome}, ${env:NAME}, ${command:id} e ${config:section.key} em todas as definições de caminho; uma variável desconhecida fica tal como foi escrita, pelo que uma gralha aparece no registo de deteção em vez de desaparecer.
• Espaços de trabalho multi-raiz — cada pasta é detetada a partir das suas próprias definições (o seu .vscode/settings.json ou a sua entrada no .code-workspace), os seus ficheiros de cobertura fundem-se numa só execução, a vista Cobertura agrupa os ficheiros por pasta, e uma pasta adicionada ou removida recarrega a cobertura por si.
• Mais dois gatilhos de recarregamento — uma entrada absoluta de coverageFile.paths fora do espaço de trabalho é sondada, pelo que um ficheiro que aí apareça é carregado; e watch.reloadAfterTasks nomeia tarefas (npm: test) cujo fim recarrega a cobertura, esteja ou não o modo de vigilância ligado.
• Progresso que pode cancelar — um carregamento de dez ou mais ficheiros de cobertura, ou de 8 MB ou mais deles, e cada Generate Full HTML Report correm sob uma notificação de progresso com um botão Cancelar; cancelar deixa a execução anterior carregada.
• A própria vista Test Coverage do VS Code — cada carregamento é também publicado através da API Test Coverage do editor (testCoverage.publish), pelo que o painel de cobertura do Test Explorer, as percentagens por ficheiro do Explorador e o botão Show Inline Coverage do editor mostram os mesmos números; Show in Test Coverage View publica a pedido e abre o painel. Com testes nomeados (TN: no lcov), a vista filtra a cobertura de um ficheiro por teste.
• Regra de remapeamento sugerida — quando um carregamento deixa ficheiros sem correspondência (caminhos de contentor ou de CI contra um checkout local), a extensão infere a regra de pathRemap que explica o maior número deles, oferece Apply Suggested Remap no resultado do carregamento e Suggest Path Remap Rule na paleta; nada é escrito sem o clique.
• Globs de exclusão — fuciniCoverage.ignore (vendor/**, **/*.generated.ts) retira ficheiros inteiros da execução ao carregar, pelo que cada vista, gate e exportação conta sem eles; o resultado do carregamento diz quantos e a saída nomeia cada um.
• Não medido versus não coberto — um ficheiro que nenhum teste carregou não é pontuado como 0% nas suas costas; a barra de estado diz not measured para um deles, e unmeasured.mode pode listar esses ficheiros na vista Cobertura ou contar cada um como um ficheiro não coberto, com threshold.unmeasuredFiles para controlar quantos há.
• O que a fusão fez, visível — com vários tracefiles carregados, cada linha de ficheiro nomeia o relatório de onde vêm os seus números, o distintivo tem contorno onde esses números sobrepuseram um relatório mais antigo, cada linha de tracefile conta quantos dos seus ficheiros foram sobrepostos ou sobrepuseram outros, e clicar numa linha de tracefile realça os seus ficheiros na árvore (coverageView.mergedMarks).

Pontuação composta e conformidade

Uma única média harmónica ponderada sobre linhas, ramos, funções, regiões, MC/DC e instanciações. Por ser uma média harmónica, uma métrica fraca não pode ser mascarada por uma perfeita. Os pesos são alinhados por predefinição com os níveis IEC 61508 / ISO 26262 / DO-178C, e o veredito COMPLIANT / NON-COMPLIANT é determinado por limiares por métrica mais um modo configurável.

Screenshot pending — add assets/img/statusbar.png (see SCREENSHOTS.md).

Análise no editor

• CodeLens de função — % de cobertura por função, clique para saltar para a sua primeira linha não coberta.
• Informação de ramos e MC/DC ao passar o cursor — contagens tomadas/não tomadas por ramo e detalhes de condição/vetor por decisão; indicador de margem MC/DC colorido opcional.
• Avisos de código morto — aviso no painel Problems para funções com linhas mensuráveis e cobertura zero.
• Navegação Next/Previous Uncovered.
• Aviso de discrepância quando o conteúdo de um ficheiro já não se ajusta à sua execução — atualizado ao gravar ou ao mudar no disco, com a diferença exata ao passar o rato.
• Desde a última execução — um triângulo vermelho em cada linha executada na execução anterior e não nesta, um verde para o inverso, com a régua de visão geral e as contagens ao passar o rato.
• Buffers editados — cada marca, dica e CodeLens acompanha o texto enquanto edita, e retira-se de uma linha reescrita, onde um ponto cinzento diz porquê.
• Modos de margem do editor — editorGutter.mode mantém a margem só com as constatações (off), põe uma barra em cada linha que nunca correu e uma âmbar onde um ramo nunca foi tomado (uncovered), ou acrescenta um tom quente a cada linha executada, tanto mais quente quanto mais vezes correu (heatmap); Choose Editor Gutter Mode... alterna a partir da paleta ou do menu da barra de estado.
• Contagens de acertos em linha — hitCounts.inline escreve ×12 a seguir a cada linha em que começa uma instrução, ×0 incluído; Toggle Inline Hit Counts alterna-o.
• Entradas por linha no painel Problems — problems.perLine põe um diagnóstico de informação em cada bloco de linhas que nunca correram num documento aberto (uma função morta é uma entrada, não quarenta), e opcionalmente em cada linha com um ramo nunca tomado; as entradas acompanham as suas linhas enquanto edita.
• Tom da linha e mapa na barra de deslocamento — lineHighlight coloca um tom translúcido atrás das próprias linhas em vez de (ou além de) uma marca na margem, e overviewRuler decide sozinho a faixa na barra de deslocamento: com a margem desligada, é um mapa das lacunas do ficheiro e nada ao lado do código.
• Qual tracefile cobriu esta linha — com vários relatórios combinados, a dica com a contagem de execuções nomeia cada um que cobriu a linha (incluindo o nome da suíte do TN: do lcov), e clicar numa linha de tracefile na vista Coverage ilumina as linhas que ele contribuiu.

• Vermelho, âmbar e verde — o modo coverage de editorGutter.mode e lineHighlight pinta cada linha medida com as cores da escala de cores; o botão de modo da barra de estado e Alt+G passam de um modo ao seguinte.
• As suas cores, pré-visualizadas — a escala de cores e os tons do mapa de calor (heatmap.colors, heatmap.colorsDark) são definições, e a página de definições pré-visualiza-os num editor claro e num escuro à medida que são escolhidos.
• De que relatório vem um ficheiro — com dois relatórios a medir o mesmo código, regras de coverageFile.sources, ou Choose Coverage Source for This File..., decidem qual cada ficheiro mostra, em vez de ganhar o mais recente.

Relatórios e histórico

• Generate Full HTML Report — um relatório auto-gerado, de várias páginas, por diretório; Open Annotated Source para um único ficheiro.
• Histórico local opcional de execuções com uma tendência de cobertura (▲/▼), além de Compare Two History Runs e Compare with Last Run.
• Show Worst-Covered Files / Functions e Copy Uncovered Lines (Markdown).
• Export Fucini JSON — o modelo normalizado completo.
• Export Coverage Report... — a mesma execução como CSV (por ficheiro ou por função), resumo em Markdown, ficheiro de rastreio LCOV, XML do Cobertura, SARIF, ou emblema SVG autónomo. Com vinte e cinco leitores e estes escritores a extensão converte entre formatos: carregue JaCoCo ou llvm-cov JSON e produza o LCOV que o Codecov, o Coveralls e o SonarQube leem, ou o XML do Cobertura que o Jenkins, o GitLab e o Azure DevOps ingerem.
• Generate Coverage Badge — um SVG ao estilo shields escrito diretamente no espaço de trabalho (badge.outputPath, por predefinição coverage-badge.svg) para um README o incorporar com ![coverage](coverage-badge.svg) e sem serviço alojado; badge.metric escolhe linhas, ramos, MC/DC ou a pontuação composta, a cor segue os patamares de colorScale.*, e badge.autoUpdate reescreve-o após cada carregamento.

Screenshot pending — add assets/img/report.png (see SCREENSHOTS.md).

Screenshot pending — add assets/img/annotated-source.png (see SCREENSHOTS.md).

Community e Pro, funcionalidade a funcionalidade

Duas listagens, uma só base de código. Community é o nível permanentemente gratuito, e aquele em que a listagem Pro assenta após o seu período experimental de 14 dias; Pro e o período experimental são tudo, sem limites. A linha está traçada para que o nível gratuito veja sempre cada constatação e pague apenas por comodidade, prova e escala — no VS Code, Fucini Coverage: What Community Includes mostra a mesma lista com as contagens de hoje para cada limite.

Uma semana dura sete dias a partir da primeira utilização que a abriu, e nada que apenas leia a cobertura é contabilizado. Ainda não quer uma subscrição? Um passe de 7 dias é tudo o que está na coluna da direita durante uma semana, pago uma vez, sem nada para cancelar.

VS Code e Visual Studio lado a lado

Um produto, dois editores, um leitor: o mesmo relatório dá os mesmos números, ao dígito, nos dois. O Coverage Studio para Visual Studio corre no Visual Studio 2022 e 2026 — Community, Professional e Enterprise e não usa a cobertura de código própria do Visual Studio, que em 2022 é só para o Enterprise; está incluído em todos os planos pagos, e um dispositivo com os dois editores é um lugar. Tudo acima da linha existe nos dois; abaixo dela, aquilo para que o Visual Studio não tem equivalente, e o que ali ainda está para vir.

Referência de definições

Configure na interface de definições (pesquise Fucini Coverage) ou em settings.json.

Download the complete settings reference — a commented settings.json holding every fuciniCoverage.* setting at the same default the packaged extension uses, ready to copy into your workspace or user settings. Regenerated from the extension on every release, so it cannot drift from what the VSIX ships.

Uma linha que termina em Por pasta. aceita um valor ao nível da pasta num espaço de trabalho multi-raiz: cada pasta é detetada com o seu próprio .vscode/settings.json ou entrada no .code-workspace, e ${workspaceFolder} nela significa essa pasta.

Localização

Deteção e carregamento

Escala de cores e distintivos

Pontuação composta (média harmónica ponderada)

Limiares e conformidade

Diff, remapeamento e relatórios

Visualização e análise

Histórico

Ações rápidas da barra de estado

Todas predefinidas como false exceto as duas últimas; ative para adicionar a ação correspondente ao menu rápido: quickActions.compareWithLastRun, openAnnotatedSource, openAnnotatedSourceToSide, toggleAnnotatedSource, toggleWatch, worstCoveredFiles, worstCoveredFolders, worstCoveredFunctions, nextUncovered, previousUncovered, checkThresholds, copyUncoveredLines, compareHistoryRuns, exportJson, exportReport, generateBadge, showTestCoverage, chooseGutterMode, toggleInlineHitCounts.

Telemetria

Atualizações

Licenciamento