docs: def add_logging_level(name, value, method_name=None):
      ''' Comprehensively adds a new logging level to the ``logging`` module and
          the currently configured logging class.
  
          Derived from: https://stackoverflow.com/a/35804945/450917
      '''
      if not method_name:
          method_name = name.lower()
  
      # set levels
      logging.addLevelName(value, name)
      setattr(logging, name, value)
      level_map[name.lower()] = value
  
      if value == getattr(logging, 'EXCEPT', None):  # needs traceback added
          def logForLevel(self, message='', *args, **kwargs):
              if self.isEnabledFor(value):
                  message = (message + ' ▾\n').lstrip() + traceback.format_exc()
                  self._log(value, message, args, **kwargs)
      else:
          def logForLevel(self, message, *args, **kwargs):
              if self.isEnabledFor(value):
                  self._log(value, message, args, **kwargs)
  
      def logToRoot(message, *args, **kwargs):  # may not need
          logging.log(value, message, *args, **kwargs)
  
      # set functions
      setattr(logging.getLoggerClass(), method_name, logForLevel)
      setattr(logging, method_name, logToRoot)