Remove positional special parameter for 3.7 compatibility

Author: nickles-lee

databricks/sdk/mixins/files.py

@@ -760,15 +760,15 @@ def _ensure_open_stream(self):
     def detach(self):
         raise UnsupportedOperation("Detaching from the buffer is not supported")
 
-    def read(self, __size = -1, /):
+    def read(self, __size = -1):
         # Read and return up to size bytes. If omitted, None, or Negative, data is read until EOF is reached
         # Empty bytes object returned if stream is EOF
         self._ensure_open_stream()
         out = self._underlying_stream.read(__size)
         self._current_pos_of_underlying_stream += len(out)
         return out
 
-    def read1(self, __size = ...):
+    def read1(self, __size = -1):
         # Read and return up to size bytes, with at most one read() system call
         self._ensure_open_stream()
         out = self._underlying_stream.read1(__size)
@@ -829,7 +829,7 @@ def readlines(self, __hint = -1):
         self._current_pos_of_underlying_stream += len(out)
         return out
 
-    def seek(self, __offset, __whence = os.SEEK_SET, /):
+    def seek(self, __offset, __whence = os.SEEK_SET):
         """
         Change the stream position to the given byte offset, which may necessitate closing the existing client connection and opening a new one.
 

docs/workspace/files/files.rst

@@ -2,7 +2,7 @@
 ==================
 .. currentmodule:: databricks.sdk.service.files
 
-.. py:class:: FilesAPI
+.. py:class:: FilesExt
 
     The Files API is a standard HTTP API that allows you to read, write, list, and delete files and
     directories by referring to their URI. The API makes working with file content as raw bytes easier and
@@ -60,16 +60,16 @@
 
 
 
-    .. py:method:: download(file_path: str) -> DownloadResponse
+    .. py:method:: download(file_path: str [, start_byte_offset: Optional[int], if_unmodified_since_timestamp: Optional[datetime]]) -> DownloadResponse
 
         Download a file.
-        
+
         Downloads a file of up to 5 GiB. The file contents are the response body. This is a standard HTTP file
         download, not a JSON RPC.
-        
+
         :param file_path: str
           The absolute path of the file.
-        
+
         :returns: :class:`DownloadResponse`