Skip to main content

Easy Django logging with Loguru

Project description

Django Easy Logging

Easy Django logging with Loguru

Loguru is an exceeding easy way to do logging in Python. django-easy-logging makes it exceedingly easy to use Loguru in Django. Once integrated you can using existings Python logging mechanisms which are then funneled into Loguru or you can use the Loguru logging methods.

Install

pip install django-easy-logging

Usage

In your settings.py towards the end of the file add:

from dj_easy_log import load_loguru

load_loguru(globals())

In your other files, use Loguru methods for logging.

from loguru import logger

logger.debug("That's it, beautiful and simple logging!")

logger.info("If you're using Python {}, prefer {feature} of course!", 3.6, feature="f-strings")

Note: Any existing logging is funneled into loguru when using the defualt settings. Loguru is used as a sink as outlined in the docs.

Customization

Log Level

The default log level in DEBUG is INFO. Otherwise the default level is ERROR.

You can override the log level with the env LOGLEVEL.

or

pass in a log level into load_loguru.

Example: load_loguru(globals(), loglevel="WARNING")

Logging Config

The LOGGING config dict is generated automatically or you can pass in your own. The default is created by generate_logging_config

Example: load_loguru(globals(), logging_config=MY_LOGGING_CONFIG)

Configuring Loguru

You can pass in a function that configures Loguru.

Example:

def setup_loguru(logger, settings_dict):
  if not settings_dict['DEBUG']:
    logger.add("django.log", rotation="100 MB")

load_loguru(globals(), configure_func=setup_loguru)

Configuring the Default Format

export LOGURU_FORMAT="<blue>{time:HH:mm:ss}</blue> | <red>{name}:{line}</red> | {level} - {message}"

See the record dict documention for other available formatting options. And see color markups for more info on coloring and markups.

Shameless Plugs

I built this library originally for the NeutronSync Service. So if you would like to support this project please support the service with a subscription to NeutronSync or a donation to the open source libraries.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-easy-logging-0.70.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

django_easy_logging-0.70-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

Details for the file django-easy-logging-0.70.tar.gz.

File metadata

  • Download URL: django-easy-logging-0.70.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.12.3 CPython/3.10.12

File hashes

Hashes for django-easy-logging-0.70.tar.gz
Algorithm Hash digest
SHA256 c318cb34ead1b75483842cae84fcc0dc56dc2fa3bf3e54dd6fba5634732a15cf
MD5 12d17e91d57784b1ebfb7fc158686699
BLAKE2b-256 315c1db04dc0c3c33a6f9614b906dcedca71193612932f6649bb6ffec45cb6d7

See more details on using hashes here.

Provenance

File details

Details for the file django_easy_logging-0.70-py3-none-any.whl.

File metadata

File hashes

Hashes for django_easy_logging-0.70-py3-none-any.whl
Algorithm Hash digest
SHA256 10dd64047bc32df31f3fafdc29e307f797faeb1a9eef27f6c4d3ec03006802ac
MD5 bccaeb4af945d6bb21b2e70e4cd7a492
BLAKE2b-256 7154c295b61448d7af9c095dd3bf646a7167633e4ab23baeed8382c13ff3839c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page