docs: def set_up_logging(log_filename: str = "log", verbosity: int = 0) ->logging.Logger:
      """Set up proper logging."""
      LOG.setLevel(logging.DEBUG)
  
      # Log everything verbosely to a file.
      file_handler = RotatingFileHandler(filename=log_filename, maxBytes=1024000000, backupCount=10)
      verbose_form = logging.Formatter(fmt="%(asctime)s - %(levelname)s - %(module)s - %(message)s")
      file_handler.setFormatter(verbose_form)
      file_handler.setLevel(logging.DEBUG)
      LOG.addHandler(file_handler)
  
      # Provide a stdout handler logging at INFO.
      stream_handler = logging.StreamHandler(sys.stdout)
      simple_form = logging.Formatter(fmt="%(message)s")
      stream_handler.setFormatter(simple_form)
  
      if verbosity > 0:
          stream_handler.setLevel(logging.DEBUG)
      else:
          stream_handler.setLevel(logging.INFO)
  
      LOG.addHandler(stream_handler)
  
      return LOG