main
Gerada por tools/gerar_documentacao.py. Definição: tests/auditar_exemplos.py:42.
função Python definida em tests/auditar_exemplos.py; contrato extraído da assinatura e do corpo abaixo.
Tipo: função Python · Visibilidade: pública · Arquivo: tests/auditar_exemplos.py.
Assinatura e expansão
def main():
Como funciona
O comportamento normativo é o corpo extraído abaixo. Não foi inferida uma garantia adicional sem contrato/documentação no fonte.
Implementação completa · 106 linhas
def main():
p = argparse.ArgumentParser(description=__doc__)
p.add_argument('--cc', required=True, help='executável do compilador')
p.add_argument('--basicgolc', required=True)
p.add_argument('--library', required=True)
p.add_argument('--flag', action='append', default=[], help='flag adicional; use --flag=-std=c11')
p.add_argument('--object-only', action='store_true', help='compila -c sem ligar nem executar')
p.add_argument('--linker', help='compila -c e liga com este driver (ex.: gcc para 8cc)')
args = p.parse_args()
if args.object_only and args.linker:
p.error('--object-only e --linker sao mutuamente exclusivos')
compiler = args.cc
basicgolc = str(pathlib.Path(args.basicgolc).resolve())
library = str(pathlib.Path(args.library).resolve())
sources = sorted(DOCS.glob('*.c')) + sorted(EXTRAS.rglob('*.c'))
passed = failed = probe_ok = probe_failed = 0
with tempfile.TemporaryDirectory(prefix='bg-exemplos-') as temp:
temp = pathlib.Path(temp)
for source in sources:
rel = source.relative_to(ROOT).as_posix()
special = SPECIAL.get(rel)
fixture = source.stem if source.parent == DOCS else COPIAS.get(rel)
profiles = ['M0', 'M1']
if source.parent == DOCS and source.stem in ('para_contado', 'controle_para_acucar'):
profiles.remove('M0')
for profile in profiles:
generated = temp / 'generated.c'
inp = source
if profile == 'M1':
proc = call([basicgolc, str(source), '-o', str(generated)])
if proc is None or proc.returncode:
lines = [] if proc is None else proc.stderr.decode(errors='replace').strip().splitlines()
message = ('timeout' if proc is None else
next((line for line in lines if ': erro:' in line), lines[0] if lines else 'sem diagnostico'))
status = 'SONDAGEM FALHOU' if special else 'FALHA'
print(f'{status}\t{rel}\t{profile}\ttranspilacao: {message}')
if special: probe_failed += 1
else: failed += 1
continue
inp = generated
binary = temp / ('out.o' if args.object_only or args.linker or special else 'out')
cmd = [compiler, *args.flag, '-I', str(ROOT / 'include')]
if special == 'boot freestanding':
cmd.append('-ffreestanding')
cmd += [str(inp)]
if args.object_only or args.linker or special:
cmd += ['-c', '-o', str(binary)]
else:
cmd += ['-o', str(binary), library, '-lm']
proc = call(cmd)
if proc is None or proc.returncode:
message = 'timeout' if proc is None else ' '.join(proc.stderr.decode(errors='replace').strip().splitlines()[:2])
status = 'SONDAGEM FALHOU' if special else 'FALHA'
print(f'{status}\t{rel}\t{profile}\tcompilacao: {message}')
if special: probe_failed += 1
else: failed += 1
continue
if special:
print(f'SONDAGEM COMPILOU\t{rel}\t{profile}\tobjeto host; nao testou {special}')
probe_ok += 1
continue
if args.object_only:
print(f'COMPILOU\t{rel}\t{profile}\tobjeto; nao ligado nem executado')
passed += 1
continue
if args.linker:
exe = temp / 'linked'
proc = call([args.linker, str(binary), library, '-lm', '-o', str(exe)])
if proc is None or proc.returncode:
message = 'timeout' if proc is None else ' '.join(proc.stderr.decode(errors='replace').strip().splitlines()[:2])
print(f'FALHA\t{rel}\t{profile}\tligacao: {message}')
failed += 1
continue
binary = exe
entrada = DOCS / (str(fixture) + '.entrada.txt') if fixture else None
proc = call([str(binary)], stdin=entrada.read_bytes() if entrada and entrada.exists() else b'')
error = None
if proc is None:
error = 'execucao: timeout'
elif proc.returncode:
error = f'execucao: codigo {proc.returncode}'
elif fixture:
expected = DOCS / (fixture + '.esperado.txt')
contains = DOCS / (fixture + '.contem.txt')
stderr = DOCS / (fixture + '.esperado_stderr.txt')
if not expected.exists() and not contains.exists():
error = 'sem contrato de stdout para este exemplo'
elif expected.exists() and proc.stdout.replace(b'\r', b'') != expected.read_bytes().replace(b'\r', b''):
error = 'stdout diverge do dourado'
elif contains.exists() and any(line not in proc.stdout for line in contains.read_bytes().splitlines() if line):
error = 'stdout nao contem trecho esperado'
elif stderr.exists() and stderr.read_bytes().strip() not in proc.stderr:
error = 'stderr nao contem trecho esperado'
elif rel == 'examples/advanced/basicz/basicz.c':
if b'BASIC-Z' not in proc.stdout or b'Concluido.' not in proc.stdout:
error = 'stdout nao contem marcadores BASIC-Z e Concluido.'
else:
error = 'sem contrato de stdout para este exemplo'
if error:
print(f'FALHA\t{rel}\t{profile}\t{error}')
failed += 1
else:
print(f'OK\t{rel}\t{profile}\texecutado e saida conferida')
passed += 1
print(f'RESUMO\tfontes={len(sources)}\taprovados={passed}\tfalhas={failed}\tsondagens_compiladas={probe_ok}\tsondagens_falharam={probe_failed}')
return 1 if failed or probe_failed else 0
Interface BASICGOL relacionada
Nomes internos referenciados: call.
Como este símbolo aparece nos testes
9 ocorrência(s) em 9 arquivo(s) de teste. Os links apontam para linhas exatas; os trechos mostram o contexto local. Uma menção não prova que todos os ramos foi executado.
tests/auditar_exemplos.py
Contexto: auditar_exemplos.py. Linhas: 151. Tipo de evidência: código; via main.
Linhas 149–151 · abrir contexto
if __name__ == '__main__':
sys.exit(main())
tests/documentacao/check_llms_build.py
Contexto: check_llms_build.py. Linhas: 35. Tipo de evidência: código; via main.
Linhas 33–35 · abrir contexto
if __name__ == '__main__':
main()
tests/documentacao/test_gerador.py
Contexto: test_gerador.py. Linhas: 160. Tipo de evidência: código; via main.
Linhas 158–160 · abrir contexto
if __name__ == "__main__":
unittest.main()
tests/fuzz_basicgolc.py
Contexto: fuzz_basicgolc.py. Linhas: 184. Tipo de evidência: código; via main.
Linhas 182–184 · abrir contexto
if __name__ == "__main__":
sys.exit(main())
tests/portabilidade/cpp_inclusao.cpp
Contexto: cpp_inclusao.cpp. Linhas: 19. Tipo de evidência: código; via main.
Linhas 17–21 · abrir contexto
#include <cstring>
int main()
{
char destino[8] = {0};
tests/run.sh · heredoc na linha 174
Contexto: C incorporado no runner (linha 174). Linhas: 191. Tipo de evidência: código; via main.
Linhas 189–191 · abrir contexto
#error "nome curto NATURAL_CURTO nao deveria existir"
#endif
int main(void) { return 0; }
tests/run.sh · heredoc na linha 202
Contexto: C incorporado no runner (linha 202). Linhas: 209. Tipo de evidência: código; via main.
Linhas 207–209 · abrir contexto
#error "SOMA_SEGURA nao deveria existir sem BG_USAR_EXTENSOES"
#endif
int main(void) { return 0; }
tests/test_biblioteca.c
Contexto: test_biblioteca.c. Linhas: 551. Tipo de evidência: código; via main.
Linhas 549–553 · abrir contexto
}
int main(int argc, char **argv)
{
if (argc == 2 && strcmp(argv[1], "--stdin") == 0) {
tests/test_filesystem.c
Contexto: test_filesystem.c. Linhas: 16. Tipo de evidência: código; via main.
Linhas 14–18 · abrir contexto
}
int main(void) {
// temp file
char tmp[256];
Evidência indireta
Estes símbolos chamam/encaminham para este nome. As referências deles ajudam a rastrear o caminho, mas não substituem um teste específico deste símbolo.
BG_INICIO→ tests/casos/06_negativos/n09_dois_inicio/programa.c, tests/run.sh, tests/run_portabilidade.sh
Compiladores, padrão C e sistema operacional
Nenhum ramo condicional externo foi detectado para este símbolo. A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.
- Script Python: usa a biblioteca padrão e pathlib/subprocess quando aplicável; caminhos não devem depender do separador de um único OS.
A matriz histórica distingue executado, compilado, avaliado e não testado. Consulte a matriz, os compiladores e os logs atuais dos workflows antes de chamar um alvo de suportado.
Perguntas frequentes
Perguntas reunidas a partir da definição, do contrato editorial e dos testes de main. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que main faz?
função Python definida em tests/auditar_exemplos.py; contrato extraído da assinatura e do corpo abaixo.
Qual é a assinatura e o tipo de retorno de main?
Assinatura extraída de tests/auditar_exemplos.py; visibilidade pública.
def main():
Como main aparece em código real deste repositório?
Uso extraído de tests/auditar_exemplos.py:149, com as linhas vizinhas preservadas:
if __name__ == '__main__':
sys.exit(main())
Onde main é exercitado nos testes?
Há 9 ocorrência(s) em 9 arquivo(s): tests/auditar_exemplos.py, tests/documentacao/check_llms_build.py, tests/documentacao/test_gerador.py, tests/fuzz_basicgolc.py, tests/portabilidade/cpp_inclusao.cpp …. Os links da seção de evidência apontam para a linha exata; uma menção não prova que todos os ramos foram executados.
main depende de compilador, padrão C ou sistema operacional?
main é uma função Python: requer Python 3.10+ e biblioteca padrão, sem compilador C.
O que acontece em caso de falha ou uso inválido?
Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.