diff options
Diffstat (limited to 'Doc/library/logging.rst')
-rw-r--r-- | Doc/library/logging.rst | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 2bfa8a1..103bbcf 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -63,12 +63,13 @@ If you run *myapp.py*, you should see this in *myapp.log*: INFO:mylib:Doing something INFO:__main__:Finished -The key features of this idiomatic usage is that the majority of code is simply +The key feature of this idiomatic usage is that the majority of code is simply creating a module level logger with ``getLogger(__name__)``, and using that -logger to do any needed logging. This is concise while allowing downstream code -fine grained control if needed. Logged messages to the module-level logger get -forwarded up to handlers of loggers in higher-level modules, all the way up to -the root logger; for this reason this approach is known as hierarchical logging. +logger to do any needed logging. This is concise, while allowing downstream +code fine-grained control if needed. Logged messages to the module-level logger +get forwarded to handlers of loggers in higher-level modules, all the way up to +the highest-level logger known as the root logger; this approach is known as +hierarchical logging. For logging to be useful, it needs to be configured: setting the levels and destinations for each logger, potentially changing how specific modules log, @@ -82,8 +83,8 @@ The module provides a lot of functionality and flexibility. If you are unfamiliar with logging, the best way to get to grips with it is to view the tutorials (**see the links above and on the right**). -The basic classes defined by the module, together with their functions, are -listed below. +The basic classes defined by the module, together with their attributes and +methods, are listed in the sections below. * Loggers expose the interface that application code directly uses. * Handlers send the log records (created by loggers) to the appropriate |