터미널에서 보기 좋은 출력을 제공하고, 필드 우선 구조의 JSON과 비밀 정보 마스킹을 지원하며 런타임 의존성이 없는 범용 TypeScript 및 JavaScript 로거입니다.
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
PyPI에서 loguru를 설치합니다
pip install loguru - 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 통계는 매일 갱신됩니다.
관련 프로젝트
Deno, Node.js, Bun, 브라우저, 엣지 함수에서 실행되는 JavaScript 및 TypeScript용 무의존성 로깅 라이브러리입니다.
macOS, iOS, tvOS, watchOS, visionOS 등 Apple 플랫폼용 로깅 프레임워크로, 콘솔·파일·커스텀 백엔드 같은 여러 로거에 로그 메시지를 전달합니다.
Go용 빠르고 구조화된 레벨 로깅 라이브러리로, 할당이 없는 Logger와 유연한 SugaredLogger API를 제공합니다.
PSR-3를 구현한 PHP 로깅 라이브러리로, 로그를 파일, 소켓, 이메일, 데이터베이스 및 다양한 웹 서비스로 보냅니다.
확장 가능한 포매터와 훅을 제공하는 Go용 구조화 로거로, API 호환성을 갖췄으며 현재는 유지보수 모드입니다.