Traduzir falhas em mensagens e códigos de saída

import sys

print("Registro encontrado: Ana")
print("Aviso: o cadastro está desatualizado.", file=sys.stderr)

import argparse


def criar_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="Consulta um registro.")
    parser.add_argument("registro_id", type=int)
    return parser


def consultar(registro_id: int) -> None:
    print(f"Registro consultado: {registro_id}")


def main(argv: list[str] | None = None) -> None:
    argumentos = criar_parser().parse_args(argv)
    consultar(argumentos.registro_id)


if __name__ == "__main__":
    main()

import argparse


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser()
    parser.add_argument("nome")
    return parser


def main(argv: list[str] | None = None) -> int:
    args = build_parser().parse_args(argv)
    print(f"Olá, {args.nome}!")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

import sys


class ConfiguracaoInvalida(Exception):
    def __init__(self, chave: str):
        self.chave = chave


class RegistroNaoEncontrado(Exception):
    def __init__(self, identificador: str):
        self.identificador = identificador


def carregar_configuracao() -> dict[str, str]:
    # Exemplo: a validação anterior detectou uma chave inválida.
    raise ConfiguracaoInvalida("diretorio_dados")


def consultar_registro(identificador: str, config: dict[str, str]) -> str:
    raise RegistroNaoEncontrado(identificador)


def main(argv: list[str] | None = None) -> int:
    identificador = "A-104"  # Viria dos argumentos já interpretados.

    try:
        config = carregar_configuracao()
        resultado = consultar_registro(identificador, config)
    except ConfiguracaoInvalida as erro:
        print(
            f"Erro de configuração: revise o valor de '{erro.chave}' e execute novamente.",
            file=sys.stderr,
        )
        return 3
    except RegistroNaoEncontrado as erro:
        print(
            f"Registro '{erro.identificador}' não foi encontrado. "
            "Confirme o identificador e tente novamente.",
            file=sys.stderr,
        )
        return 3

    print(resultado)
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

import logging
import sys


def main(argv: list[str] | None = None) -> int:
    try:
        configuracao = carregar_configuracao(argv)
        resultado = consultar_registro(configuracao)
    except ConfiguracaoInvalida as erro:
        print(f"Configuração inválida: {erro}. Revise a chave informada.", file=sys.stderr)
        return 3
    except RegistroNaoEncontrado as erro:
        print(f"Registro não encontrado: {erro}. Confira o identificador.", file=sys.stderr)
        return 3
    except Exception:
        logging.exception("Diagnóstico: defeito inesperado durante a consulta")
        print("Não foi possível concluir a operação. Tente novamente mais tarde.", file=sys.stderr)
        return 1
    else:
        print(resultado)
        return 0


if __name__ == "__main__":
    raise SystemExit(main())

import argparse
import logging
import sys


class ConfiguracaoInvalida(Exception):
    pass


class RegistroNaoEncontrado(Exception):
    pass


REGISTROS = {
    "ana": {"nome": "Ana", "cidade": "Recife"},
    "bruno": {"nome": "Bruno", "cidade": "Curitiba"},
}


def carregar_configuracao(nome: str) -> None:
    if nome == "invalida":
        raise ConfiguracaoInvalida(
            "a configuração solicitada não passou na validação"
        )


def consultar_registro(identificador: str, provocar_bug: bool) -> dict[str, str]:
    if provocar_bug:
        raise RuntimeError("falha simulada no adaptador de dados")
    try:
        return REGISTROS[identificador]
    except KeyError as erro:
        raise RegistroNaoEncontrado(identificador) from erro


def construir_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="Consulta um registro local.")
    parser.add_argument("identificador", help="identificador do registro")
    parser.add_argument(
        "--config",
        choices=["padrao", "invalida"],
        default="padrao",
        help="configuração simulada",
    )
    parser.add_argument(
        "--bug",
        action="store_true",
        help="provoca um defeito inesperado para demonstração",
    )
    return parser


def main(argv: list[str] | None = None) -> int:
    args = construir_parser().parse_args(argv)

    try:
        carregar_configuracao(args.config)
        registro = consultar_registro(args.identificador, args.bug)
    except ConfiguracaoInvalida:
        print(
            "Erro de configuração: revise a configuração solicitada e tente novamente.",
            file=sys.stderr,
        )
        return 3
    except RegistroNaoEncontrado as erro:
        print(
            f"Registro '{erro}' não foi encontrado. Confira o identificador e tente novamente.",
            file=sys.stderr,
        )
        return 3
    except Exception:
        logging.exception("Diagnóstico técnico: defeito inesperado durante a consulta")
        print(
            "Ocorreu um erro inesperado. Tente novamente mais tarde.",
            file=sys.stderr,
        )
        return 1

    print(f"{registro['nome']} — {registro['cidade']}")
    return 0


if __name__ == "__main__":
    logging.basicConfig(level=logging.ERROR, format="%(levelname)s: %(message)s")
    raise SystemExit(main())

# 1. Sucesso: stdout tem o registro; stderr fica vazio; código 0
python consulta.py ana >stdout.txt 2>stderr.txt; codigo=$?
printf 'codigo=%s\n' "$codigo"; cat stdout.txt; cat stderr.txt

# 2. Ajuda: stdout tem a ajuda; stderr fica vazio; código 0
python consulta.py --help >stdout.txt 2>stderr.txt; codigo=$?
printf 'codigo=%s\n' "$codigo"; cat stdout.txt; cat stderr.txt

# 3. Argumento inválido: stderr tem uso e erro; código 2
python consulta.py >stdout.txt 2>stderr.txt; codigo=$?
printf 'codigo=%s\n' "$codigo"; cat stdout.txt; cat stderr.txt

# 4. Configuração inválida: stderr orienta a revisão; código 3
python consulta.py ana --config invalida >stdout.txt 2>stderr.txt; codigo=$?
printf 'codigo=%s\n' "$codigo"; cat stdout.txt; cat stderr.txt

# 5. Registro ausente: stderr orienta conferir o identificador; código 3
python consulta.py carla >stdout.txt 2>stderr.txt; codigo=$?
printf 'codigo=%s\n' "$codigo"; cat stdout.txt; cat stderr.txt

# 6. Defeito controlado: stderr tem diagnóstico e mensagem breve; código 1
python consulta.py ana --bug >stdout.txt 2>stderr.txt; codigo=$?
printf 'codigo=%s\n' "$codigo"; cat stdout.txt; cat stderr.txt

# 1. Sucesso
python .\consulta.py ana 1> stdout.txt 2> stderr.txt; $codigo = $LASTEXITCODE
"codigo=$codigo"; Get-Content stdout.txt; Get-Content stderr.txt

# 2. Ajuda
python .\consulta.py --help 1> stdout.txt 2> stderr.txt; $codigo = $LASTEXITCODE
"codigo=$codigo"; Get-Content stdout.txt; Get-Content stderr.txt

# 3. Argumento inválido
python .\consulta.py 1> stdout.txt 2> stderr.txt; $codigo = $LASTEXITCODE
"codigo=$codigo"; Get-Content stdout.txt; Get-Content stderr.txt

# 4. Configuração inválida
python .\consulta.py ana --config invalida 1> stdout.txt 2> stderr.txt; $codigo = $LASTEXITCODE
"codigo=$codigo"; Get-Content stdout.txt; Get-Content stderr.txt

# 5. Registro ausente
python .\consulta.py carla 1> stdout.txt 2> stderr.txt; $codigo = $LASTEXITCODE
"codigo=$codigo"; Get-Content stdout.txt; Get-Content stderr.txt

# 6. Defeito controlado
python .\consulta.py ana --bug 1> stdout.txt 2> stderr.txt; $codigo = $LASTEXITCODE
"codigo=$codigo"; Get-Content stdout.txt; Get-Content stderr.txt