Repolode
Delgan

Delgan/loguru

표준 logging 설정 대신 단일 logger로 파일 로테이션, 컬러 출력, 구조화된 로그를 제공하는 Python 로깅 라이브러리입니다.

스타
24,153
포크
828
열린 이슈
261
마지막 커밋
6일 전

어떤 프로젝트인가요?

Loguru는 표준 logging 모듈의 반복적인 설정 코드를 줄이는 데 초점을 둔 Python 로깅 라이브러리입니다. 미리 설정된 logger 하나를 제공하며 기본적으로 stderr에 기록하므로, import 한 번으로 바로 로깅을 시작할 수 있습니다. 추가 sink, 포맷, 필터, 레벨은 모두 단일 add() 함수로 설정합니다.

파일 로깅은 크기, 시간 또는 보관 기간에 따른 로테이션과 보존 기간이 지난 로그 정리, 파일을 닫을 때의 압축을 지원합니다. 또한 중괄호 스타일 문자열 포매팅, 컬러 출력, 변수 값을 포함한 예외 스택 트레이스, 스레드 안전 및 큐 기반 멀티프로세스 안전 sink를 제공합니다. bind() 또는 contextualize()로 컨텍스트를 추가할 수 있고, 메시지를 JSON으로 직렬화할 수도 있습니다.

Loguru에는 표준 logging과의 호환성 도우미가 포함되어 있어 기존 logging.Handler 객체의 로그를 Loguru sink로 보내거나, Loguru 메시지를 표준 모듈로 전달할 수 있습니다. Python 3.5 이상과 PyPy를 지원합니다.

핵심 기능

  • 01설정 코드 없이 바로 사용할 수 있는 사전 설정 logger
  • 02sink, 포맷, 필터, 레벨을 관리하는 단일 add() 함수
  • 03파일 로테이션, 보존 및 압축 옵션
  • 04컬러 터미널 출력과 변수 값이 포함된 전체 예외 트레이스
  • 05스레드 안전 sink 및 큐 기반 멀티프로세스 안전 로깅
  • 06Python 표준 logging 모듈과 양방향 연동

활용 사례

  • logger 설정을 작성하지 않고 Python 스크립트에 로깅 추가
  • 장시간 실행되는 서비스의 로그 파일 로테이션 및 압축
  • 스레드에서 발생한 예외를 캡처해 로그에 기록
  • 기본적으로는 조용하게 동작하면서 애플리케이션에서 로그를 활성화할 수 있는 Python 라이브러리 만들기

빠른 시작

  1. 1

    PyPI에서 loguru를 설치합니다

    pip install loguru
  2. 2

    바로 사용할 수 있는 로거를 가져와 메시지를 기록합니다

포함된 컬렉션

토픽

자주 묻는 질문

loguru은(는) 무엇인가요?
표준 logging 설정 대신 단일 logger로 파일 로테이션, 컬러 출력, 구조화된 로그를 제공하는 Python 로깅 라이브러리입니다. Loguru는 표준 logging 모듈의 반복적인 설정 코드를 줄이는 데 초점을 둔 Python 로깅 라이브러리입니다. 미리 설정된 logger 하나를 제공하며 기본적으로 stderr에 기록하므로, import 한 번으로 바로 로깅을 시작할 수 있습니다. 추가 sink, 포맷, 필터, 레벨은 모두 단일 add() 함수로 설정합니다.
loguru은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
loguru은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
loguru은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. loguru의 마지막 커밋은 2026년 10월 18일입니다.
loguru은(는) 어디에 사용할 수 있나요?
logger 설정을 작성하지 않고 Python 스크립트에 로깅 추가 장시간 실행되는 서비스의 로그 파일 로테이션 및 압축 스레드에서 발생한 예외를 캡처해 로그에 기록 기본적으로는 조용하게 동작하면서 애플리케이션에서 로그를 활성화할 수 있는 Python 라이브러리 만들기
loguru는 어떻게 설치하나요?
PyPI에서 loguru를 설치합니다: pip install loguru 바로 사용할 수 있는 로거를 가져와 메시지를 기록합니다
loguru은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Delgan/loguru

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트