composer Package

composer Package

http_client Module

composer.http_client.api_url(api_version, url)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

unix_socket Module

class composer.unix_socket.UnixHTTPConnection(socket_path, timeout=300)

Bases: httplib.HTTPConnection, object

connect()

class composer.unix_socket.UnixHTTPConnectionPool(socket_path, timeout=300)

Bases: urllib3.connectionpool.HTTPConnectionPool

Subpackages

• cli Package
  • cli Package
  • blueprints Module
  • compose Module
  • help Module
  • modules Module
  • projects Module
  • sources Module
  • status Module
  • utilities Module