collibra-connector 1.1.1__py3-none-any.whl → 1.1.2__py3-none-any.whl

collibra_connector/api/UserGroup.py

@@ -0,0 +1,95 @@
+import uuid
+from .Base import BaseAPI
+
+
+class UserGroup(BaseAPI):
+    def __init__(self, connector):
+        super().__init__(connector)
+        self.__base_api = connector.api + "/userGroups"
+
+    def find_user_groups(
+        self,
+        count_limit: int = -1,
+        include_everyone: bool = None,
+        limit: int = 0,
+        name: str = None,
+        name_match_mode: str = "ANYWHERE",
+        offset: int = 0,
+        user_id: str = None
+    ):
+        """
+        Find user groups matching the given search criteria.
+
+        Returns user groups matching the given search criteria. Only parameters that are specified
+        in this request and have not null values are used for filtering. All other parameters are
+        ignored. By default a result containing 1000 user groups is returned.
+
+        :param count_limit: Limit the number of elements that will be counted. -1 counts everything,
+                            0 skips count. Default: -1
+        :param include_everyone: Indicates if we should include the everyone group or not.
+        :param limit: Maximum number of results to retrieve (0 = default limit, max 1000). Default: 0
+        :param name: The name of the user group.
+        :param name_match_mode: The match mode used to compare name. If the match mode is EXACT
+                                the search is case-sensitive, otherwise case-insensitive.
+                                Allowed values: START, END, ANYWHERE, EXACT. Default: ANYWHERE
+        :param offset: First result to retrieve (0-based). Default: 0
+        :param user_id: The ID of the user who should belong to searched user groups.
+        :return: Search results with user groups matching the criteria.
+        """
+        # Validate count_limit
+        if not isinstance(count_limit, int):
+            raise ValueError("count_limit must be an integer")
+
+        # Validate include_everyone
+        if include_everyone is not None and not isinstance(include_everyone, bool):
+            raise ValueError("include_everyone must be a boolean")
+
+        # Validate limit
+        if not isinstance(limit, int) or limit < 0:
+            raise ValueError("limit must be a non-negative integer")
+        if limit > 1000:
+            raise ValueError("limit cannot exceed 1000")
+
+        # Validate name
+        if name is not None and not isinstance(name, str):
+            raise ValueError("name must be a string")
+
+        # Validate name_match_mode
+        valid_match_modes = ["START", "END", "ANYWHERE", "EXACT"]
+        if name_match_mode not in valid_match_modes:
+            raise ValueError(f"Invalid name_match_mode: {name_match_mode}. "
+                             f"Allowed values: {valid_match_modes}")
+
+        # Validate offset
+        if not isinstance(offset, int) or offset < 0:
+            raise ValueError("offset must be a non-negative integer")
+
+        # Validate user_id if provided
+        if user_id is not None:
+            if not isinstance(user_id, str):
+                raise ValueError("user_id must be a string")
+            try:
+                uuid.UUID(user_id)
+            except ValueError as exc:
+                raise ValueError("user_id must be a valid UUID") from exc
+
+        # Build parameters
+        params = {
+            "countLimit": count_limit,
+            "limit": limit,
+            "nameMatchMode": name_match_mode,
+            "offset": offset
+        }
+
+        # Add optional parameters
+        if include_everyone is not None:
+            params["includeEveryone"] = include_everyone
+
+        if name is not None:
+            params["name"] = name
+
+        if user_id is not None:
+            params["userId"] = user_id
+
+        response = self._get(url=self.__base_api, params=params)
+        return self._handle_response(response)

collibra_connector/api/__init__.py

@@ -1,29 +1,31 @@
 from .Asset import Asset
 from .Attribute import Attribute
+from .Comment import Comment
 from .Community import Community
 from .Domain import Domain
-from .User import User
-from .Responsibility import Responsibility
-from .Workflow import Workflow
 from .Metadata import Metadata
-from .Comment import Comment
-from .Relation import Relation
 from .OutputModule import OutputModule
-from .Utils import Utils
+from .Relation import Relation
+from .Responsibility import Responsibility
 from .Search import Search
+from .User import User
+from .UserGroup import UserGroup
+from .Utils import Utils
+from .Workflow import Workflow
 
 __all__ = [
     "Asset",
     "Attribute",
+    "Comment",
     "Community",
     "Domain",
-    "User",
-    "Responsibility",
-    "Workflow",
     "Metadata",
-    "Comment",
-    "Relation",
     "OutputModule",
+    "Relation",
+    "Responsibility",
+    "Search",
+    "User",
+    "UserGroup",
     "Utils",
-    "Search"
-]
+    "Workflow",
+]

collibra_connector/connector.py

@@ -16,17 +16,18 @@ from requests.auth import HTTPBasicAuth
 from .api import (
     Asset,
     Attribute,
+    Comment,
     Community,
     Domain,
-    User,
-    Responsibility,
-    Workflow,
     Metadata,
-    Comment,
-    Relation,
     OutputModule,
+    Relation,
+    Responsibility,
+    Search,
+    User,
+    UserGroup,
     Utils,
-    Search
+    Workflow,
 )
 
 if TYPE_CHECKING:
@@ -85,7 +86,7 @@ class CollibraConnector:
     ) -> None:
         """
         Initialize the CollibraConnector with API URL and authentication credentials.
-        
+
         Credentials can be provided as arguments or via environment variables:
         COLLIBRA_URL, COLLIBRA_USERNAME, COLLIBRA_PASSWORD.
 
@@ -130,18 +131,19 @@ class CollibraConnector:
         # Initialize all API classes
         self.asset: Asset = Asset(self)
         self.attribute: Attribute = Attribute(self)
+        self.comment: Comment = Comment(self)
         self.community: Community = Community(self)
         self.domain: Domain = Domain(self)
-        self.user: User = User(self)
         self.responsibility: Responsibility = Responsibility(self)
-        self.workflow: Workflow = Workflow(self)
         self.metadata: Metadata = Metadata(self)
-        self.comment: Comment = Comment(self)
-        self.relation: Relation = Relation(self)
         self.output_module: OutputModule = OutputModule(self)
-        self.utils: Utils = Utils(self)
+        self.relation: Relation = Relation(self)
         self.search: Search = Search(self)
-        
+        self.user: User = User(self)
+        self.user_group: UserGroup = UserGroup(self)
+        self.utils: Utils = Utils(self)
+        self.workflow: Workflow = Workflow(self)
+
         # Initialize Logger without basicConfig
         self.logger: logging.Logger = logging.getLogger(__name__)
         self.logger.addHandler(logging.NullHandler())

{collibra_connector-1.1.1.dist-info → collibra_connector-1.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: collibra-connector
-Version: 1.1.1
+Version: 1.1.2
 Summary: An UNOFFICIAL standard Python connector for the Collibra Data Governance Center API with full type safety, async support, and enterprise features.
 Author-email: Raul Dalgamonni <rauldalgamonnialonso@gmail.com>
 Project-URL: Homepage, https://github.com/rauldaal/collibra-python-connector

{collibra_connector-1.1.1.dist-info → collibra_connector-1.1.2.dist-info}/RECORD

@@ -1,7 +1,7 @@
 collibra_connector/__init__.py,sha256=_v9ZZdcmpiqO_sRHxH91iQ9j5EybGHKGzzjn6mmM6uI,8455
 collibra_connector/async_connector.py,sha256=u90fNMkEfrhaWV7E4Jmy6MIwq_MSFrHOZTuF22Gfw6Q,30035
 collibra_connector/cli.py,sha256=xQ4sv8lOSdEqJh_l8u3yUJ5J90nfwWtaGtaH3lhzMTg,21070
-collibra_connector/connector.py,sha256=FexvbCc3u2b35OC6OoMVOqLXziUNEweMM8KLPpsUAJc,10902
+collibra_connector/connector.py,sha256=AlKg-qYdbOahLStaXlcF5a9N11ZYwLvINckQL9nUgwQ,10955
 collibra_connector/helpers.py,sha256=rI_ktaSoBJJHAPfHS2BkNhiaD-QUTYerTpMKyxcokgQ,27284
 collibra_connector/lineage.py,sha256=nKHEslyW_EQDVCZPTBKQezGFYnc_myQivZhpBtUB5Xg,23752
 collibra_connector/models.py,sha256=eQzHwg8y7iUjUG7TkZ9zS5gPAdLHgMLJGJyIbv8YPEo,33116
@@ -21,12 +21,13 @@ collibra_connector/api/Relation.py,sha256=JigNrLBCtisQnoA1BMzHapilfmkY2Mgg67kVoR
 collibra_connector/api/Responsibility.py,sha256=sUJw3IB5IQmMRw1Iur2ZieZg-4MDu4j7gfQc90FaD0c,14146
 collibra_connector/api/Search.py,sha256=0Trq03PnuroX9FFHxM1Herdqnq0ObY0Tsp5FaOgPgSs,3255
 collibra_connector/api/User.py,sha256=rUfnR0x_vnIk8h2SJ0RITpC4nKPw-e3-zwKIK8ZEuKc,7776
+collibra_connector/api/UserGroup.py,sha256=9mUkEpAbjhRW-t33nzqYhFHiTS_XrLabROfBdCTCvt8,3795
 collibra_connector/api/Utils.py,sha256=W_XC-ypF_dh0zeqN2RMdyJIQzuQJ0nBysKctee8jZAg,5262
 collibra_connector/api/Workflow.py,sha256=H3bWwp6QsxkSAXzELspLFzxUkLi7kL026TFf1CyO98E,12729
-collibra_connector/api/__init__.py,sha256=wPQd8yaA1BHVzdVtHMPoLjU6nFRJ0EYAuQPAbvrmcms,615
-collibra_connector-1.1.1.dist-info/licenses/LICENSE,sha256=6KmWWtAu_q58gerPlrnkgsmGM2l8j6Wc_VL0y4S_ip4,1079
-collibra_connector-1.1.1.dist-info/METADATA,sha256=CjQXgwrBWRawKv70iSwD7cvyxeg3goPBARrkG_Oe5I8,14545
-collibra_connector-1.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-collibra_connector-1.1.1.dist-info/entry_points.txt,sha256=zlG5yxZgcgj760CjxUGt4bPrwzvYHThedSs0WAIBhWY,61
-collibra_connector-1.1.1.dist-info/top_level.txt,sha256=Vs-kR64zf__ebL2j3_AEx7rhO6xkwgmHUFRzxlQPgTQ,19
-collibra_connector-1.1.1.dist-info/RECORD,,
+collibra_connector/api/__init__.py,sha256=qNnVU_A8C8T-yNAdcCXJAQVpECtbYJeXs9xLUG7-xjM,667
+collibra_connector-1.1.2.dist-info/licenses/LICENSE,sha256=6KmWWtAu_q58gerPlrnkgsmGM2l8j6Wc_VL0y4S_ip4,1079
+collibra_connector-1.1.2.dist-info/METADATA,sha256=FL_Xz3d9pTb5Ged2iZZvDIA0bLyRvGKIsCiOPqzddHY,14545
+collibra_connector-1.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+collibra_connector-1.1.2.dist-info/entry_points.txt,sha256=zlG5yxZgcgj760CjxUGt4bPrwzvYHThedSs0WAIBhWY,61
+collibra_connector-1.1.2.dist-info/top_level.txt,sha256=Vs-kR64zf__ebL2j3_AEx7rhO6xkwgmHUFRzxlQPgTQ,19
+collibra_connector-1.1.2.dist-info/RECORD,,