Package: netlink-logging
netlink-loggingPart of the NetLink Python ToolsA small wrapper around python logging andlogzero.FeaturesLog to a logfile automatically (same name as the top-level script,_input_for console)Additional levels:TRACE(5)VERBOSE(15)SUCCESS(25)Timestamps are in UTC and use format%Y-%m-%d %H:%M:%SUncaught Exceptions are logged asCRITICALInstallationpipinstallnetlink-loggingUsagefromnetlink.loggingimportloggerlogger.trace('A TRACE entry.')logger.debug('A DEBUG entry.')logger.verbose('A VERBOSE entry.')logger.info('An INFO entry.')logger.success('A SUCCESS entry.')logger.warning('A WARNING entry.')logger.error('An ERROR entry.')logger.critical('A CRITICAL entry.')results in[D 2022-02-32 26:27:28 <input>:…] A DEBUG entry.
[V 2022-02-32 26:27:28 <input>:…] A VERBOSE entry.
[I 2022-02-32 26:27:28 <input>:…] An INFO entry.
[S 2022-02-32 26:27:28 <input>:…] A SUCCESS entry.
[W 2022-02-32 26:27:28 <input>:…] A WARNING entry.
[E 2022-02-32 26:27:28 <input>:…] An ERROR entry.
[C 2022-02-32 26:27:28 <input>:…] A CRITICAL entry.Additional Methodsset_fileUseset_fileto change the file that is logged to:logger.set_file([filename, 
                [formatter,] 
                [mode,] 
                [max_bytes,] 
                [backup_count,] 
                [encoding,] 
                [log_level,] 
                [disable_stderr_logger]])Parametersfilename(optional,str)Must be provided, if any other parameter is provided. If not provided, or set toNonelogging to file is disabled.formatter(optional,logging.Formatter)Formatter to use for logging to file. Defaults to[K time module:line number] (message, whereKis the first letter of the logging leveltimeis%Y-%m-%d %H:%M:%Sin UTCmoduleand **line number show the location in codemessageas provided in callmode(optional,str)Mode to open the file with. Defaults toa.max_bytes(optional,int)Size of the logfile when rollover should occur. If set to0, rollover never occurs. Defaults to100 MB.backup_count(optional,int)Number of backups to keep. If set to 0, rollover never occurs. Defaults to5.encoding(optional,str)Used to open the file with that encoding. Defaults toutf-8.log_level(optional,int)Set a custom logging level for the file logger. Defaults to the current logging level.disable_stderr_logger(optional,bool)Should the default stderr logger be disabled. Defaults toFalse.set_levelThe current logging level can be set without additional imports:fromnetlink.loggingimportloggerlogger.set_level(logger.ERROR)enable_fileEnable logging to file, if it was disabled. Takesboolean.disable_fileDisable logging to file.hide_locationHide module name and line number.show_threadingShow thread name.hide_threadingHide thread name.Changes0.1.10Option to show or hide thread nameRoadmapAn additional feature that is considered would logeveryException raised.LicenseMIT LicenseCopyright (c) 2022 Bernhard RadermacherPermission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.