Revert interface change of FilesExt.upload (#1092)

## What changes are proposed in this pull request?

Provide the readers and reviewers with the information they need to
understand
this PR in a comprehensive manner. 

Specifically, try to answer the two following questions:

- **WHAT**
- Fix the issue where `FilesExt.upload`'s second parameter was changed
from `contents` to `content` unintentionally. This PR reverts the change
to make it compatible with the interface prior than version 0.68.0.
- **WHY**
- 0.69.0 introduced a breaking change unintentionally, which breaks the
usage for certain users. e.g. #1091


## How is this tested?

The unit tests has been updated to check the parameter name.

Author: yuanjieding-db

NEXT_CHANGELOG.md

@@ -6,6 +6,8 @@
 
 ### Bug Fixes
 
+- Fix the issue where `FilesExt.upload`'s second parameter was changed from `contents` to `content` unintentionally. Now the interface is backward compatible to versions previous than 0.69.0.
+
 ### Documentation
 
 ### Internal Changes

databricks/sdk/mixins/files.py

@@ -1064,7 +1064,7 @@ def _get_optimized_performance_parameters_for_upload(
     def upload(
         self,
         file_path: str,
-        content: BinaryIO,
+        contents: BinaryIO,
         *,
         overwrite: Optional[bool] = None,
         part_size: Optional[int] = None,
@@ -1076,7 +1076,7 @@ def upload(
 
         :param file_path: str
             The absolute remote path of the target file, e.g. /Volumes/path/to/your/file
-        :param content: BinaryIO
+        :param contents: BinaryIO
             The contents of the file to upload. This must be a BinaryIO stream.
         :param overwrite: bool (optional)
             If true, an existing file will be overwritten. When not specified, assumed True.
@@ -1096,7 +1096,7 @@ def upload(
 
         if self._config.disable_experimental_files_api_client:
             _LOG.info("Disable experimental files API client, will use the original upload method.")
-            super().upload(file_path=file_path, contents=content, overwrite=overwrite)
+            super().upload(file_path=file_path, contents=contents, overwrite=overwrite)
             return UploadStreamResult()
 
         _LOG.debug(f"Uploading file from BinaryIO stream")
@@ -1107,12 +1107,12 @@ def upload(
 
         # Determine content length if the stream is seekable
         content_length = None
-        if content.seekable():
+        if contents.seekable():
             _LOG.debug(f"Uploading using seekable mode")
             # If the stream is seekable, we can read its size.
-            content.seek(0, os.SEEK_END)
-            content_length = content.tell()
-            content.seek(0)
+            contents.seek(0, os.SEEK_END)
+            content_length = contents.tell()
+            contents.seek(0)
 
         # Get optimized part size and batch size based on content length and provided part size
         optimized_part_size, optimized_batch_size = self._get_optimized_performance_parameters_for_upload(
@@ -1135,17 +1135,17 @@ def upload(
         )
 
         if ctx.use_parallel:
-            self._parallel_upload_from_stream(ctx, content)
+            self._parallel_upload_from_stream(ctx, contents)
             return UploadStreamResult()
         elif ctx.content_length is not None:
-            self._upload_single_thread_with_known_size(ctx, content)
+            self._upload_single_thread_with_known_size(ctx, contents)
             return UploadStreamResult()
         else:
             _LOG.debug(f"Uploading using non-seekable mode")
             # If the stream is not seekable, we cannot determine its size.
             # We will use a multipart upload.
             _LOG.debug(f"Using multipart upload for non-seekable input stream of unknown size for file {file_path}")
-            self._single_thread_multipart_upload(ctx, content)
+            self._single_thread_multipart_upload(ctx, contents)
             return UploadStreamResult()
 
     def upload_from(

tests/test_files.py

@@ -1085,7 +1085,7 @@ def run(self, config: Config, monkeypatch) -> None:
             custom_response_download_from_url=CustomResponse(
                 code=403,
                 first_invocation=2,
-                last_invocation=4,
+                last_invocation=3,
                 body=PresignedUrlDownloadTestCase.expired_url_aws_response,
             ),
         ),
@@ -1375,17 +1375,17 @@ def processor() -> list:
                 def upload() -> None:
                     if source_type == UploadSourceType.FILE:
                         w.files.upload_from(
-                            self.path,
-                            content_or_source,
+                            file_path=self.path,
+                            source_path=content_or_source,
                             overwrite=self.overwrite,
                             part_size=self.multipart_upload_part_size,
                             use_parallel=use_parallel,
                             parallelism=self.parallelism,
                         )
                     else:
                         w.files.upload(
-                            self.path,
-                            content_or_source,
+                            file_path=self.path,
+                            contents=content_or_source,
                             overwrite=self.overwrite,
                             part_size=self.multipart_upload_part_size,
                             use_parallel=use_parallel,