Validação da documentação Python

Revisão em 17/10/2026 (UTC). A referência atual é a a5 publicada no PyPI, tag v0.1.0a5, commit dc0f2bba99278f1763329d17b4662c947894ec94. Os comandos describe, describe --json, --version e a API describe_type foram conferidos no wheel público final, não em uma prévia de desenvolvimento.

O que foi executado nesta revisão

Verificação	Resultado e limite
Artefato público	Wheel a5 obtido por HTTPS do PyPI; SHA-256 conferido contra a metadata pública: d9fa667fcf40cdeacf2532609eb287f1149300e374f3992da44cddebe134e405
Instalação isolada	CPython 3.13.2/Windows x64; wheel local instalado com --no-index --no-deps; versão 0.1.0a5, sem dependências Python de execução
Escopo da a5	Comparação Git a4 → a5: somente README, NOTICE, metadados e identificação da versão; API, contrato e manifesto nativo sem alterações
Ajuda publicada	Sete testes: identidade do pacote, campos/tipos, enums/defaults, cópias e coleções, descrição PT-BR, JSON compatível com ajuda, versão, tipo estrito e canais/códigos de erro
Exemplos e contrato	Dez testes contra o wheel público: sintaxe dos programas e blocos Python, fixture sintética, ajuda, configuração A1 simulada, oito operações com transporte simulado, bloqueio de rede e links locais
Runtime	Não instalado ou executado nesta revisão; pin 0.2.1 lido do wheel público e comparado com a página de instalação

Nos testes específicos de ajuda, criação de sockets e subprocess.Popen ficam bloqueadas antes de importar o SDK. As consultas passam sem rede, runtime nativo ou A1. Os testes dos demais exemplos também bloqueiam socket e processos reais; as operações nativas usam mocks explicitamente.

Os resultados de build, busca, navegação móvel e conferência HTTP da publicação são registrados separadamente pelo responsável por essa etapa. A auditoria dos exemplos não substitui esses checks nem comprova emissão fiscal.

Como reproduzir

Instale a a5 em um ambiente virtual dedicado. Ative esse ambiente ou use seu executável diretamente. Os comandos abaixo partem da raiz deste repositório de documentação:

python -m pip install "acbr-python==0.1.0a5"
python -B tests/verify_help.py
python -B tests/verify_examples.py --installed
npm ci
npm test

O teste de exemplos também aceita um checkout somente leitura da mesma tag, no commit exato informado acima:

python -B tests/verify_examples.py --source CAMINHO/checkout-a5

Essa alternativa verifica a identidade Git antes de importar o SDK e não escreve bytecode no checkout. A verificação contra --installed exige metadata e código na versão 0.1.0a5; não há opção de candidato implícito.

Evidências históricas do SDK

Os testes nativos offline da a3 em Windows e Linux, com A1 sintético efêmero, foram confirmados pelo responsável pelo SDK. A CI histórica do candidato do PR #5 cobre Windows/Ubuntu e CPython 3.11–3.14. Essas evidências anteriores permanecem identificadas pelas versões que testaram; não foram renomeadas como testes desta revisão da a5.

Esta revisão documental não instalou nem executou o motor nativo, não usou A1 de contribuinte, não consultou a SEFAZ e não transmitiu, cancelou ou inutilizou documentos. Os exemplos permanecem sintéticos em HOMOLOGAÇÃO; os testes de operação usam mocks. Nenhum teste comprova homologação fiscal.

A auditoria original da a2 e a auditoria anterior de ajuda a3/candidata conservam os resultados históricos. A análise TLS também identifica suas versões auditadas; não deve ser confundida com um novo teste TLS do pin de instalação atual 0.2.1.

Publicação

O build destina-se somente à rota /acbr-python/. A liberação estática usa uma release isolada e troca atômica de current, preservando a anterior. Após a ativação, devem ser conferidos os bytes servidos por HTTPS, a busca, os assets e deployment.json. Não é necessário alterar Nginx, certificados ou serviços para atualizar o conteúdo.

A disponibilidade da a5 é comprovada pela release pública no PyPI. A preparação deste conteúdo não implica que a nova documentação já foi ativada no VPS.