BaseClient

All service clients support the low level interface, provided by the BaseClient, from which all client types inherit.

A client object contains a transport, an object responsible for sending requests, encoding data, and handling potential retries. It also may include an optional authorizer, an object responsible for handling token authentication for requests.

BaseClient

class globus_sdk.BaseClient(*, environment: Optional[str] = None, base_url: Optional[str] = None, authorizer: Optional[globus_sdk.authorizers.base.GlobusAuthorizer] = None, app_name: Optional[str] = None, transport_params: Optional[Dict] = None)[source]

Abstract base class for clients with error handling for Globus APIs.

Parameters
  • authorizer (GlobusAuthorizer) – A GlobusAuthorizer which will generate Authorization headers

  • app_name (str) – Optional “nice name” for the application. Has no bearing on the semantics of client actions. It is just passed as part of the User-Agent string, and may be useful when debugging issues with the Globus Team

  • transport_params (dict) – Options to pass to the transport for this client

All other parameters are for internal use and should be ignored.

scopes: Optional[globus_sdk.scopes.ScopeBuilder] = None

the scopes for this client may be present as a ScopeBuilder

get(path: str, *, query_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict] = None) globus_sdk.response.GlobusHTTPResponse[source]

Make a GET request to the specified path.

See request() for details on the various parameters.

Returns

GlobusHTTPResponse object

post(path: str, *, query_params: Optional[Dict[str, Any]] = None, data: Union[None, Dict, globus_sdk.utils.PayloadWrapper] = None, headers: Optional[Dict] = None, encoding: Optional[str] = None) globus_sdk.response.GlobusHTTPResponse[source]

Make a POST request to the specified path.

See request() for details on the various parameters.

Returns

GlobusHTTPResponse object

delete(path: str, *, query_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict] = None) globus_sdk.response.GlobusHTTPResponse[source]

Make a DELETE request to the specified path.

See request() for details on the various parameters.

Returns

GlobusHTTPResponse object

put(path: str, *, query_params: Optional[Dict[str, Any]] = None, data: Union[None, Dict, globus_sdk.utils.PayloadWrapper] = None, headers: Optional[Dict] = None, encoding: Optional[str] = None) globus_sdk.response.GlobusHTTPResponse[source]

Make a PUT request to the specified path.

See request() for details on the various parameters.

Returns

GlobusHTTPResponse object

patch(path: str, *, query_params: Optional[Dict[str, Any]] = None, data: Union[None, Dict, globus_sdk.utils.PayloadWrapper] = None, headers: Optional[Dict] = None, encoding: Optional[str] = None) globus_sdk.response.GlobusHTTPResponse[source]

Make a PATCH request to the specified path.

See request() for details on the various parameters.

Returns

GlobusHTTPResponse object

request(method: str, path: str, *, query_params: Optional[Dict[str, Any]] = None, data: Union[None, Dict, globus_sdk.utils.PayloadWrapper] = None, headers: Optional[Dict] = None, encoding: Optional[str] = None) globus_sdk.response.GlobusHTTPResponse[source]

Send an HTTP request

Parameters
  • method (str) – HTTP request method, as an all caps string

  • path (str) – Path for the request, with or without leading slash

  • query_params (dict, optional) – Parameters to be encoded as a query string

  • headers (dict) – HTTP headers to add to the request

  • data (dict or str) – Data to send as the request body. May pass through encoding.

  • encoding (str) – A way to encode request data. “json”, “form”, and “text” are all valid values. Custom encodings can be used only if they are registered with the transport. By default, strings get “text” behavior and all other objects get “json”.

Returns

GlobusHTTPResponse object