# import 는 "남이 만들어둔 기능 묶음을 가져다 쓰겠다"는 선언이다.
# os 는 운영체제의 기능을 제어하는 묶음이다 - 폴더 만들기, 파일 목록 보기, 환경변수 읽기.
# 파이썬에 기본 포함이라 따로 설치할 게 없다. 보통 파일 맨 위에 모아 적는 것이 관례다.
import os

# 점(.)은 "os 묶음 안의" 라는 뜻이다. os 에 든 makedirs 를 호출한다.
#   exist_ok=True 가 없으면 폴더가 이미 있을 때 에러가 난다.
os.makedirs("docs", exist_ok=True)

files = {
    "backend.txt": "수업용 예제\n백엔드 개발자는 서버와 데이터베이스를 다룬다. 사용자 눈에 보이지 않는 곳에서 데이터를 저장하고 꺼내는 일을 한다. 주로 쓰는 언어는 자바, 파이썬, 노드다.",
    "frontend.txt": "수업용 예제\n프론트엔드 개발자는 사용자가 직접 보는 화면을 만든다. 버튼을 누르면 무슨 일이 일어나는지를 설계한다. 리액트와 뷰가 많이 쓰인다.",
    "data.txt": "수업용 예제\n데이터 엔지니어는 흩어진 데이터를 모아 쓸 수 있는 형태로 만든다. 데이터베이스와 파이프라인을 다루고 파이썬과 SQL 을 쓴다.",
}

# 딕셔너리를 그냥 돌면 이름만 나온다. .items() 를 붙여야 이름과 값을 짝으로 준다.
# 그래서 받는 이름도 두 개다 - name 에 파일명, content 에 내용.
for name, content in files.items():
    # with 를 쓰면 이 블록이 끝날 때 파일이 자동으로 닫힌다.
    #   "docs/파일명"   f-string 으로 경로를 만든다
    #   "w"             쓰기 모드. 파일이 있으면 내용을 지우고 새로 쓴다
    #   encoding=       오늘의 핵심. 잠시 뒤에 이걸 빼면 어떻게 되는지 본다
    with open(f"docs/{name}", "w", encoding="utf-8") as f:
        f.write(content)        # f 는 열린 파일이다. 거기에 글자를 써 넣는다

print(sorted(os.listdir("docs")))   # 그 폴더에 뭐가 있는지 이름 목록으로 반환한다

# "r" 은 읽기 모드다. 쓸 때와 달리 파일 내용을 건드리지 않는다.
with open("docs/backend.txt", "r", encoding="utf-8") as f:
    text = f.read()             # 파일 전체를 문자열 하나로 읽어 온다

print(len(text))
print(text[:20])                # 2강의 슬라이싱. 앞 20글자만 확인
print(repr(text[:20]))          # repr 로 감싸면 줄바꿈이 \n 으로 보인다

# 일부러 encoding 을 뺀다.
# 안 주면 파이썬이 운영체제 기본값을 쓰는데, 한국어 Windows 에서는 그게 cp949 다.
with open("docs/backend.txt", "r") as f:
    text = f.read()

print(text[:20])

import os

# glob 은 "특정 규칙 파일명의 파일을 전부 찾아주는" 패키지이다.
# 이것도 파이썬의 기본 내장 기능이다.
import glob

# * 는 "아무 글자나 몇 개든" 이라는 뜻이다. docs 폴더의 txt 파일 전부.
# 패키지 이름과 함수 이름이 둘 다 glob 라 glob.glob 가 된다. 오타가 아니다.
paths = glob.glob("docs/*.txt")
print(paths)
print(paths[0])                 # 하나만 찍으면 역슬래시가 하나로 보인다

# sorted 로 감싸면 순서가 운영체제와 상관없이 항상 같아진다
for path in sorted(paths):
    print(os.path.basename(path))   # 경로에서 파일 이름만 떼어낸다

import os
import glob

def load_documents(folder=None):
    """폴더 안 txt 를 전부 읽는다. folder 를 안 주면 환경변수 DOCS_DIR, 그것도 없으면 docs."""
    # A or B 는 "A 가 참이면 A, 아니면 B" 를 준다.
    folder = folder or os.getenv("DOCS_DIR", "docs")
    paths = sorted(glob.glob(f"{folder}/*.txt"))

    # 빈 리스트·빈 문자열·0 은 파이썬에서 거짓이다. not paths 는 "비었으면" 이라는 뜻.
    if not paths:
        print(f"[경고] '{folder}' 에서 txt 파일을 못 찾았다.")
        return []                # 여기서 함수가 끝난다. 아래는 실행되지 않는다

    result = []
    for path in paths:
        # try 안에서 그 에러가 나면 프로그램이 죽는 대신 except 로 넘어간다.
        # 잡을 에러 이름을 반드시 적는다 - 그냥 except: 로 다 잡으면
        # 정작 봐야 할 문제까지 삼켜버린다.
        try:
            with open(path, "r", encoding="utf-8") as f:
                result.append({"source": os.path.basename(path), "text": f.read()})
        except UnicodeDecodeError:
            print(f"[건너뜀] {path} - utf-8 이 아니다")

    # 이 한 줄이 없으면 "0건인데 문제의 상태"를 알아챌 수 없다.
    print(f"문서 {len(result)}건을 읽었다 (폴더: {folder})")
    return result


docs = load_documents("doc")    # 일부러 틀린 폴더 이름
docs = load_documents()         # 제대로 된 이름

print(len(docs))
print(docs[0]["source"])
print(docs[0]["text"][:20])

import os
import glob

def load_documents(folder=None):
    """폴더 안 txt 를 전부 읽는다."""
    folder = folder or os.getenv("DOCS_DIR", "docs")
    paths = sorted(glob.glob(f"{folder}/*.txt"))

    if not paths:
        print(f"[경고] '{folder}' 에서 txt 파일을 못 찾았다.")
        return []

    result = []
    for path in paths:
        try:
            with open(path, "r", encoding="utf-8") as f:
                result.append({"source": os.path.basename(path), "text": f.read()})
        except UnicodeDecodeError:
            print(f"[건너뜀] {path} - utf-8 이 아니다")

    print(f"문서 {len(result)}건을 읽었다 (폴더: {folder})")
    return result


# os.environ 은 환경변수가 담긴 딕셔너리다. 딕셔너리처럼 이름으로 넣고 꺼낸다.
# 원래는 터미널이나 .env 파일에서 정하지만, 지금은 확인용으로 코드에서 넣는다.
os.environ["DOCS_DIR"] = "docs"

load_documents()                # 인자를 안 줬으니 DOCS_DIR 을 읽는다

# search.py - 문서를 읽고 조각으로 자른다
import os
import glob


def load_documents(folder=None):
    """폴더 안 txt 를 전부 읽는다."""
    folder = folder or os.getenv("DOCS_DIR", "docs")
    paths = sorted(glob.glob(f"{folder}/*.txt"))

    if not paths:
        print(f"[경고] '{folder}' 에서 txt 파일을 못 찾았다.")
        return []

    result = []
    for path in paths:
        try:
            with open(path, "r", encoding="utf-8") as f:
                result.append({"source": os.path.basename(path), "text": f.read()})
        except UnicodeDecodeError:
            print(f"[건너뜀] {path} - utf-8 이 아니다")

    print(f"문서 {len(result)}건을 읽었다 (폴더: {folder})")
    return result


def chunk_text(text, size=200):
    """긴 글을 size 글자씩 자른다."""
    return [text[i:i + size] for i in range(0, len(text), size)]


def build_chunks(folder=None):
    """문서를 읽어 조각 목록으로 만든다. 조각마다 출처를 붙인다."""
    chunks = []
    for doc in load_documents(folder):
        for piece in chunk_text(doc["text"]):
            if piece.strip():                       # 공백뿐인 조각은 버린다
                chunks.append({"source": doc["source"], "text": piece})
    return chunks

# 내가 만든 파일도 import 로 가져온다. 파일 이름에서 .py 를 뗀 것이 패키지의 이름이다.
# 같은 폴더에 있으면 그냥 찾는다.
import search

# 점(.)은 여기서도 "그 패키지 안의" 라는 뜻이다. os.makedirs 와 같은 문법이다.
chunks = search.build_chunks()

print(len(chunks))
print(chunks[0]["source"])
print(chunks[0]["text"][:20])

# numpy 는 숫자 다발을 빠르게 계산해주는 묶음이다. 이건 기본 포함이 아니라 설치가 필요하다.
# as np 는 "이 묶음을 np 라는 짧은 이름으로 부르겠다"는 뜻이다.
import numpy as np

a = np.array([1, 2, 3])     # 파이썬 리스트를 numpy 배열로 바꾼다
b = np.array([2, 4, 6])

print(a.shape)          # 숫자가 몇 개짜리인가. 괄호가 없다 - 함수가 아니라 값이다
print(np.dot(a, b))     # 자리끼리 곱해 전부 더한다 (1*2 + 2*4 + 3*6)