gws.base.ows.client.request

HTTP requests to OWS services.

Source code: gws.base.ows.client.request

Module Contents

class gws.base.ows.client.request.Args(*args, **kwargs)

Bases: gws.Data

Arguments for an OWS request.

headers: dict

HTTP headers.

method: gws.RequestMethod

Request method, GET by default.

params: dict

Additional request parameters.

protocol: gws.OwsProtocol

Service protocol, sent as SERVICE.

url: str

Service URL.

verb: gws.OwsVerb

Request type, sent as REQUEST.

version: str

Service version, sent as VERSION if not empty.

gws.base.ows.client.request.get(args: Args, **kwargs) → gws.lib.net.HTTPResponse

Send an OWS request and return the raw response.

Parameters:

• args – Request arguments.

• **kwargs – Options for gws.lib.net.http_request.

Returns:

The HTTP response.

Raises:

gws.ExternalServiceError – If the service returns an exception document or the request fails.

gws.base.ows.client.request.get_text(args: Args, **kwargs) → str

Send an OWS request and return the response text.

Parameters:

• args – Request arguments.

• **kwargs – Options for gws.lib.net.http_request.

Returns:

The response text.

Raises:

gws.ExternalServiceError – If the service returns an exception document or the request fails.

gws.base.ows.client.request.get_url(url: str, **kwargs) → gws.lib.net.HTTPResponse

Send an HTTP request to an OWS service.

The response is checked for an OWS exception document, regardless of the HTTP status, since some servers return errors with status 200.

Parameters:

• url – Request URL.

• **kwargs – Options for gws.lib.net.http_request.

Returns:

The HTTP response.

Raises:

gws.ExternalServiceError – If the service returns an exception document or the request fails.