프로젝트 1 — 내 PC 점검표 만들기

import os
import sys
import time
from importlib.metadata import PackageNotFoundError, version
from pathlib import Path

import pandas as pd
from dotenv import find_dotenv, load_dotenv
from langchain_openai import ChatOpenAI

# 점검 결과를 {"항목", "결과", "내용"} 사전으로 쌓는다
checks = []


def add(item, ok, detail):
    """점검 하나의 결과를 목록에 더한다. ok 가 True 면 통과."""
    checks.append({"항목": item, "결과": "통과" if ok else "확인 필요", "내용": detail})


# 파이썬 판: version_info 는 (3, 14, 6, …) 같은 튜플이라 (3, 12) 와 바로 견줄 수 있다
add("파이썬 3.12 이상", sys.version_info >= (3, 12), sys.version.split()[0])
add("가상환경 안", sys.prefix != sys.base_prefix, Path(sys.prefix).name)

# 실습 1이 저장한 "이름==판" 목록과 지금 설치된 판을 견준다
for line in Path("out_ch02_requirements.txt").read_text(encoding="utf-8").split():
    name, want = line.split("==")
    try:
        now = version(name)
    except PackageNotFoundError:
        now = None
    add(f"{name} 판", now == want, f"목록 {want} / 지금 {now or '없음'}")

print(f"점검한 항목: {len(checks)}개")

def mask(key, keep=3):
    """키의 앞 keep 글자만 남기고 뒤는 **** 로 가린다. 키가 없으면 '없음'."""
    return key[:keep] + "****" if key else "없음"


def looks_like_key(key):
    """키의 꼴만 본다: sk- 로 시작, 빈칸 없음, 자리표시가 아님, 20글자 이상."""
    return bool(key) and key.startswith("sk-") and " " not in key and key != "발급받은_인증키" and len(key) >= 20


# find_dotenv(usecwd=True): 지금 폴더(data)에서 위로 올라가며 .env 를 찾는다. 못 찾으면 ""
env_path = find_dotenv(usecwd=True)
add(".env 파일", env_path != "", Path(env_path).name if env_path else "못 찾음")
if env_path:
    load_dotenv(env_path)

key = os.getenv("OPENAI_API_KEY")
key_ok = looks_like_key(key)
add("키 꼴", key_ok, mask(key))
# 모델 이름도 .env 에서 바꿀 수 있게 하고, 없으면 gpt-4.1-mini 를 쓴다
MODEL = os.getenv("OPENAI_MODEL", "gpt-4.1-mini")
print("키 꼴이 맞나:", key_ok, "/", mask(key))

if key_ok:
    # timeout=30: 30초 안에 답이 없으면 멈춘다. max_retries=1: 실패하면 한 번만 더 보낸다
    model = ChatOpenAI(model=MODEL, temperature=0, timeout=30, max_retries=1)
    # perf_counter: 걸린 시간을 재는 초시계. 앞뒤로 불러 뺀다
    start = time.perf_counter()
    try:
        reply = model.invoke("한 낱말로만 답해 줘. 준비됐니?")
        seconds = time.perf_counter() - start
        add("짧은 질문", True, f"답 '{reply.content}'")
        add("10초 안에 답", seconds < 10, f"{seconds:.1f}초")
    except Exception as e:
        # 오류가 나도 점검표는 끝까지 찍는다. 오류의 이름만 적는다
        add("짧은 질문", False, type(e).__name__)
else:
    add("짧은 질문", False, "키를 먼저 확인하세요")

print("마지막 점검:", checks[-1]["항목"], "→", checks[-1]["결과"])

table = pd.DataFrame(checks)
print(table.to_string(index=False))

# "통과" 인 줄을 센다. True 를 1 로 더한다
passed = int((table["결과"] == "통과").sum())
print(f"통과 {passed} / {len(table)}")

# utf-8-sig: 엑셀에서 한글이 깨지지 않게 저장한다
table.to_csv("out_ch02_checklist.csv", index=False, encoding="utf-8-sig")
print("저장: out_ch02_checklist.csv")