composer package

Submodules

composer.http_client module

composer.http_client.api_url(api_version, url)[source]

Return the versioned path to the API route

Parameters:
  • api_version (str) – The version of the API to talk to. eg. “0”
  • url (str) – The API route to talk to
Returns:

The full url to use for the route and API version

Return type:

str

composer.http_client.append_query(url, query)[source]

Add a query argument to a URL

The query should be of the form “param1=what&param2=ever”, i.e., no leading ‘?’. The new query data will be appended to any existing query string.

Parameters:
  • url (str) – The original URL
  • query (str) – The query to append
Returns:

The new URL with the query argument included

Return type:

str

composer.http_client.delete_url_json(socket_path, url)[source]

Send a DELETE request to the url and return JSON response

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to send DELETE to
Returns:

The json response from the server

Return type:

dict

composer.http_client.download_file(socket_path, url, progress=True)[source]

Download a file, saving it to the CWD with the included filename

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to send POST to
composer.http_client.get_filename(headers)[source]

Get the filename from the response header

Parameters:response (Response) – The urllib3 response object
Raises:RuntimeError if it cannot find a filename in the header
Returns:Filename from content-disposition header
Return type:str
composer.http_client.get_url_json(socket_path, url)[source]

Return the JSON results of a GET request

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to request
Returns:

The json response from the server

Return type:

dict

composer.http_client.get_url_json_unlimited(socket_path, url, total_fn=None)[source]

Return the JSON results of a GET request

For URLs that use offset/limit arguments, this command will fetch all results for the given request.

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to request
Returns:

The json response from the server

Return type:

dict

composer.http_client.get_url_raw(socket_path, url)[source]

Return the raw results of a GET request

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to request
Returns:

The raw response from the server

Return type:

str

composer.http_client.post_url(socket_path, url, body)[source]

POST raw data to the URL

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to send POST to
  • body (str) – The data for the body of the POST
Returns:

The json response from the server

Return type:

dict

composer.http_client.post_url_json(socket_path, url, body)[source]

POST some JSON data to the URL

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to send POST to
  • body (str) – The data for the body of the POST
Returns:

The json response from the server

Return type:

dict

composer.http_client.post_url_toml(socket_path, url, body)[source]

POST a TOML string to the URL

Parameters:
  • socket_path (str) – Path to the Unix socket to use for API communication
  • url (str) – URL to send POST to
  • body (str) – The data for the body of the POST
Returns:

The json response from the server

Return type:

dict

composer.unix_socket module

class composer.unix_socket.UnixHTTPConnection(socket_path, timeout=60)[source]

Bases: http.client.HTTPConnection, object

connect()[source]

Connect to the host and port specified in __init__.

class composer.unix_socket.UnixHTTPConnectionPool(socket_path, timeout=60)[source]

Bases: urllib3.connectionpool.HTTPConnectionPool

Module contents