Fix lint errors caused by addition of (Optional).

Mostly, lines that were too long.

Author: tswast

bigquery/google/cloud/bigquery/query.py

@@ -349,14 +349,15 @@ def fetch_data(self, max_results=None, page_token=None, start_index=None,
         :param max_results: (Optional) maximum number of rows to return.
 
         :type page_token: str
-        :param page_token: (Optional) token representing a cursor into the table's rows.
+        :param page_token:
+            (Optional) token representing a cursor into the table's rows.
 
         :type start_index: int
         :param start_index: (Optional) zero-based index of starting row
 
         :type timeout_ms: int
-        :param timeout_ms: (Optional) timeout, in milliseconds, to wait for query to
-                           complete
+        :param timeout_ms:
+            (Optional) timeout, in milliseconds, to wait for query to complete
 
         :type client: :class:`~google.cloud.bigquery.client.Client` or
                       ``NoneType``

core/google/cloud/connection.py

@@ -215,10 +215,10 @@ def _make_request(self, method, url, data=None, content_type=None,
         :param headers: A dictionary of HTTP headers to send with the request.
 
         :type target_object: object
-        :param target_object: (Optional) Argument to be used by library callers.
-                              This can allow custom behavior, for example, to
-                              defer an HTTP request and complete initialization
-                              of the object at a later time.
+        :param target_object:
+            (Optional) Argument to be used by library callers.  This can allow
+            custom behavior, for example, to defer an HTTP request and complete
+            initialization of the object at a later time.
 
         :rtype: tuple of ``response`` (a dictionary of sorts)
                 and ``content`` (a string).
@@ -262,8 +262,9 @@ def _do_request(self, method, url, headers, data,
         :param data: The data to send as the body of the request.
 
         :type target_object: object
-        :param target_object: (Optional) Unused ``target_object`` here but may be used
-                              by a superclass.
+        :param target_object:
+            (Optional) Unused ``target_object`` here but may be used by a
+            superclass.
 
         :rtype: tuple of ``response`` (a dictionary of sorts)
                 and ``content`` (a string).
@@ -324,10 +325,10 @@ def api_request(self, method, path, query_params=None,
                             that cannot be done.  Default is True.
 
         :type _target_object: :class:`object`
-        :param _target_object: (Optional) Protected argument to be used by library
-                               callers. This can allow custom behavior, for
-                               example, to defer an HTTP request and complete
-                               initialization of the object at a later time.
+        :param _target_object:
+            (Optional) Protected argument to be used by library callers. This
+            can allow custom behavior, for example, to defer an HTTP request
+            and complete initialization of the object at a later time.
 
         :raises: Exception if the response code is not 200 OK.
         :rtype: dict or str

core/google/cloud/streaming/buffered_stream.py

@@ -82,7 +82,9 @@ def read(self, size=None):
         """Read bytes from the buffer.
 
         :type size: int
-        :param size: (Optional) How many bytes to read (defaults to all remaining bytes).
+        :param size:
+            (Optional) How many bytes to read (defaults to all remaining
+            bytes).
 
         :rtype: str
         :returns: The data read from the stream.

core/google/cloud/streaming/http_wrapper.py

@@ -81,7 +81,8 @@ def _httplib2_debug_level(http_request, level, http=None):
     :param level: the debuglevel for logging.
 
     :type http: :class:`httplib2.Http`
-    :param http: (Optional) the instance on whose connections to set the debuglevel.
+    :param http:
+        (Optional) the instance on whose connections to set the debuglevel.
     """
     if http_request.loggable_body is None:
         yield

core/google/cloud/streaming/stream_slice.py

@@ -66,7 +66,9 @@ def read(self, size=None):
         raise :exc:`IncompleteRead`.
 
         :type size: int
-        :param size: (Optional) If provided, read no more than size bytes from the stream.
+        :param size:
+            (Optional) If provided, read no more than size bytes from the
+            stream.
 
         :rtype: bytes
         :returns: bytes read from this slice.

core/google/cloud/streaming/transfer.py

@@ -670,7 +670,8 @@ def from_file(cls, filename, mime_type=None, auto_transfer=True, **kwds):
         :param mime_type:  MIMEtype of the file being uploaded
 
         :type auto_transfer: bool
-        :param auto_transfer: (Optional) should the transfer be started immediately
+        :param auto_transfer:
+            (Optional) should the transfer be started immediately
 
         :type kwds: dict
         :param kwds:  keyword arguments:  passed
@@ -704,7 +705,8 @@ def from_stream(cls, stream, mime_type,
         :param total_size: (Optional)  Size of the file being uploaded
 
         :type auto_transfer: bool
-        :param auto_transfer: (Optional) should the transfer be started immediately
+        :param auto_transfer:
+            (Optional) should the transfer be started immediately
 
         :type kwds: dict
         :param kwds:  keyword arguments:  passed

datastore/google/cloud/datastore/query.py

@@ -35,16 +35,19 @@ class Query(object):
     :param kind: The kind to query.
 
     :type project: str
-    :param project: The project associated with the query.  If not passed,
-                    uses the client's value.
+    :param project:
+        (Optional) The project associated with the query.  If not passed, uses
+        the client's value.
 
     :type namespace: str
-    :param namespace: (Optional) The namespace to which to restrict results.  If not
-                      passed, uses the client's value.
+    :param namespace:
+        (Optional) The namespace to which to restrict results.  If not passed,
+        uses the client's value.
 
     :type ancestor: :class:`google.cloud.datastore.key.Key`
-    :param ancestor: (Optional) key of the ancestor to which this query's results are
-                     restricted.
+    :param ancestor:
+        (Optional) key of the ancestor to which this query's results are
+        restricted.
 
     :type filters: sequence of (property_name, operator, value) tuples
     :param filters: property filters applied by this query.
@@ -328,16 +331,16 @@ def fetch(self, limit=None, offset=0, start_cursor=None, end_cursor=None,
           [<Entity object>]
 
         :type limit: int
-        :param limit: (Optional) An optional limit passed through to the iterator.
+        :param limit: (Optional) limit passed through to the iterator.
 
         :type offset: int
-        :param offset: An optional offset passed through to the iterator.
+        :param offset: (Optional) offset passed through to the iterator.
 
         :type start_cursor: bytes
-        :param start_cursor: An optional cursor passed through to the iterator.
+        :param start_cursor: (Optional) cursor passed through to the iterator.
 
         :type end_cursor: bytes
-        :param end_cursor: An optional cursor passed through to the iterator.
+        :param end_cursor: (Optional) cursor passed through to the iterator.
 
         :type client: :class:`google.cloud.datastore.client.Client`
         :param client: client used to connect to datastore.

dns/google/cloud/dns/changes.py

@@ -170,8 +170,9 @@ def _require_client(self, client):
         """Check client or verify over-ride.
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
 
         :rtype: :class:`google.cloud.dns.client.Client`
         :returns: The client passed in or the currently bound client.
@@ -208,8 +209,9 @@ def create(self, client=None):
         https://cloud.google.com/dns/api/v1/changes/create
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
         """
         if len(self.additions) == 0 and len(self.deletions) == 0:
             raise ValueError("No record sets added or deleted")
@@ -227,8 +229,9 @@ def exists(self, client=None):
         https://cloud.google.com/dns/api/v1/changes/get
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
 
         :rtype: bool
         :returns: Boolean indicating existence of the changes.
@@ -249,8 +252,9 @@ def reload(self, client=None):
         https://cloud.google.com/dns/api/v1/changes/get
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
         """
         client = self._require_client(client)
 

dns/google/cloud/dns/client.py

@@ -92,12 +92,14 @@ def zone(self, name, dns_name=None, description=None):
         :param name: Name of the zone.
 
         :type dns_name: str
-        :param dns_name: (Optional) DNS name of the zone.  If not passed, then calls
-                         to :meth:`zone.create` will fail.
+        :param dns_name:
+            (Optional) DNS name of the zone.  If not passed, then calls to
+            :meth:`zone.create` will fail.
 
         :type description: str
-        :param description: (Optional) the description for the zone.  If not passed,
-                            defaults to the value of 'dns_name'.
+        :param description:
+            (Optional) the description for the zone.  If not passed, defaults
+            to the value of 'dns_name'.
 
         :rtype: :class:`google.cloud.dns.zone.ManagedZone`
         :returns: a new ``ManagedZone`` instance.

dns/google/cloud/dns/zone.py

@@ -33,16 +33,18 @@ class ManagedZone(object):
     :param name: the name of the zone
 
     :type dns_name: str
-    :param dns_name: (Optional) the DNS name of the zone.  If not passed, then calls
-                     to :meth:`create` will fail.
+    :param dns_name:
+        (Optional) the DNS name of the zone.  If not passed, then calls to
+        :meth:`create` will fail.
 
     :type client: :class:`google.cloud.dns.client.Client`
     :param client: A client which holds credentials and project configuration
                    for the zone (which requires a project).
 
     :type description: str
-    :param description: (Optional) the description for the zone.  If not passed, defaults
-                        to the value of 'dns_name'.
+    :param description:
+        (Optional) the description for the zone.  If not passed, defaults to
+        the value of 'dns_name'.
     """
 
     def __init__(self, name, dns_name=None, client=None, description=None):
@@ -203,8 +205,9 @@ def _require_client(self, client):
         """Check client or verify over-ride.
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
 
         :rtype: :class:`google.cloud.dns.client.Client`
         :returns: The client passed in or the currently bound client.
@@ -251,8 +254,9 @@ def create(self, client=None):
         https://cloud.google.com/dns/api/v1/managedZones/create
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
         """
         client = self._require_client(client)
         path = '/projects/%s/managedZones' % (self.project,)
@@ -267,8 +271,9 @@ def exists(self, client=None):
         https://cloud.google.com/dns/api/v1/managedZones/get
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
 
         :rtype: bool
         :returns: Boolean indicating existence of the managed zone.
@@ -290,8 +295,9 @@ def reload(self, client=None):
         https://cloud.google.com/dns/api/v1/managedZones/get
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
         """
         client = self._require_client(client)
 
@@ -306,8 +312,9 @@ def delete(self, client=None):
         https://cloud.google.com/dns/api/v1/managedZones/delete
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
         """
         client = self._require_client(client)
         client.connection.api_request(method='DELETE', path=self.path)
@@ -329,8 +336,9 @@ def list_resource_record_sets(self, max_results=None, page_token=None,
                            zones.
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
 
         :rtype: :class:`~google.cloud.iterator.Iterator`
         :returns: Iterator of :class:`~.resource_record_set.ResourceRecordSet`
@@ -362,8 +370,9 @@ def list_changes(self, max_results=None, page_token=None, client=None):
                            zones.
 
         :type client: :class:`google.cloud.dns.client.Client`
-        :param client: (Optional) the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
 
         :rtype: :class:`~google.cloud.iterator.Iterator`
         :returns: Iterator of :class:`~.changes.Changes`