renamed python-logging
This commit is contained in:
@@ -0,0 +1,24 @@
|
||||
# Python Logging Source References
|
||||
|
||||
Use these official Python docs when applying the Python logging skill.
|
||||
|
||||
## Core Documentation
|
||||
|
||||
!!! info "Core documentation"
|
||||
- [Logging HOWTO](https://docs.python.org/3/howto/logging.html)
|
||||
- [Logging Cookbook](https://docs.python.org/3/howto/logging-cookbook.html)
|
||||
- [logging API reference](https://docs.python.org/3/library/logging.html)
|
||||
- [logging.config reference](https://docs.python.org/3/library/logging.config.html)
|
||||
|
||||
## Configuration And dictConfig
|
||||
|
||||
!!! info "dictConfig references"
|
||||
- [Dictionary schema details](https://docs.python.org/3/library/logging.config.html#logging-config-dictschema) for `version`, formatters, handlers, loggers, and root.
|
||||
- [`logging.config.dictConfig`](https://docs.python.org/3/library/logging.config.html#logging.config.dictConfig) function reference.
|
||||
|
||||
## Practical Notes
|
||||
- Prefer module loggers created with `logging.getLogger(__name__)`.
|
||||
- Let applications configure handlers and formatters; libraries should emit logs without taking over routing.
|
||||
- Use `basicConfig` for simple scripts and `dictConfig` for centralized application configuration.
|
||||
- Explicitly set `disable_existing_loggers: False` in `dictConfig` unless disabling existing non-root loggers is intentional.
|
||||
- Use queue-based handlers when slow handlers would block async, threaded, or high-volume code paths.
|
||||
Reference in New Issue
Block a user