[File][RestParity]Tweak Documentation and Tests

sdk/storage/azure-storage-file/azure/storage/file/aio/file_client_async.py

@@ -171,8 +171,9 @@ async def create_file(  # type: ignore
             The timeout parameter is expressed in seconds.
         :param file_attributes:
             The file system attributes for files and directories.
-            If not set, indicates preservation of existing values.
-            Here is an example for when the var type is str: 'Temporary|Archive'
+            If not set, the default value would be "None" and the attributes will be set to "Archive".
+            Here is an example for when the var type is str: 'Temporary|Archive'.
+            file_attributes value is not case sensitive.
         :type file_attributes: str or :class:`~azure.storage.file.models.NTFSAttributes`
         :param file_creation_time: Creation time for the file
             Default value: Now.
@@ -280,8 +281,9 @@ async def upload_file(
             Defaults to UTF-8.
         :param file_attributes:
             The file system attributes for files and directories.
-            If not set, indicates preservation of existing values.
-            Here is an example for when the var type is str: 'Temporary|Archive'
+            If not set, the default value would be "None" and the attributes will be set to "Archive".
+            Here is an example for when the var type is str: 'Temporary|Archive'.
+            file_attributes value is not case sensitive.
         :type file_attributes: str or :class:`~azure.storage.file.models.NTFSAttributes`
         :param file_creation_time: Creation time for the file
             Default value: Now.

sdk/storage/azure-storage-file/azure/storage/file/file_client.py

@@ -359,8 +359,9 @@ def create_file(  # type: ignore
             The timeout parameter is expressed in seconds.
         :param file_attributes:
             The file system attributes for files and directories.
-            If not set, indicates preservation of existing values.
-            Here is an example for when the var type is str: 'Temporary|Archive'
+            If not set, the default value would be "None" and the attributes will be set to "Archive".
+            Here is an example for when the var type is str: 'Temporary|Archive'.
+            file_attributes value is not case sensitive.
         :type file_attributes: str or :class:`~azure.storage.file.models.NTFSAttributes`
         :param file_creation_time: Creation time for the file
             Default value: Now.
@@ -467,8 +468,9 @@ def upload_file(
             Defaults to UTF-8.
         :param file_attributes:
             The file system attributes for files and directories.
-            If not set, indicates preservation of existing values.
-            Here is an example for when the var type is str: 'Temporary|Archive'
+            If not set, the default value would be "None" and the attributes will be set to "Archive".
+            Here is an example for when the var type is str: 'Temporary|Archive'.
+            file_attributes value is not case sensitive.
         :type file_attributes: str or :class:`~azure.storage.file.models.NTFSAttributes`
         :param file_creation_time: Creation time for the file
             Default value: Now.

sdk/storage/azure-storage-file/tests/test_file.py

@@ -232,7 +232,7 @@ def test_create_file(self):
             credential=self.settings.STORAGE_ACCOUNT_KEY)
 
         # Act
-        resp = file_client.create_file(1024)
+        resp = file_client.create_file(1024, file_attributes="hidden")
 
         # Assert
         props = file_client.get_file_properties()

sdk/storage/azure-storage-file/tests/test_file_async.py

@@ -321,12 +321,16 @@ def test_create_file_with_metadata_async(self):
         loop = asyncio.get_event_loop()
         loop.run_until_complete(self._test_create_file_with_metadata_async())
 
-    async def test_create_file_when_file_permission_is_too_long(self):
+    async def _test_create_file_when_file_permission_is_too_long(self):
         file_client = await self._get_file_client()
         permission = str(self.get_random_bytes(8 * 1024 + 1))
         with self.assertRaises(ValueError):
             await file_client.create_file(1024, file_permission=permission)
 
+    def test_create_file_when_file_permission_is_too_long_async(self):
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._test_create_file_when_file_permission_is_too_long())
+
     async def _test_create_file_with_invalid_file_permission(self):
         # Arrange
         file_name = await self._get_file_client()