Fixing lint issues after package rename.

Author: dhermes

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.

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.