Added 3 new bundle functions with basic unit tests (#72)

Author: Pawes

crowdin_api/api_resources/bundles/resource.py

@@ -14,13 +14,18 @@ class BundlesResource(BaseResource):
     Link to documentation for enterprise:
     https://developer.crowdin.com/enterprise/api/v2/#tag/Bundles
     """
-
     def get_bundles_path(self, projectId: int, bundleId: Optional[int] = None):
         if bundleId:
             return f"projects/{projectId}/bundles/{bundleId}"
 
         return f"projects/{projectId}/bundles"
 
+    def get_bundles_exports_path(self, projectId:int, bundleId:int, exportId: Optional[str] = None):
+        bundles_path = self.get_bundles_path(projectId, bundleId)
+        if exportId:
+            return f"{bundles_path}/exports/{exportId}"
+        return f"{bundles_path}/exports"
+
     def list_bundles(
         self,
         projectId: int,
@@ -127,6 +132,68 @@ def edit_bundle(self, projectId: int, bundleId: int, data: Iterable[BundlePatchR
             request_data=data,
         )
 
+    def download_bundle(
+        self,
+        projectId: int,
+        bundleId: int,
+        exportId: str
+    ):
+        """
+        Download bundle.
+
+        Link to documentation:
+        https://developer.crowdin.com/api/v2/#operation/api.projects.bundles.exports.download.get
+
+        Link to documentation for enterprise:
+        https://developer.crowdin.com/enterprise/api/v2/#operation/api.projects.bundles.exports.download.get
+        """
+
+        return self.requester.request(
+            method="get",
+            path=f"{self.get_bundles_exports_path(projectId=projectId, bundleId=bundleId, exportId=exportId)}/download",
+        )
+
+    def export_bundle(
+        self,
+        projectId: int,
+        bundleId: int
+    ):
+        """
+        Export bundle.
+
+        Link to documentation:
+        https://developer.crowdin.com/api/v2/#operation/api.projects.bundles.exports.post
+
+        Link to documentation for enterprise:
+        https://developer.crowdin.com/enterprise/api/v2/#operation/api.projects.bundles.exports.post
+        """
+
+        return self.requester.request(
+            method="post",
+            path=self.get_bundles_exports_path(projectId=projectId, bundleId=bundleId),
+        )
+
+    def check_bundle_export_status(
+        self,
+        projectId: int,
+        bundleId: int,
+        exportId: str
+    ):
+        """
+        Check Bundle Export Status.
+
+        Link to documentation:
+        https://developer.crowdin.com/api/v2/#operation/api.projects.bundles.exports.get
+
+        Link to documentation for enterprise:
+        https://developer.crowdin.com/enterprise/api/v2/#operation/api.projects.bundles.exports.get
+        """
+
+        return self.requester.request(
+            method="get",
+            path=self.get_bundles_exports_path(projectId=projectId, bundleId=bundleId, exportId=exportId),
+        )
+
     def get_bundle_list_files(
         self,
         projectId: int,

crowdin_api/api_resources/bundles/tests/test_bundles_resources.py

@@ -21,11 +21,21 @@ def get_resource(self, base_absolut_url):
             ({"projectId": 1, "bundleId": 1}, "projects/1/bundles/1"),
         ),
     )
-    def test_get_reports_path(self, incoming_data, path, base_absolut_url):
-
+    def test_get_bundles_path(self, incoming_data, path, base_absolut_url):
         resource = self.get_resource(base_absolut_url)
         assert resource.get_bundles_path(**incoming_data) == path
 
+    @pytest.mark.parametrize(
+        "incoming_data, path",
+        (
+            ({"projectId": 1, "bundleId": 2}, "projects/1/bundles/2/exports"),
+            ({"projectId": 1, "bundleId": 2, "exportId": "3"}, "projects/1/bundles/2/exports/3"),
+        ),
+    )
+    def test_get_bundles_exports_path(self, incoming_data, path, base_absolut_url):
+        resource = self.get_resource(base_absolut_url)
+        assert resource.get_bundles_exports_path(**incoming_data) == path
+
     @mock.patch("crowdin_api.requester.APIRequester.request")
     def test_get_bundle(self, m_request, base_absolut_url):
         m_request.return_value = "response"
@@ -159,6 +169,36 @@ def test_edit_bundle(self, m_request, base_absolut_url, value):
             path=resource.get_bundles_path(projectId=1, bundleId=1),
         )
 
+    @mock.patch("crowdin_api.requester.APIRequester.request")
+    def test_download_bundle(self, m_request, base_absolut_url):
+        m_request.return_value = "response"
+
+        resource = self.get_resource(base_absolut_url)
+        assert resource.download_bundle(projectId=1, bundleId=1, exportId="1") == "response"
+        m_request.assert_called_once_with(
+            method="get", path=f"{resource.get_bundles_exports_path(projectId=1, bundleId=1, exportId='1')}/download"
+        )
+
+    @mock.patch("crowdin_api.requester.APIRequester.request")
+    def test_export_bundle(self, m_request, base_absolut_url):
+        m_request.return_value = "response"
+
+        resource = self.get_resource(base_absolut_url)
+        assert resource.export_bundle(projectId=1, bundleId=1) == "response"
+        m_request.assert_called_once_with(
+            method="post", path=resource.get_bundles_exports_path(projectId=1, bundleId=1)
+        )
+
+    @mock.patch("crowdin_api.requester.APIRequester.request")
+    def test_check_bundle_export_status(self, m_request, base_absolut_url):
+        m_request.return_value = "response"
+
+        resource = self.get_resource(base_absolut_url)
+        assert resource.check_bundle_export_status(projectId=1, bundleId=1, exportId="1") == "response"
+        m_request.assert_called_once_with(
+            method="get", path=resource.get_bundles_exports_path(projectId=1, bundleId=1, exportId="1")
+        )
+
     @pytest.mark.parametrize(
         "incoming_data, request_params",
         (