Source code for gcloud.connection

import httplib2


class Connection(object):
  """A generic connection to Google Cloud Platform.

  Subclasses should understand
  only the basic types
  in method arguments,
  however they should be capable
  of returning advanced types.
  """

  API_BASE_URL = 'https://www.googleapis.com'
  """The base of the API call URL."""

  _EMPTY = object()
  """A pointer to represent an empty value for default arguments."""

  def __init__(self, credentials=None):
    """
    :type credentials: :class:`gcloud.credentials.Credentials`
    :param credentials: The OAuth2 Credentials to use for this connection.
    """

    self._credentials = credentials

  @property
  def credentials(self):
    return self._credentials

  @property
  def http(self):
    """A getter for the HTTP transport used in talking to the API.

    :rtype: :class:`httplib2.Http`
    :returns: A Http object used to transport data.
    """
    if not hasattr(self, '_http'):
      self._http = httplib2.Http()
      if self._credentials:
        self._http = self._credentials.authorize(self._http)
    return self._http