Some doc fixes in file datalake (Azure#41320)

* Some doc fixes

* update

* updates

* update

Author: xiangyan99

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/_data_lake_file_client.py

@@ -461,7 +461,7 @@ def upload_data(
             A callback to track the progress of a long-running upload. The signature is
             function(current: int, total: int) where current is the number of bytes transferred
             so far, and total is the total size of the download.
-        :paramtype progress_hook: Callable[[int, int], None]
+        :paramtype progress_hook: ~typing.Callable[[int, int], None]
         :returns: A dictionary of response headers.
         :rtype: Dict[str, Any]
         """
@@ -692,7 +692,7 @@ def download_file(
             A callback to track the progress of a long-running download. The signature is
             function(current: int, total: int) where current is the number of bytes transferred
             so far, and total is the total size of the download.
-        :paramtype progress_hook: Callable[[int, int], None]
+        :paramtype progress_hook: ~typing.Callable[[int, int], None]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
@@ -821,8 +821,9 @@ def query_file(self, query_expression: str, **kwargs: Any) -> DataLakeFileQueryR
         :param str query_expression:
             Required. a query statement.
             eg. Select * from DataLakeStorage
-        :keyword Callable[~azure.storage.filedatalake.DataLakeFileQueryError] on_error:
+        :keyword on_error:
             A function to be called on any processing errors returned by the service.
+        :paramtype on_error: ~typing.Callable[~azure.storage.filedatalake.DataLakeFileQueryError]
         :keyword file_format:
             Optional. Defines the serialization of the data currently stored in the file. The default is to
             treat the file data as CSV data formatted in the default dialect. This can be overridden with

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/_file_system_client.py

@@ -688,7 +688,7 @@ def create_directory(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: DataLakeDirectoryClient with new directory and metadata.
-        :rtype: ~azure.storage.file.datalake.DataLakeDirectoryClient
+        :rtype: ~azure.storage.filedatalake.DataLakeDirectoryClient
 
         .. admonition:: Example:
 
@@ -743,7 +743,7 @@ def delete_directory(  # pylint: disable=delete-operation-wrong-return-type
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: DataLakeDirectoryClient after deleting specified directory.
-        :rtype: ~azure.storage.file.datalake.DataLakeDirectoryClient
+        :rtype: ~azure.storage.filedatalake.DataLakeDirectoryClient
 
         .. admonition:: Example:
 
@@ -843,7 +843,7 @@ def create_file(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: DataLakeFileClient with new file created.
-        :rtype: ~azure.storage.file.datalake.DataLakeFileClient
+        :rtype: ~azure.storage.filedatalake.DataLakeFileClient
 
         .. admonition:: Example:
 
@@ -898,7 +898,7 @@ def delete_file(  # pylint: disable=delete-operation-wrong-return-type
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :return: DataLakeFileClient after deleting specified file.
-        :rtype: azure.storage.file.datalake.DataLakeFileClient
+        :rtype: azure.storage.filedatalake.DataLakeFileClient
 
         .. admonition:: Example:
 
@@ -937,7 +937,7 @@ def _undelete_path(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: Returns the DataLake client for the restored soft-deleted path.
-        :rtype: ~azure.storage.file.datalake.DataLakeDirectoryClient or azure.storage.file.datalake.DataLakeFileClient
+        :rtype: ~azure.storage.filedatalake.DataLakeDirectoryClient or azure.storage.filedatalake.DataLakeFileClient
         """
         _, url, undelete_source = _undelete_path_options(deleted_path_name, deletion_id, self.url)
 

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/_models.py

@@ -755,7 +755,8 @@ def _convert_from_container_props(cls, container_properties):
 class FileSystemPropertiesPaged(ContainerPropertiesPaged):
     """An Iterable of File System properties.
 
-    :param callable command: Function to retrieve the next page of items.
+    :param command: Function to retrieve the next page of items.
+    :type command: ~typing.Callable[]
     :param str prefix: Filters the results to return only file systems whose names
         begin with the specified prefix.
     :param int results_per_page: The maximum number of file system names to retrieve per call.

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/_shared/shared_access_signature.py

@@ -161,7 +161,7 @@ def generate_account(
         :param sts_hook:
             For debugging purposes only. If provided, the hook is called with the string to sign
             that was used to generate the SAS.
-        :type sts_hook: Optional[Callable[[str], None]]
+        :type sts_hook: Optional[~typing.Callable[[str], None]]
         :returns: The generated SAS token for the account.
         :rtype: str
         """

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/_shared_access_signature.py

@@ -85,7 +85,7 @@ def generate_account_sas(
     :keyword sts_hook:
         For debugging purposes only. If provided, the hook is called with the string to sign
         that was used to generate the SAS.
-    :paramtype sts_hook: Callable[[str], None] or None
+    :paramtype sts_hook: ~typing.Callable[[str], None] or None
     :return: A Shared Access Signature (sas) token.
     :rtype: str
     """
@@ -196,7 +196,7 @@ def generate_file_system_sas(
     :keyword sts_hook:
         For debugging purposes only. If provided, the hook is called with the string to sign
         that was used to generate the SAS.
-    :paramtype sts_hook: Callable[[str], None] or None
+    :paramtype sts_hook: ~typing.Callable[[str], None] or None
     :return: A Shared Access Signature (sas) token.
     :rtype: str
     """
@@ -310,7 +310,7 @@ def generate_directory_sas(
     :keyword sts_hook:
         For debugging purposes only. If provided, the hook is called with the string to sign
         that was used to generate the SAS.
-    :paramtype sts_hook: Callable[[str], None] or None
+    :paramtype sts_hook: ~typing.Callable[[str], None] or None
     :return: A Shared Access Signature (sas) token.
     :rtype: str
     """
@@ -431,7 +431,7 @@ def generate_file_sas(
     :keyword sts_hook:
         For debugging purposes only. If provided, the hook is called with the string to sign
         that was used to generate the SAS.
-    :paramtype sts_hook: Callable[[str], None] or None
+    :paramtype sts_hook: ~typing.Callable[[str], None] or None
     :return: A Shared Access Signature (sas) token.
     :rtype: str
     """

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/aio/_data_lake_file_client_async.py

@@ -477,7 +477,7 @@ async def upload_data(
             A callback to track the progress of a long-running upload. The signature is
             function(current: int, total: int) where current is the number of bytes transferred
             so far, and total is the total size of the download.
-        :paramtype progress_hook: Callable[[int, Optional[int]], Awaitable[None]]
+        :paramtype progress_hook: ~typing.Callable[[int, Optional[int]], Awaitable[None]]
         :returns: A dictionary of response headers.
         :rtype: Dict[str, Any]
         """
@@ -708,7 +708,7 @@ async def download_file(
             A callback to track the progress of a long-running download. The signature is
             function(current: int, total: int) where current is the number of bytes transferred
             so far, and total is the total size of the download.
-        :paramtype progress_hook: Callable[[int, Optional[int]], Awaitable[None]]
+        :paramtype progress_hook: ~typing.Callable[[int, Optional[int]], Awaitable[None]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/aio/_file_system_client_async.py

@@ -692,7 +692,7 @@ async def create_directory(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: DataLakeDirectoryClient with new directory and metadata.
-        :rtype: ~azure.storage.file.datalake.aio.DataLakeDirectoryClient
+        :rtype: ~azure.storage.filedatalake.aio.DataLakeDirectoryClient
 
         .. admonition:: Example:
 
@@ -747,7 +747,7 @@ async def delete_directory(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: DataLakeDirectoryClient after deleting specified directory.
-        :rtype: ~azure.storage.file.datalake.aio.DataLakeDirectoryClient
+        :rtype: ~azure.storage.filedatalake.aio.DataLakeDirectoryClient
 
         .. admonition:: Example:
 
@@ -847,7 +847,7 @@ async def create_file(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: DataLakeFileClient with new file created.
-        :rtype: ~azure.storage.file.datalake.aio.DataLakeFileClient
+        :rtype: ~azure.storage.filedatalake.aio.DataLakeFileClient
 
         .. admonition:: Example:
 
@@ -902,7 +902,7 @@ async def delete_file(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :return: DataLakeFileClient after deleting specified file.
-        :rtype: ~azure.storage.file.datalake.aio.DataLakeFileClient
+        :rtype: ~azure.storage.filedatalake.aio.DataLakeFileClient
 
         .. literalinclude:: ../samples/datalake_samples_file_system_async.py
             :start-after: [START delete_file_from_file_system]
@@ -940,8 +940,8 @@ async def _undelete_path(
             see `here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-file-datalake
             #other-client--per-operation-configuration>`_.
         :returns: Returns the DataLake client for the restored soft-deleted path.
-        :rtype: ~azure.storage.file.datalake.aio.DataLakeDirectoryClient or
-                ~azure.storage.file.datalake.aio.DataLakeFileClient
+        :rtype: ~azure.storage.filedatalake.aio.DataLakeDirectoryClient or
+                ~azure.storage.filedatalake.aio.DataLakeFileClient
         """
         _, url, undelete_source = _undelete_path_options(deleted_path_name, deletion_id, self.url)
 

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/aio/_models.py

@@ -14,7 +14,8 @@
 class FileSystemPropertiesPaged(ContainerPropertiesPaged):
     """An Iterable of File System properties.
 
-    :param callable command: Function to retrieve the next page of items.
+    :param command: Function to retrieve the next page of items.
+    :paramtype command: ~typing.Callable[]
     :param str prefix: Filters the results to return only file systems whose names
         begin with the specified prefix.
     :param int results_per_page: The maximum number of file system names to retrieve per call.

sdk/storage/azure-storage-file-datalake/azure/storage/filedatalake/aio/_path_client_async.py

@@ -490,7 +490,7 @@ async def set_access_control_recursive(self, acl: str, **kwargs: Any) -> AccessC
             #other-client--per-operation-configuration>`_.
         :return: A summary of the recursive operations, including the count of successes and failures,
             as well as a continuation token in case the operation was terminated prematurely.
-        :rtype: :~azure.storage.filedatalake.AccessControlChangeResult`
+        :rtype: ~azure.storage.filedatalake.AccessControlChangeResult
         :raises ~azure.core.exceptions.AzureError:
             User can restart the operation using continuation_token field of AzureError if the token is available.
         """
@@ -544,7 +544,7 @@ async def update_access_control_recursive(self, acl: str, **kwargs: Any) -> Acce
             #other-client--per-operation-configuration>`_.
         :return: A summary of the recursive operations, including the count of successes and failures,
             as well as a continuation token in case the operation was terminated prematurely.
-        :rtype: :~azure.storage.filedatalake.AccessControlChangeResult`
+        :rtype: ~azure.storage.filedatalake.AccessControlChangeResult
         :raises ~azure.core.exceptions.AzureError:
             User can restart the operation using continuation_token field of AzureError if the token is available.
         """
@@ -596,7 +596,7 @@ async def remove_access_control_recursive(self, acl: str, **kwargs: Any) -> Acce
             #other-client--per-operation-configuration>`_.
         :return: A summary of the recursive operations, including the count of successes and failures,
             as well as a continuation token in case the operation was terminated prematurely.
-        :rtype: :~azure.storage.filedatalake.AccessControlChangeResult`
+        :rtype: ~azure.storage.filedatalake.AccessControlChangeResult
         :raises ~azure.core.exceptions.AzureError:
             User can restart the operation using continuation_token field of AzureError if the token is available.
         """