add tags to clone and update (#400)

* add tags to clone and update

* buid fix

* Update common.py

* change "Tag" to "Environment", and "Custom Tags" to "Tags"

* add list projects

* change set tags to update tags

* revert unnecessary changes

* fix diff

* fix diff space

* Revert "fix diff space"

This reverts commit 1ea141f.

* fix diff space

* fix prehook

* Update requirements.txt

* Update requirements.txt

Author: OfekAvergil

README.md

@@ -1281,6 +1281,9 @@ create a new one.
 # Change the project name
 descope_client.mgmt.project.change_name("new-project-name")
 
+# Change project's tags
+descope_client.mgmt.project.update_tags(["new", "python"])
+
 # Clone the current project, including its settings and configurations.
 # Note that this action is supported only with a pro license or above.
 # Users, tenants and access keys are not cloned.

descope/management/common.py

@@ -131,9 +131,11 @@ class MgmtV1:
 
     # Project
     project_update_name = "/v1/mgmt/project/update/name"
+    project_update_tags = "/v1/mgmt/project/update/tags"
     project_clone = "/v1/mgmt/project/clone"
     project_export = "/v1/mgmt/project/export"
     project_import = "/v1/mgmt/project/import"
+    project_list_projects = "/v1/mgmt/projects/list"
 
 
 class AssociatedTenant:

descope/management/project.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import List, Optional
 
 from descope._auth_base import AuthBase
 from descope.management.common import MgmtV1
@@ -25,10 +25,60 @@ def update_name(
             pswd=self._auth.management_key,
         )
 
+    def update_tags(
+        self,
+        tags: List[str],
+    ):
+        """
+        Update the current project tags.
+
+        Args:
+        tags (List[str]):  Array of free text tags.
+        Raise:
+        AuthException: raised if operation fails
+        """
+        self._auth.do_post(
+            MgmtV1.project_update_tags,
+            {
+                "tags": tags,
+            },
+            pswd=self._auth.management_key,
+        )
+
+    def list_projects(
+        self,
+    ) -> dict:
+        """
+        List of all the projects in the company.
+
+        Return value (dict):
+        Return dict in the format
+             {"projects": []}
+        "projects" contains a list of all of the projects and their information
+
+        Raise:
+        AuthException: raised if operation fails
+        """
+        response = self._auth.do_post(
+            MgmtV1.project_list_projects,
+            {},
+            pswd=self._auth.management_key,
+        )
+        resp = response.json()
+
+        projects = resp["projects"]
+        # Apply the function to the projects list
+        formatted_projects = self.remove_tag_field(projects)
+
+        # Return the same structure with 'tag' removed
+        result = {"projects": formatted_projects}
+        return result
+
     def clone(
         self,
         name: str,
-        tag: Optional[str] = None,
+        environment: Optional[str] = None,
+        tags: Optional[List[str]] = None,
     ):
         """
         Clone the current project, including its settings and configurations.
@@ -37,10 +87,11 @@ def clone(
 
         Args:
         name (str): The new name for the project.
-        tag (str): Optional tag for the project. Currently, only the "production" tag is supported.
+        environment (str): Optional state for the project. Currently, only the "production" tag is supported.
+        tags(list[str]): Optional free text tags.
 
         Return value (dict):
-        Return dict Containing the new project details (name, id, and tag).
+        Return dict Containing the new project details (name, id, environment and tag).
 
         Raise:
         AuthException: raised if clone operation fails
@@ -49,7 +100,8 @@ def clone(
             MgmtV1.project_clone,
             {
                 "name": name,
-                "tag": tag,
+                "environment": environment,
+                "tags": tags,
             },
             pswd=self._auth.management_key,
         )
@@ -95,11 +147,17 @@ def import_project(
         Raise:
         AuthException: raised if import operation fails
         """
-        response = self._auth.do_post(
+        self._auth.do_post(
             MgmtV1.project_import,
             {
                 "files": files,
             },
             pswd=self._auth.management_key,
         )
         return
+
+    # Function to remove 'tag' field from each project
+    def remove_tag_field(self, projects):
+        return [
+            {k: v for k, v in project.items() if k != "tag"} for project in projects
+        ]