adding warn/quiet mapping to log_level, adding support for passing logging lib int values for levels directly using Cnopts.log_level

Author: byteskeptical

docs/changes.rst

@@ -1,8 +1,13 @@
 Change Log
 ==========
 
-1.1.7 (current, released 2025-2-22)
-------------------------------------
+1.1.8 (current, released 2025-6-13)
+-----------------------------------
+    * added WARN log level to logger, mapped to QUIET in ssh config.
+    * added support for int values in CnOpts.log_level mapped to python logging.
+
+1.1.7 (released 2025-2-22)
+--------------------------
     * bug fix for host key matching servers running on non default ports
 
 1.1.6 (released 2024-10-12)

docs/conf.py

@@ -54,9 +54,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '1.1.7'
+version = '1.1.8'
 # The full version, including alpha/beta/rc tags.
-release = '1.1.7'
+release = '1.1.8'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

pyproject.toml

@@ -46,7 +46,7 @@ keywords = [
 name = 'sftpretty'
 readme = 'README.rst'
 requires-python = '>=3.6'
-version = '1.1.7'
+version = '1.1.8'
 
 [project.scripts]
 sftpretty = 'sftpretty:Connection'

sftpretty/__init__.py

@@ -2,7 +2,7 @@
 from contextlib import contextmanager
 from functools import partial
 from logging import (DEBUG, ERROR, FileHandler, Formatter, getLogger, INFO,
-                     StreamHandler)
+                     StreamHandler, WARN)
 from os import environ, SEEK_END, utime
 from paramiko import (Agent, hostkeys, SFTPClient, SSHConfig, Transport,
                       ConfigParseError, PasswordRequiredException,
@@ -49,7 +49,7 @@ class CnOpts(object):
         True, creates a temporary file used to capture logs. If set to an
         existing filepath, logs will be appended.
     :ivar str log_level: *Default: info* - Set logging level for connection.
-        Choose between debug, error, or info.
+        Choose between debug, error, info, or warn.
 
     :returns: (obj) CnOpts - Connection options object, used for passing
         extended options to a Connection object.
@@ -243,11 +243,16 @@ def _set_authentication(self, password, private_key, private_key_pass):
 
     def _set_logging(self):
         '''Set logging location and level for connection'''
-        level_map = {'debug': DEBUG, 'error': ERROR, 'info': INFO}
+        level_map = {'debug': DEBUG, 'error': ERROR, 'info': INFO:,
+                     'quiet': WARN, 'warn': WARN, 'warning': WARN}
         level = self._config.get('loglevel') or self._cnopts.log_level
-        level = level_map[level.lower().strip('1,2,3')]
 
         try:
+            if not isinstance(level, int):
+                level = level_map[level.lower().strip('1,2,3')]
+            elif level not in [DEBUG, ERROR, INFO, WARN]:
+                raise KeyError
+
             global log
             log = getLogger('SFTPretty')
             if self._cnopts.log:
@@ -269,7 +274,8 @@ def _set_logging(self):
             log.setLevel(level)
         except KeyError:
             raise LoggingException(('Log level must set to one of following: '
-                                    '[debug, error, info].'))
+                                    '[debug, error, info, quiet, warn, '
+                                   f'{DEBUG}, {ERROR}, {INFO}, {WARN}].'))
 
     def _set_username(self, username):
         '''Set the username for the connection. If not passed, then look to