chore: add deprecation warning for mirror_pull functions

nicoklaus · nejch · commit 7f6fd5c3aac5 · 2025-01-28T11:50:03.000+01:00
diff --git a/gitlab/v4/objects/projects.py b/gitlab/v4/objects/projects.py
@@ -608,6 +608,13 @@ def mirror_pull(self, **kwargs: Any) -> None:
             GitlabAuthenticationError: If authentication is not correct
             GitlabCreateError: If the server failed to perform the request
         """
+        utils.warn(
+            message=(
+                "project.mirror_pull() is deprecated and will be removed in a "
+                "future major version. Use project.pull_mirror.start() instead."
+            ),
+            category=DeprecationWarning,
+        )
         path = f"/projects/{self.encoded_id}/mirror/pull"
         self.manager.gitlab.http_post(path, **kwargs)
 
@@ -628,6 +635,13 @@ def mirror_pull_details(self, **kwargs: Any) -> Dict[str, Any]:
         Returns:
             dict of the parsed json returned by the server
         """
+        utils.warn(
+            message=(
+                "project.mirror_pull_details() is deprecated and will be removed in a "
+                "future major version. Use project.pull_mirror.get() instead."
+            ),
+            category=DeprecationWarning,
+        )
         path = f"/projects/{self.encoded_id}/mirror/pull"
         result = self.manager.gitlab.http_get(path, **kwargs)
         if TYPE_CHECKING:
