Change gcloud package to google.cloud

docs/bigquery_snippets.py

@@ -15,8 +15,8 @@
 """Testable usage examples for Google Cloud BigQuery API wrapper
 
 Each example function takes a ``client`` argument (which must be an instance
-of :class:`google.cloud.bigquery.client.Client`) and uses it to perform a task with
-the API.
+of :class:`google.cloud.bigquery.client.Client`) and uses it to perform a task
+with the API.
 
 To facilitate running the examples as system tests, each example is also passed
 a ``to_delete`` list;  the function adds to the list any objects created which

docs/pubsub_snippets.py

@@ -15,8 +15,8 @@
 """Testable usage examples for Google Cloud Pubsub API wrapper
 
 Each example function takes a ``client`` argument (which must be an instance
-of :class:`google.cloud.pubsub.client.Client`) and uses it to perform a task with
-the API.
+of :class:`google.cloud.pubsub.client.Client`) and uses it to perform a task
+with the API.
 
 To facilitate running the examples as system tests, each example is also passed
 a ``to_delete`` list;  the function adds to the list any objects created which

google/__init__.py

@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+"""Base ``google`` namespace package."""
+
 try:
     import pkg_resources
     pkg_resources.declare_namespace(__name__)

google/cloud/_helpers.py

@@ -42,8 +42,10 @@
 from six.moves.http_client import HTTPConnection
 from six.moves import configparser
 
+# pylint: disable=ungrouped-imports
 from google.cloud.environment_vars import PROJECT
 from google.cloud.environment_vars import CREDENTIALS
+# pylint: enable=ungrouped-imports
 
 
 _NOW = datetime.datetime.utcnow  # To be replaced by tests.
@@ -64,10 +66,10 @@
     _USER_ROOT = os.path.expanduser('~')
 except ImportError:  # pragma: NO COVER
     _USER_ROOT = None
-_GOOGLE_CLOUD_CONFIG_FILE = os.path.join(
+_GCLOUD_CONFIG_FILE = os.path.join(
     'gcloud', 'configurations', 'config_default')
-_GOOGLE_CLOUD_CONFIG_SECTION = 'core'
-_GOOGLE_CLOUD_CONFIG_KEY = 'project'
+_GCLOUD_CONFIG_SECTION = 'core'
+_GCLOUD_CONFIG_KEY = 'project'
 
 
 class _LocalStack(Local):
@@ -202,7 +204,7 @@ def _get_nix_config_path():
     :returns: The filename on a *nix system containing the CLI
               config file.
     """
-    return os.path.join(_USER_ROOT, '.config', _GOOGLE_CLOUD_CONFIG_FILE)
+    return os.path.join(_USER_ROOT, '.config', _GCLOUD_CONFIG_FILE)
 
 
 def _get_windows_config_path():
@@ -213,7 +215,7 @@ def _get_windows_config_path():
               config file.
     """
     appdata_dir = os.getenv('APPDATA', '')
-    return os.path.join(appdata_dir, _GOOGLE_CLOUD_CONFIG_FILE)
+    return os.path.join(appdata_dir, _GCLOUD_CONFIG_FILE)
 
 
 def _default_service_project_id():
@@ -243,8 +245,8 @@ def _default_service_project_id():
     config = configparser.RawConfigParser()
     config.read(search_paths)
 
-    if config.has_section(_GOOGLE_CLOUD_CONFIG_SECTION):
-        return config.get(_GOOGLE_CLOUD_CONFIG_SECTION, _GOOGLE_CLOUD_CONFIG_KEY)
+    if config.has_section(_GCLOUD_CONFIG_SECTION):
+        return config.get(_GCLOUD_CONFIG_SECTION, _GCLOUD_CONFIG_KEY)
 
 
 def _compute_engine_id():

google/cloud/bigquery/__init__.py

@@ -16,9 +16,10 @@
 
 The main concepts with this API are:
 
-- :class:`google.cloud.bigquery.dataset.Dataset` represents an collection of tables.
+- :class:`~google.cloud.bigquery.dataset.Dataset` represents a
+  collection of tables.
 
-- :class:`google.cloud.bigquery.table.Table` represents a single "relation".
+- :class:`~google.cloud.bigquery.table.Table` represents a single "relation".
 """
 
 try:

google/cloud/bigquery/client.py

@@ -68,8 +68,8 @@ def list_datasets(self, include_all=False, max_results=None,
                            datasets.
 
         :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.bigquery.dataset.Dataset`, plus a
-                  "next page token" string:  if the token is not None,
+        :returns: list of :class:`~google.cloud.bigquery.dataset.Dataset`,
+                  plus a "next page token" string:  if the token is not None,
                   indicates that more datasets can be retrieved with another
                   call (pass that value as ``page_token``).
         """

google/cloud/bigquery/dataset.py

@@ -317,7 +317,8 @@ def from_api_repr(cls, resource, client):
     def _require_client(self, client):
         """Check client or verify over-ride.
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -413,7 +414,8 @@ def create(self, client=None):
         See:
         https://cloud.google.com/bigquery/docs/reference/v2/tables/insert
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -429,7 +431,8 @@ def exists(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/datasets/get
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -452,7 +455,8 @@ def reload(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/datasets/get
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -468,7 +472,8 @@ def patch(self, client=None, **kw):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/datasets/patch
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -506,7 +511,8 @@ def update(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/datasets/update
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -521,7 +527,8 @@ def delete(self, client=None):
         See:
         https://cloud.google.com/bigquery/docs/reference/v2/tables/delete
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """

google/cloud/bigquery/job.py

@@ -156,7 +156,8 @@ def project(self):
     def _require_client(self, client):
         """Check client or verify over-ride.
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -354,7 +355,8 @@ def begin(self, client=None):
         See:
         https://cloud.google.com/bigquery/docs/reference/v2/jobs/insert
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -370,7 +372,8 @@ def exists(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/jobs/get
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -393,7 +396,8 @@ def reload(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/jobs/get
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -409,7 +413,8 @@ def cancel(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/jobs/cancel
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """

google/cloud/bigquery/query.py

@@ -77,7 +77,8 @@ def project(self):
     def _require_client(self, client):
         """Check client or verify over-ride.
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -301,7 +302,8 @@ def run(self, client=None):
         See:
         https://cloud.google.com/bigquery/docs/reference/v2/jobs/query
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -331,7 +333,8 @@ def fetch_data(self, max_results=None, page_token=None, start_index=None,
         :param timeout_ms: timeout, in milliseconds, to wait for query to
                            complete
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 

google/cloud/bigquery/table.py

@@ -368,7 +368,8 @@ def view_query(self):
     def list_partitions(self, client=None):
         """List the partitions in a table.
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -406,7 +407,8 @@ def from_api_repr(cls, resource, dataset):
     def _require_client(self, client):
         """Check client or verify over-ride.
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -477,7 +479,8 @@ def create(self, client=None):
         See:
         https://cloud.google.com/bigquery/docs/reference/v2/tables/insert
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -494,7 +497,8 @@ def exists(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/tables/get
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -517,7 +521,8 @@ def reload(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/tables/get
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -540,7 +545,8 @@ def patch(self,
         See
         https://cloud.google.com/bigquery/docs/reference/v2/tables/patch
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -606,7 +612,8 @@ def update(self, client=None):
         See
         https://cloud.google.com/bigquery/docs/reference/v2/tables/update
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -621,7 +628,8 @@ def delete(self, client=None):
         See:
         https://cloud.google.com/bigquery/docs/reference/v2/tables/delete
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
         """
@@ -648,7 +656,8 @@ def fetch_data(self, max_results=None, page_token=None, client=None):
         :type page_token: str or ``NoneType``
         :param page_token: token representing a cursor into the table's rows.
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -714,7 +723,8 @@ def insert_data(self,
                                 schema of the template table. See:
                                 https://cloud.google.com/bigquery/streaming-data-into-bigquery#template-tables
 
-        :type client: :class:`google.cloud.bigquery.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
         :param client: the client to use.  If not passed, falls back to the
                        ``client`` stored on the current dataset.
 
@@ -851,7 +861,8 @@ def upload_from_file(self,
         :param write_disposition: job configuration option; see
                                   :meth:`google.cloud.bigquery.job.LoadJob`.
 
-        :type client: :class:`google.cloud.storage.client.Client` or ``NoneType``
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
         :param client: Optional. The client to use.  If not passed, falls back
                        to the ``client`` stored on the current dataset.
 

google/cloud/bigtable/client.py

@@ -19,10 +19,10 @@
 In the hierarchy of API concepts
 
 * a :class:`Client` owns an :class:`.Instance`
-* a :class:`.Instance` owns a :class:`Table <google.cloud.bigtable.table.Table>`
-* a :class:`Table <google.cloud.bigtable.table.Table>` owns a
-  :class:`ColumnFamily <.column_family.ColumnFamily>`
-* a :class:`Table <google.cloud.bigtable.table.Table>` owns a :class:`Row <.row.Row>`
+* a :class:`.Instance` owns a :class:`~google.cloud.bigtable.table.Table`
+* a :class:`~google.cloud.bigtable.table.Table` owns a
+  :class:`~.column_family.ColumnFamily`
+* a :class:`~google.cloud.bigtable.table.Table` owns a :class:`~.row.Row`
   (and all the cells in the row)
 """