tenacity는 함수 재시도 로직을 데코레이터로 선언하는 라이브러리입니다. 네트워크 호출처럼 일시적 실패가 잦은 코드에 try/except + for 루프를 직접 짜는 대신, 데코레이터 한 줄로 재시도 전략을 설정할 수 있습니다.한 줄 요약: tenacity의 @re

logging.basicConfig()는 Python logging 모듈의 전역 로거를 한 번에 설정하는 함수입니다. 어디서 logger = logging.getLogger("pipeline")로 로거를 가져와도 이 설정이 공통 적용됩니다.로그를 어디에 출력할지 지정.

argparse는 Python 표준 라이브러리입니다. CLI(커맨드라인 인터페이스)에서 인자를 파싱하는 모듈로, python main.py <경로> --no-summary --json 같은 명령어를 처리합니다.

any()는 Python 내장 함수입니다. 이터러블의 요소 중 하나라도 참(Truthy)이면 True를 반환합니다.

frozenset은 Python 내장 타입입니다. 변경 불가능한(immutable) 집합(set)으로, 일반 set과 동일하게 중복 제거·포함 여부 검사를 지원하지만 생성 후 수정할 수 없습니다.frozenset\[str]은 타입 힌트로, 이 집합이 문자열만 담는다는

getLogger는 Python 표준 라이브러리 logging 모듈의 함수입니다. 이름을 기반으로 로거(Logger) 인스턴스를 가져오거나 생성합니다.로그 레벨 순서: DEBUG < INFO < WARNING < ERROR < CRITICAL한 줄

MarkdownTextSplitter는 LangChain의 langchain_text_splitters 모듈에 포함된 클래스입니다. \*\*Markdown 문서를 헤더(\`chunk_size는 문자 수 기준이며, Markdown 구조를 우선적으로 고려해 분할합니다.일반

TypedDict는 Python 표준 라이브러리 typing 모듈에 포함된 클래스입니다. 딕셔너리의 키와 값 타입을 명시적으로 정의할 수 있게 해주는 타입 힌트 도구입니다.런타임에는 일반 dict처럼 동작하고, 타입 체커(mypy, pyright)가 구조를 검증해줍니다

Counter는 Python 표준 라이브러리 collections 모듈에 포함된 클래스입니다. 리스트나 이터러블에서 각 항목이 몇 번 등장했는지 자동으로 세주는 딕셔너리입니다.딕셔너리처럼 키로 접근할 수 있습니다.Counter가 이걸 한 줄로 해결합니다.한 줄 요약:

fitz는 PyMuPDF 라이브러리의 내부 모듈 이름입니다. 설치할 때 이름과 import할 때 이름이 달라서 처음엔 헷갈립니다.이름이 다른 이유는 MuPDF라는 C 라이브러리를 Python으로 감싼 거라 역사적인 이유로 이름이 굳어졌습니다. "pymupdf = fit

os 모듈은 운영체제(OS)와 상호작용하는 기능을 제공하는 Python 표준 라이브러리입니다. 파일 경로, 환경변수, 프로세스 정보 등 OS 수준의 작업을 처리할 때 사용합니다.파일 경로를 OS에 맞게 안전하게 다룰 때 사용합니다..env 파일과 함께 python-do

or은 기본적으로 논리 연산자입니다. 두 값 중 하나라도 True면 True를 반환합니다.if/else로 풀어쓰면 이것과 동일합니다.결과는 같지만 or이 훨씬 간결합니다.

프로그래밍에서 가드(Guard) 란 특정 조건을 만족할 때만 코드가 실행되도록 막아주는 장치입니다. 경비원이 조건을 확인하고 통과시키는 것과 같습니다.이 코드가 대표적인 가드 패턴입니다. "직접 실행할 때만 run()을 호출해라" 라는 조건을 걸어두는 것입니다.\_\_

traceback은 Python 표준 라이브러리 중 하나로, 에러가 발생했을 때 어느 파일의 몇 번째 줄에서 어떤 경로로 에러가 났는지 상세하게 출력할 수 있게 해줍니다.Python에서 에러가 발생하면 기본적으로 이런 메시지가 출력됩니다.이것이 트레이스백(traceba

time은 Python 표준 라이브러리 중 하나로, 시간과 관련된 다양한 기능을 제공합니다. 그 중에서 코드 실행 시간을 측정할 때 가장 많이 쓰이는 함수들을 정리합니다.1970년 1월 1일 00:00:00(UTC)을 기준으로 현재까지 흐른 시간을 초 단위로 반환합니다

subprocess는 Python 표준 라이브러리 중 하나로, Python 코드 안에서 터미널 명령어를 실행할 수 있게 해줍니다.터미널에서 직접 치는 명령어를:Python 코드 안에서 이렇게 실행할 수 있습니다.subprocess.run()은 subpr

mkdir()은 pathlib의 Path 객체에서 제공하는 메서드로, 폴더를 생성할 때 사용합니다.parents=True — 중간 경로까지 전부 생성exist_ok=True — 이미 존재해도 에러 없이 통과처음 실행할 때도, 두 번째 실행할 때도 항상 안전하게 동작합니

run_all.py를 프로젝트 루트에서 실행했을 때 이런 에러를 만난 적 있을 것입니다.분명히 같은 폴더에 파일이 있는데 왜 못 찾는 걸까요? 이걸 이해하려면 Python이 import를 처리하는 방식을 알아야 합니다.Python은 import를 만나면 sys.path

여러 프로젝트를 동시에 개발하다 보면 패키지 버전 충돌 문제가 발생합니다.하나의 파이썬 환경에 두 버전을 동시에 설치할 수 없기 때문에, 프로젝트마다 독립된 공간을 만들어 각각의 패키지를 관리해야 합니다. 이것이 바로 가상 환경의 역할입니다.파이썬 3.3부터 내장 모듈

동기(Synchronous) 는 특정 작업이 끝나야 다음 작업을 처리하는 순차 처리 방식입니다. 반면 비동기(Asynchronous) 는 여러 작업을 동시에 처리하도록 맡겨두고, 작업이 끝나면 결과를 받는 방식입니다.파일 읽기, 네트워크 요청처럼 I/O 대기 시간이 긴