Auditor de Código Python: Nivel Senior (Salida en Español)

• resultado=[]를 제거해 호출 간 데이터가 누적되는 문제를 해결했습니다.
• except: 대신 구체적인 예외를 처리하고, 잘못된 사용자 데이터는 로그로 기록하도록 개선했습니다.
• 모든 함수에 타입 힌트를 추가하고 입력값을 검증했습니다.
• 중복 검색을 이중 반복문에서 Counter 기반의 O(n) 알고리즘으로 변경했습니다.
• 실행 코드를 main()과 if __name__ == "__main__":으로 분리했습니다.
• 문자열 포맷팅을 f-string으로 현대화하고, 성년 기준을 일반적인 18세 이상으로 수정했습니다.

from __future__ import annotations

import logging
from collections import Counter
from collections.abc import Hashable, Iterable, Mapping
from typing import TypeVar


T = TypeVar("T", bound=Hashable)

LOGGER = logging.getLogger(__name__)


def procesar_usuarios(
    usuarios: Iterable[Mapping[str, object]],
    resultado: list[str] | None = None,
) -> list[str]:
    """Procesa usuarios y genera mensajes según su edad."""
    mensajes = resultado if resultado is not None else []

    for usuario in usuarios:
        try:
            nombre = usuario["nombre"]
            edad = usuario["edad"]

            if not isinstance(nombre, str):
                raise TypeError("El nombre debe ser una cadena.")

            if isinstance(edad, bool) or not isinstance(edad, int):
                raise TypeError("La edad debe ser un entero.")

            estado = "mayor de edad" if edad >= 18 else "menor de edad"
            mensajes.append(f"{nombre} es {estado}")

        except (KeyError, TypeError, ValueError) as error:
            LOGGER.warning(
                "Error al procesar el usuario %r: %s",
                usuario,
                error,
            )

    return mensajes


def buscar_duplicados(valores: Iterable[T]) -> list[T]:
    """Devuelve los valores duplicados, conservando su orden original."""
    elementos = list(valores)
    frecuencias = Counter(elementos)

    return list(dict.fromkeys(
        valor for valor in elementos if frecuencias[valor] > 1
    ))


def main() -> None:
    """Ejecuta un ejemplo de uso del programa."""
    logging.basicConfig(level=logging.WARNING)

    usuarios: list[Mapping[str, object]] = [
        {"nombre": "Carlos", "edad": 25},
        {"nombre": "Ana", "edad": 17},
        {"nombre": "Carlos", "edad": 25},
    ]

    print(procesar_usuarios(usuarios))
    print(buscar_duplicados([1, 2, 2, 3, 3, 3]))


if __name__ == "__main__":
    main()