tableauserverclient 0.30.post0.dev1__py3-none-any.whl → 0.32__py3-none-any.whl

tableauserverclient/server/endpoint/__init__.py

@@ -1,28 +1,61 @@
-from .auth_endpoint import Auth
-from .custom_views_endpoint import CustomViews
-from .data_acceleration_report_endpoint import DataAccelerationReport
-from .data_alert_endpoint import DataAlerts
-from .databases_endpoint import Databases
-from .datasources_endpoint import Datasources
-from .endpoint import Endpoint, QuerysetEndpoint
-from .exceptions import ServerResponseError, MissingRequiredFieldError
-from .favorites_endpoint import Favorites
-from .fileuploads_endpoint import Fileuploads
-from .flow_runs_endpoint import FlowRuns
-from .flows_endpoint import Flows
-from .flow_task_endpoint import FlowTasks
-from .groups_endpoint import Groups
-from .jobs_endpoint import Jobs
-from .metadata_endpoint import Metadata
-from .metrics_endpoint import Metrics
-from .projects_endpoint import Projects
-from .schedules_endpoint import Schedules
-from .server_info_endpoint import ServerInfo
-from .sites_endpoint import Sites
-from .subscriptions_endpoint import Subscriptions
-from .tables_endpoint import Tables
-from .tasks_endpoint import Tasks
-from .users_endpoint import Users
-from .views_endpoint import Views
-from .webhooks_endpoint import Webhooks
-from .workbooks_endpoint import Workbooks
+from tableauserverclient.server.endpoint.auth_endpoint import Auth
+from tableauserverclient.server.endpoint.custom_views_endpoint import CustomViews
+from tableauserverclient.server.endpoint.data_acceleration_report_endpoint import DataAccelerationReport
+from tableauserverclient.server.endpoint.data_alert_endpoint import DataAlerts
+from tableauserverclient.server.endpoint.databases_endpoint import Databases
+from tableauserverclient.server.endpoint.datasources_endpoint import Datasources
+from tableauserverclient.server.endpoint.endpoint import Endpoint, QuerysetEndpoint
+from tableauserverclient.server.endpoint.exceptions import ServerResponseError, MissingRequiredFieldError
+from tableauserverclient.server.endpoint.favorites_endpoint import Favorites
+from tableauserverclient.server.endpoint.fileuploads_endpoint import Fileuploads
+from tableauserverclient.server.endpoint.flow_runs_endpoint import FlowRuns
+from tableauserverclient.server.endpoint.flows_endpoint import Flows
+from tableauserverclient.server.endpoint.flow_task_endpoint import FlowTasks
+from tableauserverclient.server.endpoint.groups_endpoint import Groups
+from tableauserverclient.server.endpoint.jobs_endpoint import Jobs
+from tableauserverclient.server.endpoint.metadata_endpoint import Metadata
+from tableauserverclient.server.endpoint.metrics_endpoint import Metrics
+from tableauserverclient.server.endpoint.projects_endpoint import Projects
+from tableauserverclient.server.endpoint.schedules_endpoint import Schedules
+from tableauserverclient.server.endpoint.server_info_endpoint import ServerInfo
+from tableauserverclient.server.endpoint.sites_endpoint import Sites
+from tableauserverclient.server.endpoint.subscriptions_endpoint import Subscriptions
+from tableauserverclient.server.endpoint.tables_endpoint import Tables
+from tableauserverclient.server.endpoint.tasks_endpoint import Tasks
+from tableauserverclient.server.endpoint.users_endpoint import Users
+from tableauserverclient.server.endpoint.views_endpoint import Views
+from tableauserverclient.server.endpoint.webhooks_endpoint import Webhooks
+from tableauserverclient.server.endpoint.workbooks_endpoint import Workbooks
+
+__all__ = [
+    "Auth",
+    "CustomViews",
+    "DataAccelerationReport",
+    "DataAlerts",
+    "Databases",
+    "Datasources",
+    "QuerysetEndpoint",
+    "MissingRequiredFieldError",
+    "Endpoint",
+    "Favorites",
+    "Fileuploads",
+    "FlowRuns",
+    "Flows",
+    "FlowTasks",
+    "Groups",
+    "Jobs",
+    "Metadata",
+    "Metrics",
+    "Projects",
+    "Schedules",
+    "ServerInfo",
+    "ServerResponseError",
+    "Sites",
+    "Subscriptions",
+    "Tables",
+    "Tasks",
+    "Users",
+    "Views",
+    "Webhooks",
+    "Workbooks",
+]

tableauserverclient/server/endpoint/custom_views_endpoint.py

@@ -17,7 +17,7 @@ update the name or owner of a custom view.
 """
 
 
-class CustomViews(QuerysetEndpoint):
+class CustomViews(QuerysetEndpoint[CustomViewItem]):
     def __init__(self, parent_srv):
         super(CustomViews, self).__init__(parent_srv)
 

tableauserverclient/server/endpoint/databases_endpoint.py

@@ -88,17 +88,6 @@ class Databases(Endpoint):
     def populate_permissions(self, item):
         self._permissions.populate(item)
 
-    @api(version="3.5")
-    def update_permission(self, item, rules):
-        import warnings
-
-        warnings.warn(
-            "Server.databases.update_permission is deprecated, "
-            "please use Server.databases.update_permissions instead.",
-            DeprecationWarning,
-        )
-        return self._permissions.update(item, rules)
-
     @api(version="3.5")
     def update_permissions(self, item, rules):
         return self._permissions.update(item, rules)

tableauserverclient/server/endpoint/datasources_endpoint.py

@@ -15,11 +15,11 @@ if TYPE_CHECKING:
     from tableauserverclient.models import PermissionsRule
     from .schedules_endpoint import AddResponse
 
-from .dqw_endpoint import _DataQualityWarningEndpoint
-from .endpoint import QuerysetEndpoint, api, parameter_added_in
-from .exceptions import InternalServerError, MissingRequiredFieldError
-from .permissions_endpoint import _PermissionsEndpoint
-from .resource_tagger import _ResourceTagger
+from tableauserverclient.server.endpoint.dqw_endpoint import _DataQualityWarningEndpoint
+from tableauserverclient.server.endpoint.endpoint import QuerysetEndpoint, api, parameter_added_in
+from tableauserverclient.server.endpoint.exceptions import InternalServerError, MissingRequiredFieldError
+from tableauserverclient.server.endpoint.permissions_endpoint import _PermissionsEndpoint
+from tableauserverclient.server.endpoint.resource_tagger import _ResourceTagger
 
 from tableauserverclient.config import ALLOWED_FILE_EXTENSIONS, FILESIZE_LIMIT_MB, BYTES_PER_MB, CHUNK_SIZE_MB
 from tableauserverclient.filesys_helpers import (
@@ -54,7 +54,7 @@ PathOrFileR = Union[FilePath, FileObjectR]
 PathOrFileW = Union[FilePath, FileObjectW]
 
 
-class Datasources(QuerysetEndpoint):
+class Datasources(QuerysetEndpoint[DatasourceItem]):
     def __init__(self, parent_srv: "Server") -> None:
         super(Datasources, self).__init__(parent_srv)
         self._resource_tagger = _ResourceTagger(parent_srv)
@@ -126,9 +126,13 @@ class Datasources(QuerysetEndpoint):
         datasource_id: str,
         filepath: Optional[PathOrFileW] = None,
         include_extract: bool = True,
-        no_extract: Optional[bool] = None,
     ) -> str:
-        return self.download_revision(datasource_id, None, filepath, include_extract, no_extract)
+        return self.download_revision(
+            datasource_id,
+            None,
+            filepath,
+            include_extract,
+        )
 
     # Update datasource
     @api(version="2.0")
@@ -351,17 +355,6 @@ class Datasources(QuerysetEndpoint):
     def populate_permissions(self, item: DatasourceItem) -> None:
         self._permissions.populate(item)
 
-    @api(version="2.0")
-    def update_permission(self, item, permission_item):
-        import warnings
-
-        warnings.warn(
-            "Server.datasources.update_permission is deprecated, "
-            "please use Server.datasources.update_permissions instead.",
-            DeprecationWarning,
-        )
-        self._permissions.update(item, permission_item)
-
     @api(version="2.0")
     def update_permissions(self, item: DatasourceItem, permission_item: List["PermissionsRule"]) -> None:
         self._permissions.update(item, permission_item)
@@ -415,7 +408,6 @@ class Datasources(QuerysetEndpoint):
         revision_number: str,
         filepath: Optional[PathOrFileW] = None,
         include_extract: bool = True,
-        no_extract: Optional[bool] = None,
     ) -> PathOrFileW:
         if not datasource_id:
             error = "Datasource ID undefined."
@@ -424,14 +416,6 @@ class Datasources(QuerysetEndpoint):
             url = "{0}/{1}/content".format(self.baseurl, datasource_id)
         else:
             url = "{0}/{1}/revisions/{2}/content".format(self.baseurl, datasource_id, revision_number)
-        if no_extract is False or no_extract is True:
-            import warnings
-
-            warnings.warn(
-                "no_extract is deprecated, use include_extract instead.",
-                DeprecationWarning,
-            )
-            include_extract = not no_extract
 
         if not include_extract:
             url += "?includeExtract=False"

tableauserverclient/server/endpoint/endpoint.py

@@ -1,9 +1,13 @@
 from tableauserverclient import datetime_helpers as datetime
 
+import abc
 from packaging.version import Version
 from functools import wraps
 from xml.etree.ElementTree import ParseError
-from typing import Any, Callable, Dict, Optional, TYPE_CHECKING, Union
+from typing import Any, Callable, Dict, Generic, List, Optional, TYPE_CHECKING, Tuple, TypeVar, Union
+
+from tableauserverclient.models.pagination_item import PaginationItem
+from tableauserverclient.server.request_options import RequestOptions
 
 from .exceptions import (
     ServerResponseError,
@@ -300,25 +304,36 @@ def parameter_added_in(**params):
     return _decorator
 
 
-class QuerysetEndpoint(Endpoint):
+T = TypeVar("T")
+
+
+class QuerysetEndpoint(Endpoint, Generic[T]):
     @api(version="2.0")
-    def all(self, *args, **kwargs):
-        queryset = QuerySet(self)
+    def all(self, *args, page_size: Optional[int] = None, **kwargs) -> QuerySet[T]:
+        if args or kwargs:
+            raise ValueError(".all method takes no arguments.")
+        queryset = QuerySet(self, page_size=page_size)
         return queryset
 
     @api(version="2.0")
-    def filter(self, *_, **kwargs) -> QuerySet:
+    def filter(self, *_, page_size: Optional[int] = None, **kwargs) -> QuerySet[T]:
         if _:
             raise RuntimeError("Only keyword arguments accepted.")
-        queryset = QuerySet(self).filter(**kwargs)
+        queryset = QuerySet(self, page_size=page_size).filter(**kwargs)
         return queryset
 
     @api(version="2.0")
-    def order_by(self, *args, **kwargs):
+    def order_by(self, *args, **kwargs) -> QuerySet[T]:
+        if kwargs:
+            raise ValueError(".order_by does not accept keyword arguments.")
         queryset = QuerySet(self).order_by(*args)
         return queryset
 
     @api(version="2.0")
-    def paginate(self, **kwargs):
+    def paginate(self, **kwargs) -> QuerySet[T]:
         queryset = QuerySet(self).paginate(**kwargs)
         return queryset
+
+    @abc.abstractmethod
+    def get(self, request_options: RequestOptions) -> Tuple[List[T], PaginationItem]:
+        raise NotImplementedError(f".get has not been implemented for {self.__class__.__qualname__}")

tableauserverclient/server/endpoint/favorites_endpoint.py

@@ -1,4 +1,4 @@
-from .endpoint import Endpoint, api
+from tableauserverclient.server.endpoint.endpoint import Endpoint, api
 from requests import Response
 from tableauserverclient.helpers.logging import logger
 from tableauserverclient.models import (

tableauserverclient/server/endpoint/flow_runs_endpoint.py

@@ -13,7 +13,7 @@ if TYPE_CHECKING:
     from ..request_options import RequestOptions
 
 
-class FlowRuns(QuerysetEndpoint):
+class FlowRuns(QuerysetEndpoint[FlowRunItem]):
     def __init__(self, parent_srv: "Server") -> None:
         super(FlowRuns, self).__init__(parent_srv)
         return None

tableauserverclient/server/endpoint/flows_endpoint.py

@@ -50,7 +50,7 @@ PathOrFileR = Union[FilePath, FileObjectR]
 PathOrFileW = Union[FilePath, FileObjectW]
 
 
-class Flows(QuerysetEndpoint):
+class Flows(QuerysetEndpoint[FlowItem]):
     def __init__(self, parent_srv):
         super(Flows, self).__init__(parent_srv)
         self._resource_tagger = _ResourceTagger(parent_srv)
@@ -265,16 +265,6 @@ class Flows(QuerysetEndpoint):
     def populate_permissions(self, item: FlowItem) -> None:
         self._permissions.populate(item)
 
-    @api(version="3.3")
-    def update_permission(self, item, permission_item):
-        import warnings
-
-        warnings.warn(
-            "Server.flows.update_permission is deprecated, " "please use Server.flows.update_permissions instead.",
-            DeprecationWarning,
-        )
-        self._permissions.update(item, permission_item)
-
     @api(version="3.3")
     def update_permissions(self, item: FlowItem, permission_item: Iterable["PermissionsRule"]) -> None:
         self._permissions.update(item, permission_item)

tableauserverclient/server/endpoint/groups_endpoint.py

@@ -14,7 +14,7 @@ if TYPE_CHECKING:
     from ..request_options import RequestOptions
 
 
-class Groups(QuerysetEndpoint):
+class Groups(QuerysetEndpoint[GroupItem]):
     @property
     def baseurl(self) -> str:
         return "{0}/sites/{1}/groups".format(self.parent_srv.baseurl, self.parent_srv.site_id)
@@ -67,21 +67,7 @@ class Groups(QuerysetEndpoint):
         logger.info("Deleted single group (ID: {0})".format(group_id))
 
     @api(version="2.0")
-    def update(
-        self, group_item: GroupItem, default_site_role: Optional[str] = None, as_job: bool = False
-    ) -> Union[GroupItem, JobItem]:
-        # (1/8/2021): Deprecated starting v0.15
-        if default_site_role is not None:
-            import warnings
-
-            warnings.simplefilter("always", DeprecationWarning)
-            warnings.warn(
-                'Groups.update(...default_site_role=""...) is deprecated, '
-                "please set the minimum_site_role field of GroupItem",
-                DeprecationWarning,
-            )
-            group_item.minimum_site_role = default_site_role
-
+    def update(self, group_item: GroupItem, as_job: bool = False) -> Union[GroupItem, JobItem]:
         url = "{0}/{1}".format(self.baseurl, group_item.id)
 
         if not group_item.id:
@@ -93,7 +79,7 @@ class Groups(QuerysetEndpoint):
         elif as_job:
             url = "?".join([url, "asJob=True"])
 
-        update_req = RequestFactory.Group.update_req(group_item, None)
+        update_req = RequestFactory.Group.update_req(group_item)
         server_response = self.put_request(url, update_req)
         logger.info("Updated group item (ID: {0})".format(group_item.id))
         if as_job:

tableauserverclient/server/endpoint/jobs_endpoint.py

@@ -11,7 +11,7 @@ from tableauserverclient.helpers.logging import logger
 from typing import List, Optional, Tuple, Union
 
 
-class Jobs(QuerysetEndpoint):
+class Jobs(QuerysetEndpoint[JobItem]):
     @property
     def baseurl(self):
         return "{0}/sites/{1}/jobs".format(self.parent_srv.baseurl, self.parent_srv.site_id)

tableauserverclient/server/endpoint/metadata_endpoint.py

@@ -42,9 +42,9 @@ def extract_values(obj, key):
 
 
 def get_page_info(result):
-    next_page = extract_values(result, "hasNextPage").pop()
-    cursor = extract_values(result, "endCursor").pop()
-    return next_page, cursor
+    next_page = extract_values(result, "hasNextPage")
+    cursor = extract_values(result, "endCursor")
+    return next_page.pop() if next_page else None, cursor.pop() if cursor else None
 
 
 class Metadata(Endpoint):

tableauserverclient/server/endpoint/metrics_endpoint.py

@@ -18,7 +18,7 @@ if TYPE_CHECKING:
 from tableauserverclient.helpers.logging import logger
 
 
-class Metrics(QuerysetEndpoint):
+class Metrics(QuerysetEndpoint[MetricItem]):
     def __init__(self, parent_srv: "Server") -> None:
         super(Metrics, self).__init__(parent_srv)
         self._resource_tagger = _ResourceTagger(parent_srv)

tableauserverclient/server/endpoint/projects_endpoint.py

@@ -1,22 +1,22 @@
 import logging
 
-from .default_permissions_endpoint import _DefaultPermissionsEndpoint
-from .endpoint import QuerysetEndpoint, api, XML_CONTENT_TYPE
-from .exceptions import MissingRequiredFieldError
-from .permissions_endpoint import _PermissionsEndpoint
+from tableauserverclient.server.endpoint.default_permissions_endpoint import _DefaultPermissionsEndpoint
+from tableauserverclient.server.endpoint.endpoint import QuerysetEndpoint, api, XML_CONTENT_TYPE
+from tableauserverclient.server.endpoint.exceptions import MissingRequiredFieldError
+from tableauserverclient.server.endpoint.permissions_endpoint import _PermissionsEndpoint
 from tableauserverclient.server import RequestFactory, RequestOptions
 from tableauserverclient.models import ProjectItem, PaginationItem, Resource
 
 from typing import List, Optional, Tuple, TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from ..server import Server
-    from ..request_options import RequestOptions
+    from tableauserverclient.server.server import Server
+    from tableauserverclient.server.request_options import RequestOptions
 
 from tableauserverclient.helpers.logging import logger
 
 
-class Projects(QuerysetEndpoint):
+class Projects(QuerysetEndpoint[ProjectItem]):
     def __init__(self, parent_srv: "Server") -> None:
         super(Projects, self).__init__(parent_srv)
 
@@ -75,17 +75,6 @@ class Projects(QuerysetEndpoint):
     def populate_permissions(self, item: ProjectItem) -> None:
         self._permissions.populate(item)
 
-    @api(version="2.0")
-    def update_permission(self, item, rules):
-        import warnings
-
-        warnings.warn(
-            "Server.projects.update_permission is deprecated, "
-            "please use Server.projects.update_permissions instead.",
-            DeprecationWarning,
-        )
-        return self._permissions.update(item, rules)
-
     @api(version="2.0")
     def update_permissions(self, item, rules):
         return self._permissions.update(item, rules)

tableauserverclient/server/endpoint/tables_endpoint.py

@@ -101,16 +101,6 @@ class Tables(Endpoint):
     def populate_permissions(self, item):
         self._permissions.populate(item)
 
-    @api(version="3.5")
-    def update_permission(self, item, rules):
-        import warnings
-
-        warnings.warn(
-            "Server.tables.update_permission is deprecated, " "please use Server.tables.update_permissions instead.",
-            DeprecationWarning,
-        )
-        return self._permissions.update(item, rules)
-
     @api(version="3.5")
     def update_permissions(self, item, rules):
         return self._permissions.update(item, rules)

tableauserverclient/server/endpoint/users_endpoint.py

@@ -11,7 +11,7 @@ from ..pager import Pager
 from tableauserverclient.helpers.logging import logger
 
 
-class Users(QuerysetEndpoint):
+class Users(QuerysetEndpoint[UserItem]):
     @property
     def baseurl(self) -> str:
         return "{0}/sites/{1}/users".format(self.parent_srv.baseurl, self.parent_srv.site_id)

tableauserverclient/server/endpoint/views_endpoint.py

@@ -21,7 +21,7 @@ if TYPE_CHECKING:
     )
 
 
-class Views(QuerysetEndpoint):
+class Views(QuerysetEndpoint[ViewItem]):
     def __init__(self, parent_srv):
         super(Views, self).__init__(parent_srv)
         self._resource_tagger = _ResourceTagger(parent_srv)
@@ -50,12 +50,14 @@ class Views(QuerysetEndpoint):
         return all_view_items, pagination_item
 
     @api(version="3.1")
-    def get_by_id(self, view_id: str) -> ViewItem:
+    def get_by_id(self, view_id: str, usage: bool = False) -> ViewItem:
         if not view_id:
             error = "View item missing ID."
             raise MissingRequiredFieldError(error)
         logger.info("Querying single view (ID: {0})".format(view_id))
         url = "{0}/{1}".format(self.baseurl, view_id)
+        if usage:
+            url += "?includeUsageStatistics=true"
         server_response = self.get_request(url)
         return ViewItem.from_response(server_response.content, self.parent_srv.namespace)[0]
 

tableauserverclient/server/endpoint/workbooks_endpoint.py

@@ -56,7 +56,7 @@ PathOrFileR = Union[FilePath, FileObjectR]
 PathOrFileW = Union[FilePath, FileObjectW]
 
 
-class Workbooks(QuerysetEndpoint):
+class Workbooks(QuerysetEndpoint[WorkbookItem]):
     def __init__(self, parent_srv: "Server") -> None:
         super(Workbooks, self).__init__(parent_srv)
         self._resource_tagger = _ResourceTagger(parent_srv)
@@ -160,13 +160,6 @@ class Workbooks(QuerysetEndpoint):
         updated_workbook = copy.copy(workbook_item)
         return updated_workbook._parse_common_tags(server_response.content, self.parent_srv.namespace)
 
-    @api(version="2.3")
-    def update_conn(self, *args, **kwargs):
-        import warnings
-
-        warnings.warn("update_conn is deprecated, please use update_connection instead")
-        return self.update_connection(*args, **kwargs)
-
     # Update workbook_connection
     @api(version="2.3")
     def update_connection(self, workbook_item: WorkbookItem, connection_item: ConnectionItem) -> ConnectionItem:
@@ -189,9 +182,13 @@ class Workbooks(QuerysetEndpoint):
         workbook_id: str,
         filepath: Optional[PathOrFileW] = None,
         include_extract: bool = True,
-        no_extract: Optional[bool] = None,
     ) -> str:
-        return self.download_revision(workbook_id, None, filepath, include_extract, no_extract)
+        return self.download_revision(
+            workbook_id,
+            None,
+            filepath,
+            include_extract,
+        )
 
     # Get all views of workbook
     @api(version="2.0")
@@ -315,21 +312,11 @@ class Workbooks(QuerysetEndpoint):
         workbook_item: WorkbookItem,
         file: PathOrFileR,
         mode: str,
-        connection_credentials: Optional["ConnectionCredentials"] = None,
         connections: Optional[Sequence[ConnectionItem]] = None,
         as_job: bool = False,
-        hidden_views: Optional[Sequence[str]] = None,
         skip_connection_check: bool = False,
         parameters=None,
     ):
-        if connection_credentials is not None:
-            import warnings
-
-            warnings.warn(
-                "connection_credentials is being deprecated. Use connections instead",
-                DeprecationWarning,
-            )
-
         if isinstance(file, (str, os.PathLike)):
             if not os.path.isfile(file):
                 error = "File path does not lead to an existing file."
@@ -391,12 +378,9 @@ class Workbooks(QuerysetEndpoint):
             logger.info("Publishing {0} to server with chunking method (workbook over 64MB)".format(workbook_item.name))
             upload_session_id = self.parent_srv.fileuploads.upload(file)
             url = "{0}&uploadSessionId={1}".format(url, upload_session_id)
-            conn_creds = connection_credentials
             xml_request, content_type = RequestFactory.Workbook.publish_req_chunked(
                 workbook_item,
-                connection_credentials=conn_creds,
                 connections=connections,
-                hidden_views=hidden_views,
             )
         else:
             logger.info("Publishing {0} to server".format(filename))
@@ -411,14 +395,11 @@ class Workbooks(QuerysetEndpoint):
             else:
                 raise TypeError("file should be a filepath or file object.")
 
-            conn_creds = connection_credentials
             xml_request, content_type = RequestFactory.Workbook.publish_req(
                 workbook_item,
                 filename,
                 file_contents,
-                connection_credentials=conn_creds,
                 connections=connections,
-                hidden_views=hidden_views,
             )
         logger.debug("Request xml: {0} ".format(redact_xml(xml_request[:1000])))
 
@@ -468,7 +449,6 @@ class Workbooks(QuerysetEndpoint):
         revision_number: Optional[str],
         filepath: Optional[PathOrFileW] = None,
         include_extract: bool = True,
-        no_extract: Optional[bool] = None,
     ) -> PathOrFileW:
         if not workbook_id:
             error = "Workbook ID undefined."
@@ -478,15 +458,6 @@ class Workbooks(QuerysetEndpoint):
         else:
             url = "{0}/{1}/revisions/{2}/content".format(self.baseurl, workbook_id, revision_number)
 
-        if no_extract is False or no_extract is True:
-            import warnings
-
-            warnings.warn(
-                "no_extract is deprecated, use include_extract instead.",
-                DeprecationWarning,
-            )
-            include_extract = not no_extract
-
         if not include_extract:
             url += "?includeExtract=False"