Metadata-Version: 2.4
Name: logging-hj3415
Version: 0.1.0
Summary: A logging library package built with Loguru
Keywords: example,demo
Author-email: Hyungjin Kim <hj3415@gmail.com>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Typing :: Typed
License-File: LICENSE
Requires-Dist: loguru>=0.7
Requires-Dist: pytest>=8 ; extra == "dev"
Requires-Dist: pytest-cov>=7.0 ; extra == "dev"
Requires-Dist: ruff>=0.5 ; extra == "dev"
Requires-Dist: mypy>=1.10 ; extra == "dev"
Provides-Extra: dev

# **logging-hj3415**

작은 파이썬 로깅 초기화 유틸입니다.

로컬에선 **사람이 읽기 쉬운 포맷**, 운영/컨테이너에선 **JSON(구조화) 로그**를 간단히 전환할 수 있습니다.

## **설치**

```
pip install logging-hj3415
# 또는 로컬 편집 모드
pip install -e libs/logging-hj3415
```

## **빠른 시작**

```
from logging_hj3415 import setup_logging, get_logger

# 예쁜 콘솔 로그(기본)
setup_logging(service="logging_hj3415", level="DEBUG", json=False)
log = get_logger()
log.info("service started")

# JSON 로그(수집/검색용)
setup_logging(service="logging_hj3415", level="INFO", json=True)
log.info("ready")
```

## **사용 옵션**

- service: 서비스/패키지 식별자(로그 필드에 포함)
    
- level: 최소 레벨 (DEBUG/INFO/WARNING/ERROR/CRITICAL)
    
- json: True면 JSON(serialize) 출력, False면 사람이 읽기 쉬운 포맷


## **환경 변수로 전환(권장)**

```
import os
setup_logging(
    service="logging_hj3415",
    level=os.getenv("LOG_LEVEL", "INFO"),
    json=(os.getenv("LOG_JSON") == "1"),
)
```

```
LOG_JSON=1 
LOG_LEVEL=DEBUG 
python app.py
```

## **라이선스**

MIT
