collibra-connector 1.0.6__py3-none-any.whl → 1.0.7__py3-none-any.whl

collibra_connector/api/Asset.py

@@ -0,0 +1,73 @@
+from .Base import BaseAPI
+
+class Asset(BaseAPI):
+    def __init__(self, connector):
+        super().__init__(connector)
+        self.__base_api = connector.api + "/assets"
+
+    def __get(self, url: str = None, params: dict = None, headers: dict = None):
+        """
+        Makes a GET request to the asset API.
+        :param url: The URL to send the GET request to.
+        :param params: Optional parameters to include in the GET request.
+        :param headers: Optional headers to include in the GET request.
+        :return: The response from the GET request.
+        """
+        return super().__get(self.__base_api if not url else url, params, headers)
+
+    def __post(self, url: str, data: dict):
+        """
+        Makes a POST request to the asset API.
+        :param url: The URL to send the POST request to.
+        :param data: The data to send in the POST request.
+        :return: The response from the POST request.
+        """
+        return super().__post(url, data)
+
+    def __handle_response(self, response):
+        return super().__handle_response(response)
+    
+    def get_asset(self, asset_id):
+        """
+        Retrieves an asset by its ID.
+        :param asset_id: The ID of the asset to retrieve.
+        :return: Asset details.
+        """
+        response = self.__get(url=f"{self.__base_api}/{asset_id}")
+        return self.__handle_response(response)
+
+    def add_asset(
+        self,
+        name: str,
+        domain_id: str,
+        display_name: str = None,
+        type_id: str = None,
+        id: str = None,
+        status_id: str = None,
+        excluded_from_auto_hyperlink: bool = False,
+        type_public_id: str = None,
+    ):
+        """
+        Adds a new asset.
+        :param name: The name of the asset.
+        :param domain_id: The ID of the domain to which the asset belongs.
+        :param display_name: Optional display name for the asset.
+        :param type_id: Optional type ID for the asset.
+        :param id: Optional ID for the asset.
+        :param status_id: Optional status ID for the asset.
+        :param excluded_from_auto_hyperlink: Whether the asset is excluded from auto hyperlinking.
+        :param type_public_id: Optional public ID for the asset type.
+        :return: Details of the created asset.
+        """
+        data = {
+            "name": name,
+            "domainId": domain_id,
+            "displayName": display_name,
+            "typeId": type_id,
+            "id": id,
+            "statusId": status_id,
+            "excludedFromAutoHyperlink": excluded_from_auto_hyperlink,
+            "typePublicId": type_public_id
+        }
+        response = self.__post(url=self.__base_api, data=data)
+        return self.__handle_response(response)

collibra_connector/api/Base.py

@@ -0,0 +1,72 @@
+import requests
+from .Exceptions import (
+    UnauthorizedError,
+    ForbiddenError,
+    NotFoundError,
+    ServerError
+)
+
+class BaseAPI:
+    def __init__(self, connector):
+        self.__connector = connector
+        self.__base_api = connector.api
+        self.__header = {
+            "Content-Type": "application/json",
+            "Accept": "application/json"
+        }
+        self.__params = None
+
+    def __get(self, url: str = None, params: dict = None, headers: dict = None):
+        """
+        Makes a GET request to the specified URL.
+        :param url: The URL to send the GET request to.
+        :param params: Optional parameters to include in the GET request.
+        :param headers: Optional headers to include in the GET request.
+        :return: The response from the GET request.
+        """
+        url = self.__base_api if not url else url
+        headers = self.__header if not headers else headers
+        params = self.__params if not params else params
+        return requests.get(
+            url,
+            auth=self.__connector.auth,
+            params=params,
+            headers=headers
+        )
+
+    def __post(self, url: str, data: dict, headers: dict = None):
+        """
+        Makes a POST request to the specified URL with the given data.
+        :param url: The URL to send the POST request to.
+        :param data: The data to send in the POST request.
+        :return: The response from the POST request.
+        """
+        url = self.__base_api if not url else url
+        headers = self.__header if not headers else headers
+        if not isinstance(data, dict):
+            raise ValueError("Data must be a dictionary")
+        if not data:
+            raise ValueError("Data cannot be empty")
+        return requests.post(
+            url,
+            auth=self.__connector.auth,
+            json=data,
+            headers=self.__header
+        )
+
+    def __handle_response(self, response):
+        """
+        Handles the response from the API.
+        :param response: The response object from the API request.
+        :return: The JSON content of the response if successful, otherwise raises an error.
+        """
+        if response.status_code == 200 or response.status_code == 201:
+            return response.json()
+        elif response.status_code == 401:
+            raise UnauthorizedError("Unauthorized access - invalid credentials")
+        elif response.status_code == 403:
+            raise ForbiddenError("Forbidden access - insufficient permissions")
+        elif response.status_code == 404:
+            raise NotFoundError("The specified resource was not found")
+        elif response.status_code >= 500:
+            raise ServerError("Internal server error - something went wrong on the server")

collibra_connector/api/Exceptions.py

@@ -0,0 +1,19 @@
+class CollibraAPIError(Exception):
+    """Base exception for Collibra API errors"""
+    pass
+
+class UnauthorizedError(CollibraAPIError):
+    """Raised when authentication fails"""
+    pass
+
+class ForbiddenError(CollibraAPIError):
+    """Raised when access is forbidden"""
+    pass
+
+class NotFoundError(CollibraAPIError):
+    """Raised when resource is not found"""
+    pass
+
+class ServerError(CollibraAPIError):
+    """Raised when server returns 5xx errors"""
+    pass

collibra_connector/api/__init__.py

@@ -0,0 +1,2 @@
+from .Asset import Asset
+from .Base import BaseAPI

{collibra_connector-1.0.6.dist-info → collibra_connector-1.0.7.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: collibra-connector
-Version: 1.0.6
-Summary: A standard Python connector for the Collibra Data Governance Center API.
+Version: 1.0.7
+Summary: An UNOFICIAL standard Python connector for the Collibra Data Governance Center API.
 Author-email: Raül Dalgamonni <rauldalgamonnialonso@gmail.com>
 Project-URL: Homepage, https://github.com/rauldaal/collibra-python-connector
 Project-URL: Bug Tracker, https://github.com/rauldaal/collibra-python-connector

collibra_connector-1.0.7.dist-info/RECORD

@@ -0,0 +1,11 @@
+collibra_connector/__init__.py,sha256=qBiWD8_hxRjggbCZRd-mDJ0rN5jVBF-KTNqEAJHtkEY,1879
+collibra_connector/connector.py,sha256=ejgLrPbbHHFm4PW6DI6DqKjZVr-ZBGBjq4TUPke9vAE,1668
+collibra_connector/api/Asset.py,sha256=fBROJPuQsUn0A_m7SlQ-ImhcIMY_9Kq0QM-IOFBGG6A,2734
+collibra_connector/api/Base.py,sha256=d0SOIZQv95-SSgJHD-gYcGf3pUNqth7U2LlLffEOFFw,2767
+collibra_connector/api/Exceptions.py,sha256=cHmDByGx1UgLsVMbiS_vXVArRAmKUP1y3vgqu2cjCTo,469
+collibra_connector/api/__init__.py,sha256=eXm8RTRE5dWlEcIGwVjFJKy07Ux4wvL1BtgWBj-5vng,51
+collibra_connector-1.0.7.dist-info/licenses/LICENSE,sha256=6KmWWtAu_q58gerPlrnkgsmGM2l8j6Wc_VL0y4S_ip4,1079
+collibra_connector-1.0.7.dist-info/METADATA,sha256=ixBDQs8mzOwBhLg5SgWYlajZUmXg2hpIhueM_ebWYpU,970
+collibra_connector-1.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+collibra_connector-1.0.7.dist-info/top_level.txt,sha256=Vs-kR64zf__ebL2j3_AEx7rhO6xkwgmHUFRzxlQPgTQ,19
+collibra_connector-1.0.7.dist-info/RECORD,,

collibra_connector-1.0.6.dist-info/RECORD

@@ -1,7 +0,0 @@
-collibra_connector/__init__.py,sha256=qBiWD8_hxRjggbCZRd-mDJ0rN5jVBF-KTNqEAJHtkEY,1879
-collibra_connector/connector.py,sha256=ejgLrPbbHHFm4PW6DI6DqKjZVr-ZBGBjq4TUPke9vAE,1668
-collibra_connector-1.0.6.dist-info/licenses/LICENSE,sha256=6KmWWtAu_q58gerPlrnkgsmGM2l8j6Wc_VL0y4S_ip4,1079
-collibra_connector-1.0.6.dist-info/METADATA,sha256=CRni0wpuPu2VOIDtwj-XJgi8u6lEjQgXTxzvrUfTQK0,959
-collibra_connector-1.0.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-collibra_connector-1.0.6.dist-info/top_level.txt,sha256=Vs-kR64zf__ebL2j3_AEx7rhO6xkwgmHUFRzxlQPgTQ,19
-collibra_connector-1.0.6.dist-info/RECORD,,