프로젝트 1 — 배포 점검

import shutil
from pathlib import Path

GOOD = Path("out_ch07_deploy")
BAD = Path("out_ch07_deploy_bad")

# 지난번에 만든 것을 지우고 실습 6의 폴더를 그대로 복사한다
shutil.rmtree(BAD, ignore_errors=True)
shutil.copytree(GOOD, BAD)

# 실수 1: 앱 파일 맨 위에 키 꼴의 글을 적은 줄(0 으로 채운 가짜 값)
app = (BAD / "app.py").read_text(encoding="utf-8")
(BAD / "app.py").write_text('OPENAI_API_KEY = "sk-proj-' + "0" * 24 + '"   # 지우는 것을 잊은 줄\n' + app, encoding="utf-8")
# 실수 2: requirements.txt 에서 pypdf 와 faiss-cpu 를 뺀다(import 에 안 보여 잊기 쉽다)
req = (BAD / "requirements.txt").read_text(encoding="utf-8").splitlines()
(BAD / "requirements.txt").write_text("\n".join(l for l in req if not l.startswith(("pypdf", "faiss-cpu"))) + "\n", encoding="utf-8")
# 실수 3: .gitignore 를 지운다
(BAD / ".gitignore").unlink()
# 실수 4: 견본 대신 진짜 이름의 secrets.toml 을 둔다(값은 자리표시)
(BAD / ".streamlit" / "secrets.toml.example").rename(BAD / ".streamlit" / "secrets.toml")

for folder in [GOOD, BAD]:
    print(folder, "→", sorted(p.relative_to(folder).as_posix() for p in folder.rglob("*") if p.is_file()))

import ast
import re

REQUIRED_FILES = ["app.py", "requirements.txt", "travel_terms.pdf", ".gitignore"]
# import 이름 → 패키지 이름. import 에 안 보이는 것은 HIDDEN 에 따로 적는다
IMPORT_TO_PACKAGE = {
    "streamlit": "streamlit", "dotenv": "python-dotenv",
    "langchain_core": "langchain-core", "langchain_community": "langchain-community",
    "langchain_classic": "langchain-classic", "langchain_openai": "langchain-openai",
    "langchain_text_splitters": "langchain-text-splitters",
}
HIDDEN = {"PyPDFLoader": "pypdf", "FAISS": "faiss-cpu"}
KEY_PATTERN = re.compile(r"sk-[A-Za-z0-9_-]{20,}")


def row(folder, name, ok, why):
    return {"폴더": folder.name, "점검": name, "결과": "통과" if ok else "고칠 것", "까닭": why}


def check_files(folder):
    missing = [f for f in REQUIRED_FILES if not (folder / f).exists()]
    return row(folder, "꼭 있어야 할 파일", not missing, "빠진 파일: " + ", ".join(missing) if missing else "네 개 모두 있음")


def check_requirements(folder):
    code = (folder / "app.py").read_text(encoding="utf-8")
    # ast.parse: 코드를 실행하지 않고 문법 나무로 읽는다. ast = abstract syntax tree(추상 구문 나무)
    tree = ast.parse(code)
    mods = {n.module.split(".")[0] for n in ast.walk(tree) if isinstance(n, ast.ImportFrom) and n.module}
    mods |= {a.name.split(".")[0] for n in ast.walk(tree) if isinstance(n, ast.Import) for a in n.names}
    need = {IMPORT_TO_PACKAGE[m] for m in mods if m in IMPORT_TO_PACKAGE}
    need |= {pkg for word, pkg in HIDDEN.items() if word in code}
    req = (folder / "requirements.txt").read_text(encoding="utf-8")
    have = {line.split("==")[0].strip().lower() for line in req.splitlines() if line.strip()}
    missing = sorted(need - have)
    return row(folder, "패키지 목록", not missing, "빠진 패키지: " + ", ".join(missing) if missing else f"필요한 {len(need)}개 모두 있음")


def check_keys(folder):
    found = []
    for f in folder.rglob("*"):
        if f.is_file() and f.suffix in {".py", ".toml", ".txt", ".example", ""}:
            if KEY_PATTERN.search(f.read_text(encoding="utf-8", errors="ignore")):
                found.append(f.relative_to(folder).as_posix())   # 키는 찍지 않고 파일 이름만 모은다
    return row(folder, "코드에 적힌 키", not found, "키 꼴의 글이 든 파일: " + ", ".join(found) if found else "키 꼴의 글 없음")


def check_gitignore(folder):
    path = folder / ".gitignore"
    lines = path.read_text(encoding="utf-8").splitlines() if path.exists() else []
    missing = [x for x in [".env", ".streamlit/secrets.toml"] if x not in lines]
    return row(folder, ".gitignore", not missing, "막지 않은 것: " + ", ".join(missing) if missing else ".env 와 secrets.toml 을 막음")


def check_secrets(folder):
    real = (folder / ".streamlit" / "secrets.toml").exists()
    example = (folder / ".streamlit" / "secrets.toml.example").exists()
    ok = example and not real
    why = "견본만 있음" if ok else ("진짜 이름의 secrets.toml 이 있음" if real else "견본이 없음")
    return row(folder, "비밀 값 견본", ok, why)


FILE_CHECKS = [check_files, check_requirements, check_keys, check_gitignore, check_secrets]
for check in FILE_CHECKS:
    r = check(GOOD)
    print(f"{r['점검']:10} {r['결과']:5} {r['까닭']}")

import streamlit as st
from streamlit.testing.v1 import AppTest


def check_app(folder):
    """첫 화면과 질문 하나를 연습 모드로 시험한다"""
    st.cache_resource.clear()
    at = AppTest.from_file(str(folder / "app.py"), default_timeout=30)
    # 자리표시를 Secrets 에 넣어 연습 모드로 돌린다(진짜 모델을 부르지 않는다)
    at.secrets["OPENAI_API_KEY"] = "발급받은_인증키"
    at.run()
    first_ok = len(at.exception) == 0 and len(at.title) == 1
    rows = [row(folder, "첫 화면", first_ok, f"제목 {len(at.title)}개, 오류 {len(at.exception)}개")]

    at.chat_input[0].set_value("여권은 기간이 얼마나 남아야 해요?").run()
    bot = at.chat_message[-1]
    sources = [c.value for c in bot.expander[0].caption] if bot.expander else []
    answer_ok = len(at.exception) == 0 and bot.name == "assistant" and any("조" in s for s in sources)
    rows.append(row(folder, "질문 하나", answer_ok, "근거: " + " / ".join(sources)))
    return rows


for r in check_app(GOOD):
    print(f"{r['점검']:6} {r['결과']:5} {r['까닭']}")

import pandas as pd

rows = []
for folder in [GOOD, BAD]:
    rows += [check(folder) for check in FILE_CHECKS]
    rows += check_app(folder)

table = pd.DataFrame(rows)
print(table.pivot(index="점검", columns="폴더", values="결과").loc[[r["점검"] for r in rows[:7]]].to_string())
print()
for _, r in table[table["결과"] == "고칠 것"].iterrows():
    print(f"[{r['폴더']}] {r['점검']}: {r['까닭']}")

table.to_csv("out_ch07_deploy_check.csv", index=False, encoding="utf-8-sig")
print("저장: out_ch07_deploy_check.csv,", len(table), "행")