3
3
< head >
4
4
< meta charset ="utf-8 ">
5
5
< meta name ="viewport " content ="width=device-width, initial-scale=1, minimum-scale=1 " />
6
- < meta name ="generator " content ="pdoc 0.7.4 " />
6
+ < meta name ="generator " content ="pdoc 0.7.5 " />
7
7
< title > mbed_tools_lib.logging API documentation</ title >
8
8
< meta name ="description " content ="Helpers for logging errors according to severity of the exception. " />
9
9
< link href ='https://cdnjs.cloudflare.com/ajax/libs/normalize/8.0.0/normalize.min.css ' rel ='stylesheet '>
@@ -31,15 +31,15 @@ <h1 class="title">Module <code>mbed_tools_lib.logging</code></h1>
31
31
LOGGING_FORMAT = "%(levelname)s: %(message)s"
32
32
33
33
34
- def log_exception(logger: logging.Logger, exception: Exception) -> None:
34
+ def log_exception(logger: logging.Logger, exception: Exception, show_traceback: bool = False ) -> None:
35
35
"""Logs an exception in both normal and verbose forms.
36
36
37
37
Args:
38
38
logger: logger
39
39
exception: exception to log
40
+ show_traceback: show the full traceback.
40
41
"""
41
- logger.error(exception)
42
- logger.debug(exception, exc_info=True)
42
+ logger.error(exception, exc_info=show_traceback)
43
43
44
44
45
45
def set_log_level(verbose_count: int) -> None:
@@ -67,7 +67,7 @@ <h1 class="title">Module <code>mbed_tools_lib.logging</code></h1>
67
67
< h2 class ="section-title " id ="header-functions "> Functions</ h2 >
68
68
< dl >
69
69
< dt id ="mbed_tools_lib.logging.log_exception "> < code class ="name flex ">
70
- < span > def < span class ="ident "> log_exception</ span > </ span > (< span > logger:Β logging.Logger, exception:Β Exception) -> Β NoneType</ span >
70
+ < span > def < span class ="ident "> log_exception</ span > </ span > (< span > logger:Β logging.Logger, exception:Β Exception, show_traceback:Β boolΒ =Β False ) -> Β NoneType</ span >
71
71
</ code > </ dt >
72
72
< dd >
73
73
< section class ="desc "> < p > Logs an exception in both normal and verbose forms.</ p >
@@ -77,20 +77,22 @@ <h2 id="args">Args</h2>
77
77
< dd > logger</ dd >
78
78
< dt > < strong > < code > exception</ code > </ strong > </ dt >
79
79
< dd > exception to log</ dd >
80
+ < dt > < strong > < code > show_traceback</ code > </ strong > </ dt >
81
+ < dd > show the full traceback.</ dd >
80
82
</ dl > </ section >
81
83
< details class ="source ">
82
84
< summary >
83
85
< span > Expand source code</ span >
84
86
</ summary >
85
- < pre > < code class ="python "> def log_exception(logger: logging.Logger, exception: Exception) -> None:
87
+ < pre > < code class ="python "> def log_exception(logger: logging.Logger, exception: Exception, show_traceback: bool = False ) -> None:
86
88
"""Logs an exception in both normal and verbose forms.
87
89
88
90
Args:
89
91
logger: logger
90
92
exception: exception to log
93
+ show_traceback: show the full traceback.
91
94
"""
92
- logger.error(exception)
93
- logger.debug(exception, exc_info=True)</ code > </ pre >
95
+ logger.error(exception, exc_info=show_traceback)</ code > </ pre >
94
96
</ details >
95
97
</ dd >
96
98
< dt id ="mbed_tools_lib.logging.set_log_level "> < code class ="name flex ">
@@ -150,7 +152,7 @@ <h1>Index</h1>
150
152
</ nav >
151
153
</ main >
152
154
< footer id ="footer ">
153
- < p > Generated by < a href ="https://pdoc3.github.io/pdoc "> < cite > pdoc</ cite > 0.7.4 </ a > .</ p >
155
+ < p > Generated by < a href ="https://pdoc3.github.io/pdoc "> < cite > pdoc</ cite > 0.7.5 </ a > .</ p >
154
156
</ footer >
155
157
< script src ="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js "> </ script >
156
158
< script > hljs . initHighlightingOnLoad ( ) </ script >
0 commit comments