Funcionalidade render - BrunodosSantosVaz/big-bang GitHub Wiki
Renderização segura de templates
Funcionalidade BB-F-021 · requisito RF-BB-021 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Substituir marcadores conhecidos e inserir avisos de geração no formato do arquivo de destino.
Atores
Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.
Pré-condições
Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.
Fluxo principal
Resolver secao.chave, formatar listas e escalares, renderizar texto e selecionar comentários válidos para Markdown, YAML ou outros formatos.
Validações
JSON não recebe comentário inválido; marcadores sem valor são erros, não texto silenciosamente preservado.
Alternativas e erros
Valor desconhecido ou template inválido identifica a fonte e interrompe a geração.
Permissões
Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.
Resultados
Resultado esperado: Substituir marcadores conhecidos e inserir avisos de geração no formato do arquivo de destino. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.
Referência da implementação
Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.
render.py
| Símbolo | Linha |
|---|---|
format_value |
21 |
substitute |
29 |
notice_text |
49 |
add_notice |
53 |
_after_header |
67 |
has_notice |
80 |
replace |
33 |
Cenários e rastreabilidade
.bigbang/tests/test_bb_gerar.py:test_antes_da_fundacao.bigbang/tests/test_bb_gerar.py:test_esteira_exige_fundacao.bigbang/tests/test_bb_gerar.py:test_skills_em_duas_copias_iguais_com_aviso_depois_do_cabecalho.bigbang/tests/test_bb_gerar.py:test_composicao_deploy_vps_docker.bigbang/tests/test_bb_gerar.py:test_composicao_compilado_sem_alvo.bigbang/tests/test_bb_gerar.py:test_troca_de_alvo_remove_e_cria.bigbang/tests/test_bb_gerar.py:test_segunda_geracao_nao_muda_nada.bigbang/tests/test_bb_gerar.py:test_remove_ci_do_framework_ao_instalar_a_esteira.bigbang/tests/test_bb_gerar.py:test_nao_toca_arquivos_do_projeto.bigbang/tests/test_bb_gerar.py:test_bloco_inserido_em_agents_md_existente.bigbang/tests/test_bb_gerar.py:test_dois_blocos_no_agents_md.bigbang/tests/test_bb_gerar.py:test_bloco_do_stack_md.bigbang/tests/test_bb_gerar.py:test_camada_sempre_nao_escreve_em_github.bigbang/tests/test_bb_gerar.py:test_skill_sem_prefixo_bb.bigbang/tests/test_bb_gerar.py:test_simular_nao_grava.bigbang/tests/test_bb_gerar.py:test_marcadores.bigbang/tests/test_bb_gerar.py:test_expressao_do_github_actions_nao_e_marcador.bigbang/tests/test_bb_gerar.py:test_marcador_sem_valor.bigbang/tests/test_bb_gerar.py:test_aviso_por_tipo.bigbang/tests/test_bb_gerar.py:test_reconhece_aviso.bigbang/tests/test_bb_gerar.py:test_template_em_dia
Requisitos · Matriz de rastreabilidade · Referência CLI