a Unit Testing Framework for C and C++ - Cutter

Convenience HTTP client API

Convenience HTTP client API — API to work as HTTP client.

Properties

gboolean async Read / Write

Object Hierarchy

    GObject
    ╰── SoupCutClient

Description

SoupCutClient works as a HTTP client. It accepts multiple requests and responses are managed by SoupCutClient. SoupCutClient related assertions are also provided.

Functions

soupcut_client_new ()

SoupCutClient *
soupcut_client_new (void);

Creates and returns a new SoupCutClient

Returns

a new SoupCutClient.

Since: 1.0.8


soupcut_client_set_base ()

void
soupcut_client_set_base (SoupCutClient *client,
                         const gchar *uri);

Set uri as a base uri of client .

Parameters

client

a SoupCutClient.

 

uri

a base uri.

 

Since: 1.0.8


soupcut_client_send_message ()

guint
soupcut_client_send_message (SoupCutClient *client,
                             SoupMessage *message);

Send message with client . client remebers all the messages it sent.

Parameters

client

a SoupCutClient.

 

message

a SoupMessage.

 

Returns

a status code of the response.

Since: 1.0.8


soupcut_client_get ()

guint
soupcut_client_get (SoupCutClient *client,
                    const gchar *uri,
                    const gchar *first_query_name,
                    ...);

Send a GET request to uri with queries. If the base URI of client is set by soupcut_client_set_base(), the destination URI is composed of the base URI and uri . If not, uri must be a fully qualified URI.

Parameters

client

a SoupCutClient.

 

uri

an URI string.

 

first_query_name

the name of the first query parameter.

 

...

pairs of query parameter names and values, starting with first_query_name , terminated by NULL

 

Returns

a status code of the response.

Since: 1.0.8


soupcut_client_get_n_messages ()

guint
soupcut_client_get_n_messages (SoupCutClient *client);

Returns the number of messages client sent.

Parameters

client

a SoupCutClient.

 

Returns

the number of messages.

Since: 1.0.8


soupcut_client_get_latest_message ()

SoupMessage *
soupcut_client_get_latest_message (SoupCutClient *client);

Returns the latest SoupMessage client sent.

Parameters

client

a SoupCutClient.

 

Returns

the latest SoupMessage.

Since: 1.0.8


soupcut_client_get_async_context ()

GMainContext *
soupcut_client_get_async_context (SoupCutClient *client);

Returns the asynch_context of client .

Parameters

client

a SoupCutClient.

 

Returns

a GMainContext of client , which may be NULL.

Since: 1.0.8

Types and Values

Property Details

The “async” property

  “async”                    gboolean

True if the session is asynchronous.

Flags: Read / Write

Default value: FALSE