Repolode
Delgan

Delgan/loguru

標準のlogging設定を単一のloggerに置き換え、ファイルのローテーション、カラー出力、構造化ログを提供するPythonロギングライブラリ。

スター
24,153
フォーク
828
未解決の Issue
261
最終コミット
6 日前

これは何?

Loguruは、標準のloggingモジュールに伴う定型コードをなくすことを目指したPythonロギングライブラリです。あらかじめ設定済みのloggerを1つ提供し、何もしなくてもstderrに出力するため、importするだけですぐにログを記録できます。追加のsink、フォーマット、フィルター、レベルはすべて1つの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スクリプトへログ機能を追加する
  • 長時間稼働するサービスで、ローテーションおよび圧縮されるログファイルを出力する
  • スレッド内で発生した例外を捕捉し、ログに記録する
  • ライブラリはデフォルトでログを出さず、アプリケーション側から有効化できるようにする

クイックスタート

  1. 1

    PyPIからloguruをインストールする

    pip install loguru
  2. 2

    すぐに使えるロガーをインポートして、メッセージをログに記録する

収録されている特集

トピック

よくある質問

loguru とは?
標準のlogging設定を単一のloggerに置き換え、ファイルのローテーション、カラー出力、構造化ログを提供するPythonロギングライブラリ。 Loguruは、標準のloggingモジュールに伴う定型コードをなくすことを目指したPythonロギングライブラリです。あらかじめ設定済みのloggerを1つ提供し、何もしなくてもstderrに出力するため、importするだけですぐにログを記録できます。追加のsink、フォーマット、フィルター、レベルはすべて1つのadd()関数で設定できます。
loguru は無料で使えますか?ライセンスは?
loguru は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
loguru は今もメンテナンスされていますか?
活発にメンテナンス中。loguru の最終コミットは 2026年10月18日 です。
loguru は何に使えますか?
loggerの設定を書かずにPythonスクリプトへログ機能を追加する 長時間稼働するサービスで、ローテーションおよび圧縮されるログファイルを出力する スレッド内で発生した例外を捕捉し、ログに記録する ライブラリはデフォルトでログを出さず、アプリケーション側から有効化できるようにする
loguru のインストール方法は?
PyPIからloguruをインストールする: pip install loguru すぐに使えるロガーをインポートして、メッセージをログに記録する
loguru はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Delgan/loguru

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト