docs: def set_basic(self, realm='authentication required'):
          """Clear the auth info and enable basic auth."""
          dict.clear(self)
          dict.update(self, {'__auth_type__': 'basic', 'realm': realm})
          if self.on_update:
              self.on_update(self)