Setting Up Logging

gd.py uses logging module to log different information.

By default, it is required to setup the logging by hand, however, gd.py provides a simple way to set up logging all messages into the console:

import gd
gd.setup_logging()

As it can be seen, nothing is too hard.

gd.setup_logging(level: int = 10, *, stream: Any = None, file: Any = None, formatter: Optional[str] = None) → None

Function that sets up logs of the module.

Parameters

• level (int) – Level to set.

• stream (Any) – Stream to log messages into. stderr by default.

• file (Any) – File to log messages to. If not given, messages are logged into the stream.

• formatter (str) – Formatter to use. [LEVEL] (time) {gd.module}: Message by default.

If something more specific is required, things can get a bit harder.

Let’s suppose it is required to write all the warnings/errors and critical messages into a file, for instance, geometry_dash.log:

import logging
import gd

log = gd.log  # choose log we need to set handler to

# configure handler
handler = logging.FileHandler('geometry_dash.log')  # for logging in files

# set format of displaying
handler.setFormatter(
    logging.Formatter('[%(levelname)s] (%(name)s): %(message)s')
)

# now displayed as [LEVEL] (gd.some_module): Some message here.

log.addHandler(handler)  # add created handler
log.setLevel(logging.WARNING)  #  only warnings/errors/critical will be displayed

See logging documentation for more information about handling loggers.