Add check for project collaborators and workspace members compatibility

Author: harminius

mergin/client.py

@@ -1285,6 +1285,15 @@ def has_editor_support(self):
         """
         return is_version_acceptable(self.server_version(), "2024.4.0")
 
+    def check_collaborators_members_support(self):
+        """
+        Check if the server is compatible with v2 endpoints for project collaborators and workspace members
+        https://github.com/MerginMaps/server-private/releases/tag/2025.1.0
+        """
+        min_version = "2025.1.0"
+        if not is_version_acceptable(self.server_version(), f"{min_version}"):
+            raise NotImplementedError(f"This needs server at version {min_version} or later")
+
     def create_user(
         self,
         email: str,
@@ -1304,6 +1313,7 @@ def create_user(
         param username: username - will be autogenerated from the email if not provided
         param notify_user: flag for email notifications - confirmation email will be sent
         """
+        self.check_collaborators_members_support()
         params = {
             "email": email,
             "password": password,
@@ -1320,13 +1330,15 @@ def get_workspace_member(self, workspace_id: int, user_id: int) -> dict:
         """
         Get a workspace member detail
         """
+        self.check_collaborators_members_support()
         resp = self.get(f"v2/workspaces/{workspace_id}/members/{user_id}")
         return json.load(resp)
 
     def list_workspace_members(self, workspace_id: int) -> List[dict]:
         """
         Get a list of workspace members
         """
+        self.check_collaborators_members_support()
         resp = self.get(f"v2/workspaces/{workspace_id}/members")
         return json.load(resp)
 
@@ -1338,6 +1350,7 @@ def update_workspace_member(
 
         param reset_projects_roles: all project specific roles will be removed
         """
+        self.check_collaborators_members_support()
         params = {
             "reset_projects_roles": reset_projects_roles,
             "workspace_role": workspace_role.value,
@@ -1349,12 +1362,14 @@ def remove_workspace_member(self, workspace_id: int, user_id: int):
         """
         Remove a user from workspace members
         """
+        self.check_collaborators_members_support()
         self.delete(f"v2/workspaces/{workspace_id}/members/{user_id}")
 
     def list_project_collaborators(self, project_id: str) -> List[dict]:
         """
         Get a list of project collaborators
         """
+        self.check_collaborators_members_support()
         project_collaborators = self.get(f"v2/projects/{project_id}/collaborators")
         return json.load(project_collaborators)
 
@@ -1365,6 +1380,7 @@ def add_project_collaborator(self, project_id: str, user: str, project_role: Pro
 
         param user: login (username or email) of the user
         """
+        self.check_collaborators_members_support()
         params = {"role": project_role.value, "user": user}
         project_collaborator = self.post(f"v2/projects/{project_id}/collaborators", params, json_headers)
         return json.load(project_collaborator)
@@ -1374,6 +1390,7 @@ def update_project_collaborator(self, project_id: str, user_id: int, project_rol
         Update project role of the existing project collaborator.
         Fails if user is not a member of the project yet.
         """
+        self.check_collaborators_members_support()
         params = {"role": project_role.value}
         project_collaborator = self.patch(f"v2/projects/{project_id}/collaborators/{user_id}", params, json_headers)
         return json.load(project_collaborator)
@@ -1382,6 +1399,7 @@ def remove_project_collaborator(self, project_id: str, user_id: int):
         """
         Remove a user from project collaborators
         """
+        self.check_collaborators_members_support()
         self.delete(f"v2/projects/{project_id}/collaborators/{user_id}")
 
     def server_config(self) -> dict: