The documentation is available on Github Pages
The objective of this package is to provide a simple and standard way to configure logging in Python applications, using the standard logging module, and compatible with loguru.
We aim for a batteries-included, no configuration required, delightful out-of-the box experience.
The bundled configuration is opinionated and suits our purposes well, but we recognize your opinion will differ and provide various mechanisms of increasing complexity to tune logging to your liking.
Loggia is not a new Python logger - it's a nice way to configure - and share configuration - for Python's standard logging and as well as loguru.
!!! warning While this package is in an early 0.x release, it's built upon years of development and production usage in various projects.
Loggia as a logging configuration bundle is young, but the configuration
itself is what we most enjoyed working with for some time now.
- Add the
loggiadependency to your project, e.g.: with PDM:- Directly from Pypi:
pdm add loggia - With Git:
pdm add "loggia @ git+ssh://git@github.com/manomanotech/loggia.git"
- Directly from Pypi:
#!python from loggia.logger import initialize; initialize()is a strong starting point- You should call this as early as possible in your application, ideally before any other code is run, for instance by adding it in your main
__init__.pyfile.
- You should call this as early as possible in your application, ideally before any other code is run, for instance by adding it in your main
- Read the Usage docs should you need to tune things.
- Delightful standard logging configuration in
prettyorstructuredmode - Compatibility with
loguru(WIP) - you can keep using Loguru's API as much as you like or need it, while Loggia takes care of all the other standard-logging based loggers. - Configuring
sys.excepthookto properly log uncaught exceptions - Using
logging.captureWarningsto log warnings - Configuring the standard logger and loguru to use the same handlers
- Only one non-optional dependency
- Lean towards being way too typed rather than untyped
- Do not depend on third-party packages (WIP)
- Do not crash unless explicitly asked to - fallback to sensible things, emit a warning, and move on.
We currently support Python 3.9, 3.10, 3.11 and 3.12.
We may drop the support for a Python version before its end of life, to keep the codebase up to date with the latest Python features: i.e.: we will endeavor to support either the last 3 or 4 stable Python releases.
We don't plan to support earlier versions or different runtimes.