Fix lint errors caused by addition of (Optional).

Mostly, lines that were too long.

Author: tswast

packages/google-cloud-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

packages/google-cloud-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.

packages/google-cloud-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

packages/google-cloud-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.

packages/google-cloud-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