code/labeling/src/config_utils.py

"""
file:    config.py
date:    2026/02/15
brief:   JSON 기반 설정 파일 로더 유틸리티

본 모듈은 프로젝트 전반에서 사용되는 설정(JSON) 파일을
파이썬 딕셔너리 형태로 로드하기 위한 공통 유틸 함수들을 제공한다.

특징:
- UTF-8 인코딩을 명시적으로 사용
- 설정 파일의 구조나 키에 대한 검증은 수행하지 않음
- 각 step(step1/2/3) 스크립트에서 동일한 방식으로 재사용됨

----------------------------------------------------------------------
Version     Date        Comment
---------   ----------  ----------------------------------------------

"""


import json
from typing import Any, Dict


def load_config(path: str) -> Dict[str, Any]:
    """
    JSON 형식의 설정 파일을 로드하여 딕셔너리로 반환한다.

    Parameters
    ----------
    path : str
        로드할 설정 파일(JSON)의 경로

    Returns
    -------
    dict[str, Any]
        JSON 파일 내용을 그대로 담은 설정 딕셔너리

    Raises
    ------
    FileNotFoundError
        지정한 경로에 파일이 존재하지 않는 경우
    json.JSONDecodeError
        JSON 형식이 올바르지 않은 경우
    UnicodeDecodeError
        파일 인코딩이 UTF-8이 아닌 경우
    """
    with open(path, "r", encoding="utf-8") as f:
        cfg = json.load(f)
    return cfg