Skip to main content

zangetsu-logger

zangetsu のロギング関連のライブラリ

このライブラリをインストールして使用する方法

pip install zangetsu-logger

環境変数の設定

ロギング設定は環境変数で制御できます。.envファイルやexportコマンドで以下の環境変数を設定できます:

zangetsu_LOG_DIR=<ログファイルの出力ディレクトリ>

ライブラリの更新

pip install --upgrade zangetsu-logger

使い方

基本的な使用方法

from zangetsu_logger import initialize

# 基本的な初期化
logger = initialize()
logger.info("アプリケーションを開始しました")

# カスタム設定での初期化する場合
logger = initialize(
    config_path='/path/to/custom/config.yaml',  # カスタム設定がある場合
    log_level='DEBUG',  # ロギングレベルを DEBUG に設定
    app_name='my_app',  # アプリケーション名を指定
    enable_file_logging=True,  # ファイルへのログ出力を有効化
    log_dir='/path/to/logs'  # デフォルトはカレントディレクトリ
)

名前付きロガーの取得

from zangetsu_logger import get_logger

# モジュール固有のロガーを取得
module_logger = get_logger('my_module')
module_logger.debug("デバッグメッセージ")

initialize() 関数の引数詳細

引数名 デフォルト値 説明 設定例と効果
config_path None カスタム設定ファイルのパス /path/to/logging_config.yaml を指定すると、デフォルト設定の代わりにそのファイルから設定を読み込みます
log_level None ロギングレベル 'DEBUG': すべてのログを出力
'INFO': 情報レベル以上のログを出力
'WARNING': 警告レベル以上のログを出力
'ERROR': エラーレベルのログのみ出力
app_name None アプリケーション名 指定しない場合、呼び出し元のモジュール名が使用されます。特定の名前を付けることで、ロガーを明示的に識別できます
enable_file_logging False ファイルへのログ出力を有効化 True: zangetsu_app.log と zangetsu_error.log にログを出力
False: コンソール出力のみ
log_dir None ログファイルの出力ディレクトリ /var/log/myapp などを指定すると、指定したディレクトリにログファイルを出力

開発者向け

ライブラリ更新手順

# pyproject.toml
version = "x.x.x" # バージョンを更新
git add .
git commit -m "バージョンを更新"
git tag x.x.x
git push origin master --tags

Metadata

Release files for zangetsu-logger 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zangetsu-logger 0.1.1
File Size Uploaded
zangetsu_logger-0.1.1.tar.gz 10.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for zangetsu-logger 0.1.1
File Interpreter ABI Platform
zangetsu_logger-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 22.9 kB

Release files / zangetsu_logger-0.1.1.tar.gz

Download URL zangetsu_logger-0.1.1.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
04333f34b5910ea9076d546b675cd434e0b2fecb6d64ffd19d441157abb0e585
BLAKE2b-256 checksum
How to use checksums
23aa212574dd4ac94f827ebd3bc0214a1f6ca9927a9db7df1e4bec7b45e6ec3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.11

Release files / zangetsu_logger-0.1.1-py3-none-any.whl

Download URL zangetsu_logger-0.1.1-py3-none-any.whl
Size 12.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c4a8b3ba7648a2bcf3bd3848e1f98d024d2d9dc6f0da04cf1353c6f433962116
BLAKE2b-256 checksum
How to use checksums
f362e665c0280eb528ced9386da91c2901e9cccc94d095d3a28172f37077dd7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.11

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page