Flags¶

Details¶

class Soup.Cacheability(value)¶

Bases: GObject.GFlags

class Soup.Expectation(value)¶

Bases: GObject.GFlags

Represents the parsed value of the “Expect” header.

class Soup.MessageFlags(value)¶

Bases: GObject.GFlags

Various flags that can be set on a Soup.Message to alter its behavior.

IDEMPOTENT = 128¶: The message is considered idempotent, regardless its Soup.Message :method, and allows reuse of existing idle connections, instead of always requiring a new one, unless Soup.MessageFlags.NEW_CONNECTION is set.

CONTENT_DECODED = 16¶: Set by Soup.ContentDecoder to indicate that it has removed the Content-Encoding on a message (and so headers such as Content-Length may no longer accurately describe the body).

NO_REDIRECT = 2¶: The session should not follow redirect (3xx) responses received by this message.

IGNORE_CONNECTION_LIMITS = 256¶: Request that a new connection is created for the message if there aren’t idle connections available and it’s not possible to create new connections due to any of the connection limits has been reached. If a dedicated connection is eventually created for this message, it will be dropped when the message finishes.

New in version 2.50.

CERTIFICATE_TRUSTED = 32¶: if set after an https response has been received, indicates that the server’s SSL certificate is trusted according to the session’s CA.

CAN_REBUILD = 4¶: The caller will rebuild the request body if the message is restarted; see Soup.MessageBody.set_accumulate() for more details.

DO_NOT_USE_AUTH_CACHE = 512¶: The 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 Soup.Session ::authenticate signal will be emitted, if you want to disable authentication for a message use Soup.Message.disable_feature() passing #SOUP_TYPE_AUTH_MANAGER instead.

New in version 2.58.

NEW_CONNECTION = 64¶: Requests that the message should be sent on a newly-created connection, not reusing an existing persistent connection. Note that messages with non-idempotent Soup.Message :method s behave this way by default, unless Soup.MessageFlags.IDEMPOTENT is set.

OVERWRITE_CHUNKS = 8¶: Deprecated: equivalent to calling Soup.MessageBody.set_accumulate() on the incoming message body (ie, #SoupMessage:response_body for a client-side request), passing False.

class Soup.ServerListenOptions(value)¶

Bases: GObject.GFlags

Options to pass to Soup.Server.listen(), etc.

Soup.ServerListenOptions.IPV4_ONLY and Soup.ServerListenOptions.IPV6_ONLY only make sense with Soup.Server.listen_all() and Soup.Server.listen_local(), not plain Soup.Server.listen() (which simply listens on whatever kind of socket you give it). And you cannot specify both of them in a single call.

New in version 2.48.