Skip to main content

Secondary encapsulation `logging`, more convenient and fast to create the logger. Use this module can quickly create instances of `logging.Logger` and complete a series of log configuration, make your code cleaner.

Project description

LOGO Release Python Versions License Downloads

gqylpy-log

English | 中文

gqylpy-log is a secondary encapsulation of logging that allows for more convenient and quick creation of loggers. Using the gqylpy_log module, you can rapidly create logging.Logger instances and complete a series of logging configurations, making your code cleaner.

pip3 install gqylpy_log

Using the Built-in Logger

gqylpy_log comes with a built-in logger based on logging.StreamHandler. You can directly call it as follows:

import gqylpy_log as glog

glog.debug(...)
glog.info(...)
glog.warning(...)
glog.error(...)
glog.critical(...)

Its default configuration is as follows:

{
    "level": "NOTSET",
    "formatter": {
        "fmt": "[%(asctime)s] [%(module)s.%(funcName)s.line%(lineno)d] "
               "[%(levelname)s] %(message)s",
        "datefmt": "%F %T"
    },
    "handlers": [{"name": "StreamHandler"}]
}

You can adjust the default logger configuration as needed:

glog.default["level"] = "INFO"

However, please note that the default logger is created the first time a logging method is called. To make changes effective, you must modify the configuration before the first call.

Creating a New Logger

The following example demonstrates how to obtain a logger with three handlers:

import gqylpy_log as glog

log: logging.Logger = glog.__init__(
    "alpha",
    level="DEBUG",
    formatter={"fmt": "[%(asctime)s] [%(levelname)s] %(message)s"},
    handlers=[
        {"name": "StreamHandler"},
        {
            "name": "FileHandler",
            "level": "ERROR",
            "filename": "/var/log/alpha/error.log",
            "encoding": "UTF-8",
            "formatter": {"fmt": "[%(asctime)s] %(message)s", "datefmt": "%c"},
            "options": {"onlyRecordCurrentLevel": True}
        },
        {
            "name": "TimedRotatingFileHandler",
            "level": "INFO",
            "filename": "/var/log/alpha/alpha.log",
            "encoding": "UTF-8",
            "when": "D",
            "interval": 1,
            "backupCount": 7
        }
    ]
)

log.info(...)

Alternatively, if you prefer to always call it through the gqylpy_log module, specify the gname parameter:

glog.__init__(..., gname="alpha")

Please note that specifying the gname parameter will override and permanently disable the default logger.

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

gqylpy_log-2.0.2.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

gqylpy_log-2.0.2-py3-none-any.whl (13.0 kB view details)

Uploaded Python 3

File details

Details for the file gqylpy_log-2.0.2.tar.gz.

File metadata

  • Download URL: gqylpy_log-2.0.2.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.9.19

File hashes

Hashes for gqylpy_log-2.0.2.tar.gz
Algorithm Hash digest
SHA256 400733d407cac37efd1118519ef833683a2d585ff3a2a07c4e17bf61d532d309
MD5 e07e6324a35215e05b47aa54b706eb84
BLAKE2b-256 d7eb938bf08a4d7680efa80e92bba26bf2bc551a39af5b7659666c9b235672c3

See more details on using hashes here.

File details

Details for the file gqylpy_log-2.0.2-py3-none-any.whl.

File metadata

  • Download URL: gqylpy_log-2.0.2-py3-none-any.whl
  • Upload date:
  • Size: 13.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.9.19

File hashes

Hashes for gqylpy_log-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b17f980141d146f5bcc850f3c3d1a293cae2534ff0744c75afa3806cee06a83c
MD5 880cd3c5152168db5fd9743aef4f5f40
BLAKE2b-256 23ed77ff9dc94b6ecf3e2a7f50b28c163678bc7a00f23f5bb16e6da140c2b950

See more details on using hashes here.

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