:right-sidebar: True

MessageFlags
===================================================================

.. currentmodule:: gi.repository.Soup





.. class:: MessageFlags
   :no-contents-entry:






Various flags that can be set on a :obj:`~gi.repository.Soup.Message` to alter its
behavior.













Fields
------

.. rst-class:: interim-class

.. class:: MessageFlags
   :no-index:
   

   .. attribute:: COLLECT_METRICS

      Metrics will be collected for this message.







   .. attribute:: DO_NOT_USE_AUTH_CACHE

      The :obj:`~gi.repository.Soup.AuthManager` should not use
      the credentials cache for this message, neither to use cached credentials
      to automatically authenticate this message nor to cache the credentials
      after the message is successfully authenticated. This applies to both server
      and proxy authentication. Note that :obj:`~gi.repository.Soup.Message.signals.authenticate` signal will
      be emitted, if you want to disable authentication for a message use
      :obj:`~gi.repository.Message.disable_feature` passing ``SOUP_TYPE_AUTH_MANAGER`` instead.







   .. attribute:: IDEMPOTENT

      The message is considered idempotent,
      regardless its :obj:`~gi.repository.Soup.Message.props.method`, and allows reuse of existing
      idle connections, instead of always requiring a new one, unless
      ``SOUP_MESSAGE_NEW_CONNECTION`` is set.







   .. attribute:: NEW_CONNECTION

      Requests that the message should be
      sent on a newly-created connection, not reusing an existing
      persistent connection. Note that messages with non-idempotent
      :obj:`~gi.repository.Soup.Message.props.method`'s behave this way by default, unless
      ``SOUP_MESSAGE_IDEMPOTENT`` is set.







   .. attribute:: NO_REDIRECT

      The session should not follow redirect
      (3xx) responses received by this message.