실습 1 — 실습 환경 구축 실습 따라 하기

관련 수업 자료: 4차시 「7. 첫 번째 테스트 코드 작성」(8~11쪽) · 실습 코드 test.py

이 실습은 교안 해설(04_실습환경구축.md)의 실습 순서를 옮긴 것입니다. OpenAI 임베딩이나 채팅 모델을 부르는 파일은 .env 에 API 키가 있어야 돌아갑니다. 키가 없으면 실행 결과 샘플로 출력 모양을 확인합니다.

수업 자료와 이어지는 곳

실행 흐름

가상환경 → requirements
requirements → .env
.env → 차시 폴더에서 실행

실습 순서

실습에서 가상환경을 만들고 패키지를 설치한 뒤, src에서 python test.py를 실행합니다.

cd 실습
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
pip install pymupdf
cd src
python test.py

스스로 확인

• 가상환경을 켠 상태인지 프롬프트로 확인할 수 있는가?
• 키를 코드에 직접 적지 않고 .env에 두는 이유를 말할 수 있는가?
• 예제를 프로젝트 루트가 아니라 차시 폴더에서 실행해야 하는 이유를 아는가?

코드 설명

• import sys 는 지금 돌고 있는 파이썬 자신의 정보를 담은 표준 모듈을 불러옵니다. 파이썬에 들어 있으므로 따로 설치하지 않습니다.
• sys.version 은 이 파일을 실행한 바로 그 파이썬의 버전입니다. 컴퓨터에 파이썬이 여럿 있으면 가상환경을 켰는지에 따라 다른 값이 나옵니다. 가상환경을 켠 파이썬으로 돌려야 방금 설치한 패키지가 보입니다.
• print(f"파이썬 버전 확인 => {sys.version}") 의 f-문자열은 중괄호 안의 값을 문자열에 끼워 넣습니다. 앞의 f를 빼먹으면 {sys.version} 이라는 글자가 그대로 찍힙니다. 여기서 많이들 실수하십니다.
• 실행 결과에서 보실 것은 맨 앞의 버전 숫자입니다. 3.10 이상이면 이 과정의 라이브러리를 쓸 수 있습니다.
• cd 실습/src 로 옮긴 뒤 python test.py 를 실행합니다. 다른 폴더에서 실행하면 test.py 파일을 찾지 못한다는 오류가 납니다.