personal_knowledge_library 3.2.0__py3-none-any.whl → 3.2.2__py3-none-any.whl

knowledge/__init__.py

@@ -17,7 +17,7 @@ __license__ = "Wacom"
 __maintainer__ = ["Markus Weber"]
 __email__ = "markus.weber@wacom.com"
 __status__ = "beta"
-__version__ = "3.2.0"
+__version__ = "3.2.2"
 
 import loguru
 

knowledge/services/asyncio/graph.py

@@ -180,6 +180,61 @@ class AsyncWacomKnowledgeService(AsyncServiceAPIClient):
         thing: ThingObject = ThingObject.from_dict(e)
         return thing
 
+    async def entities(self, uris: List[str], locale: Optional[LocaleCode] = None, auth_key: Optional[str] = None) \
+            -> List[ThingObject]:
+        """
+        Retrieve entities information from personal knowledge, using the  URI as identifier.
+
+        **Remark:** Object properties (relations) must be requested separately.
+
+        Parameters
+        ----------
+        uris: List[str]
+            List of URIs of the entities
+        locale: LocaleCode
+            ISO-3166 Country Codes and ISO-639 Language Codes in the format <language_code>_<country>, e.g., en_US.
+        auth_key: Optional[str]
+            Use a different auth key than the one from the client
+
+        Returns
+        -------
+        things: List[ThingObject]
+            Entities with is type URI, description, an image/icon, and tags (labels).
+
+        Raises
+        ------
+        WacomServiceException
+            If the graph service returns an error code or the entity is not found in the knowledge graph
+        """
+        if auth_key is None:
+            auth_key, _ = await self.handle_token()
+        url: str = f"{self.service_base_url}{AsyncWacomKnowledgeService.ENTITY_ENDPOINT}/"
+        headers: Dict[str, str] = {
+            USER_AGENT_HEADER_FLAG: self.user_agent,
+            AUTHORIZATION_HEADER_FLAG: f"Bearer {auth_key}",
+        }
+        things: List[ThingObject] = []
+        params: Dict[str, Any] = {
+            URIS_TAG: uris
+        }
+        if locale:
+            params[LOCALE_TAG] = locale
+        async with AsyncServiceAPIClient.__async_session__() as session:
+            async with session.get(url, headers=headers, params=params, verify_ssl=self.verify_calls) as response:
+                if response.ok:
+                    entities: List[Dict[str, Any]] = await response.json()
+                    for e in entities:
+                        thing: ThingObject = ThingObject.from_dict(e)
+                        things.append(thing)
+                else:
+                    raise await handle_error(
+                        f"Retrieving of entities content failed. List of URIs: {uris}.", response,
+                        headers=headers
+                    )
+        await asyncio.sleep(0.25 if self.use_graceful_shutdown else 0.0)
+        # Create ThingObject
+        return things
+
     async def set_entity_image_local(self, entity_uri: str, path: Path, auth_key: Optional[str] = None) -> str:
         """Setting the image of the entity.
         The image is stored locally.

knowledge/services/asyncio/search.py

@@ -213,7 +213,7 @@ class AsyncSemanticSearchClient(AsyncServiceAPIClient):
         """
         if auth_key is None:
             auth_key, _ = await self.handle_token()
-        url: str = f"{self.service_base_url}documents/count/filter"
+        url: str = f"{self.service_base_url}documents/count/filter/"
         headers: Dict[str, str] = {
             USER_AGENT_HEADER_FLAG: self.user_agent,
             CONTENT_TYPE_HEADER_FLAG: APPLICATION_JSON_HEADER,
@@ -307,7 +307,7 @@ class AsyncSemanticSearchClient(AsyncServiceAPIClient):
         """
         if auth_key is None:
             auth_key, _ = await self.handle_token()
-        url: str = f"{self.service_base_url}labels/count/filter"
+        url: str = f"{self.service_base_url}labels/count/filter/"
         headers: Dict[str, str] = {
             USER_AGENT_HEADER_FLAG: self.user_agent,
             CONTENT_TYPE_HEADER_FLAG: APPLICATION_JSON_HEADER,

knowledge/services/base.py

@@ -300,7 +300,8 @@ class WacomServiceAPIClient(RESTAPIClient):
             raise WacomServiceException(f"Unknown session id:= {self.__current_session_id}. Please login first.")
         return session
 
-    def request_user_token(self, tenant_api_key: str, external_id: str) -> Tuple[str, str, datetime]:
+    def request_user_token(self, tenant_api_key: str, external_id: str, timeout: int = DEFAULT_TIMEOUT) \
+            -> Tuple[str, str, datetime]:
         """
         Login as user by using the tenant key and its external user id.
 
@@ -310,6 +311,8 @@ class WacomServiceAPIClient(RESTAPIClient):
             Tenant API key
         external_id: str
             External id.
+        timeout: int (Default:= DEFAULT_TIMEOUT)
+            Timeout for the request in seconds.
 
         Returns
         -------
@@ -333,7 +336,8 @@ class WacomServiceAPIClient(RESTAPIClient):
         }
         payload: dict = {EXTERNAL_USER_ID: external_id}
         response: Response = requests.post(
-            url, headers=headers, json=payload, timeout=DEFAULT_TIMEOUT, verify=self.verify_calls
+            url, headers=headers, json=payload, timeout=timeout, verify=self.verify_calls,
+            allow_redirects=True
         )
         if response.ok:
             try:

knowledge/services/graph.py

@@ -18,7 +18,6 @@ from knowledge.base.entity import (
     DATA_PROPERTIES_TAG,
     TYPE_TAG,
     LABELS_TAG,
-    IS_MAIN_TAG,
     RELATIONS_TAG,
     LOCALE_TAG,
     EntityStatus,
@@ -226,18 +225,74 @@ class WacomKnowledgeService(WacomServiceAPIClient):
             response: Response = session.get(url, headers=headers, timeout=timeout, verify=self.verify_calls)
             if response.ok:
                 e: Dict[str, Any] = response.json()
-                pref_label: List[Label] = []
-                aliases: List[Label] = []
-                # Extract labels and alias
-                for label in e[LABELS_TAG]:
-                    if label[IS_MAIN_TAG]:  # Labels
-                        pref_label.append(Label.create_from_dict(label))
-                    else:  # Alias
-                        aliases.append(Label.create_from_dict(label))
                 thing: ThingObject = ThingObject.from_dict(e)
                 return thing
             raise handle_error(f"Retrieving of entity content failed. URI:={uri}.", response)
 
+    def entities(self,
+        uris: List[str],
+        locale: Optional[LocaleCode] = None,
+        auth_key: Optional[str] = None,
+        timeout: int = DEFAULT_TIMEOUT,
+        max_retries: int = DEFAULT_MAX_RETRIES,
+        backoff_factor: float = DEFAULT_BACKOFF_FACTOR,
+    ) -> List[ThingObject]:
+        """
+        Retrieve entity information from personal knowledge, using the  URI as identifier.
+
+        **Remark:** Object properties (relations) must be requested separately.
+
+        Parameters
+        ----------
+        uris: List[str]
+            List of URIs of entities
+        locale: Optional[LocaleCode]
+            ISO-3166 Country Codes and ISO-639 Language Codes in the format <language_code>_<country>, e.g., en_US.
+        auth_key: Optional[str]
+            If the auth key is set the logged-in user (if any) will be ignored and the auth key will be used.
+        timeout: int
+            Timeout for the request (default: 60 seconds)
+        max_retries: int
+            Maximum number of retries (default: 3)
+        backoff_factor: float
+            A backoff factor to apply between attempts after the second try (most errors are resolved immediately by a
+            second try without a delay) (default: 0.1)
+
+        Returns
+        -------
+        things: List[ThingObject]
+            Entities with is type URI, description, an image/icon, and tags (labels).
+
+        Raises
+        ------
+        WacomServiceException
+            If the graph service returns an error code or the entity is not found in the knowledge graph
+        """
+        if auth_key is None:
+            auth_key, _ = self.handle_token()
+        url: str = f"{self.service_base_url}{WacomKnowledgeService.ENTITY_ENDPOINT}/"
+        headers: Dict[str, str] = {
+            USER_AGENT_HEADER_FLAG: self.user_agent,
+            AUTHORIZATION_HEADER_FLAG: f"Bearer {auth_key}",
+        }
+        params: Dict[str, Any] = {URIS_TAG: uris}
+        if locale is not None:
+            params[LOCALE_TAG] = locale
+        mount_point: str = "https://" if self.service_url.startswith("https") else "http://"
+        with requests.Session() as session:
+            retries: Retry = Retry(total=max_retries, backoff_factor=backoff_factor, status_forcelist=STATUS_FORCE_LIST)
+            session.mount(mount_point, HTTPAdapter(max_retries=retries))
+            response: Response = session.get(url, params=params, headers=headers, timeout=timeout,
+                                             verify=self.verify_calls)
+            if response.ok:
+                things: List[ThingObject] = []
+                entities: List[Dict[str, Any]] = response.json()
+                for e in entities:
+                    thing: ThingObject = ThingObject.from_dict(e)
+                    things.append(thing)
+                return things
+            raise handle_error(f"Retrieving of entity content failed. URIs:={uris}.", response)
+
     def delete_entities(
         self,
         uris: List[str],
@@ -2017,7 +2072,7 @@ class WacomKnowledgeService(WacomServiceAPIClient):
 
     def rebuild_nel_index(
         self,
-        nel_index: Literal["western", "japanese"],
+        nel_index: Literal["Western", "Japanese"],
         prune: bool = False,
         auth_key: Optional[str] = None,
         timeout: int = DEFAULT_TIMEOUT,

knowledge/services/ontology.py

@@ -9,6 +9,7 @@ from requests import Response
 from requests.adapters import HTTPAdapter
 from urllib3 import Retry
 
+from knowledge.base.entity import FORCE_TAG
 from knowledge.base.ontology import (
     OntologyClassReference,
     OntologyPropertyReference,
@@ -1140,6 +1141,7 @@ class OntologyService(WacomServiceAPIClient):
     def commit(
         self,
         context: str,
+        force: bool = False,
         auth_key: Optional[str] = None,
         timeout: int = DEFAULT_TIMEOUT,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -1152,6 +1154,8 @@ class OntologyService(WacomServiceAPIClient):
         ----------
         context: str
             Name of the context.
+        force: bool (default:= False)
+            Force commit of the ontology.
         auth_key: Optional[str] [default:= None]
             If the auth key is set the logged-in user (if any) will be ignored and the auth key will be used.
         timeout: int
@@ -1170,11 +1174,13 @@ class OntologyService(WacomServiceAPIClient):
         }
         context_url: str = urllib.parse.quote_plus(context)
         url: str = f"{self.service_base_url}context/{context_url}/commit"
+        params: Dict[str, bool] = {FORCE_TAG: force}
         mount_point: str = "https://" if self.service_url.startswith("https") else "http://"
         with requests.Session() as session:
             retries: Retry = Retry(total=max_retries, backoff_factor=backoff_factor, status_forcelist=STATUS_FORCE_LIST)
             session.mount(mount_point, HTTPAdapter(max_retries=retries))
-            response: Response = session.put(url, headers=headers, verify=self.verify_calls, timeout=timeout)
+            response: Response = session.put(url, params=params, headers=headers, verify=self.verify_calls,
+                                             timeout=timeout)
             if not response.ok:
                 raise handle_error("Commit of ontology failed.", response, headers=headers)
 

knowledge/services/search.py

@@ -241,7 +241,7 @@ class SemanticSearchClient(WacomServiceAPIClient):
         """
         if auth_key is None:
             auth_key, _ = self.handle_token()
-        url: str = f"{self.service_base_url}documents/count/filter"
+        url: str = f"{self.service_base_url}documents/count/filter/"
         headers: Dict[str, str] = {
             USER_AGENT_HEADER_FLAG: self.user_agent,
             CONTENT_TYPE_HEADER_FLAG: APPLICATION_JSON_HEADER,
@@ -263,6 +263,7 @@ class SemanticSearchClient(WacomServiceAPIClient):
         locale: LocaleCode,
         concept_type: Optional[str] = None,
         auth_key: Optional[str] = None,
+        timeout: float = DEFAULT_TIMEOUT,
         max_retries: int = 3,
         backoff_factor: float = 0.1,
     ) -> int:
@@ -275,6 +276,8 @@ class SemanticSearchClient(WacomServiceAPIClient):
             ISO-3166 Country Codes and ISO-639 Language Codes in the format '<language_code>_<country>', e.g., en_US.
         concept_type: Optional[str] (Default:= None)
             Concept type.
+        timeout: int (Default:= DEFAULT_TIMEOUT)
+            Timeout for the request in seconds.
         max_retries: int
             Maximum number of retries
         backoff_factor: float
@@ -306,7 +309,7 @@ class SemanticSearchClient(WacomServiceAPIClient):
         with requests.Session() as session:
             retries: Retry = Retry(total=max_retries, backoff_factor=backoff_factor, status_forcelist=STATUS_FORCE_LIST)
             session.mount(mount_point, HTTPAdapter(max_retries=retries))
-            response = session.get(url, params=params, headers=headers)
+            response = session.get(url, params=params, headers=headers, timeout=timeout)
             if response.ok:
                 return response.json().get("count", 0)
             raise handle_error("Counting labels failed.", response, headers=headers, parameters={"locale": locale})
@@ -347,7 +350,7 @@ class SemanticSearchClient(WacomServiceAPIClient):
         """
         if auth_key is None:
             auth_key, _ = self.handle_token()
-        url: str = f"{self.service_base_url}labels/count/filter"
+        url: str = f"{self.service_base_url}labels/count/filter/"
         headers: Dict[str, str] = {
             USER_AGENT_HEADER_FLAG: self.user_agent,
             CONTENT_TYPE_HEADER_FLAG: APPLICATION_JSON_HEADER,

{personal_knowledge_library-3.2.0.dist-info → personal_knowledge_library-3.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: personal_knowledge_library
-Version: 3.2.0
+Version: 3.2.2
 Summary: Library to access Wacom's Personal Knowledge graph.
 License: Apache-2.0
 Keywords: semantic-knowledge,knowledge-graph

{personal_knowledge_library-3.2.0.dist-info → personal_knowledge_library-3.2.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-knowledge/__init__.py,sha256=xx1SZgmFpjbHD3ZgpA9Bdbh5YaadA-vu2Y6MPsu6rvY,2680
+knowledge/__init__.py,sha256=Xl8GZrILXBXgRRuaZ8VHRIBptdEs6Koa4IeL4c-lxj0,2680
 knowledge/base/__init__.py,sha256=rgAcl0azO6eoVk1gK9z0UFNlTHj3AN88k6LG-GdATFk,1079
 knowledge/base/access.py,sha256=BSh-6QbeHOCu55XTxA-p3DwEyRzgtN8TSxtcn6UvmZo,4411
 knowledge/base/entity.py,sha256=b-Ana_H_WI2-AT_n-V_HzUL6W9Ri16DcZFS3q4ziI94,8445
@@ -21,16 +21,16 @@ knowledge/public/wikidata.py,sha256=LwMP2kq2mH5Oi9JhPvG8lN9pZMDlQvxgaZgQKQO3kaM,
 knowledge/services/__init__.py,sha256=Pg4Pd9cCRiQ4-v3E0WCqldOhJFcMmkZrQHA7BY1Z1K8,3604
 knowledge/services/asyncio/__init__.py,sha256=dq9yGTxg_hoQb8E1kEtY4AeB8zrdJfw3-XlPoYn2j5U,225
 knowledge/services/asyncio/base.py,sha256=im6J1CWOp1N1tt6WdJ1uU0R-VFpvdYc6lZu8TyPrU5A,16222
-knowledge/services/asyncio/graph.py,sha256=BRU8kLgKt7KNuyzlgT2PEVwa7ig-S-sR0AWMTYkp5NE,62401
+knowledge/services/asyncio/graph.py,sha256=MXcAf1XnQ2b36eUMAL8m731f_GMgOtBNmDtAKqurzjE,64719
 knowledge/services/asyncio/group.py,sha256=UKbk8vnPqqAkuc5gAd6g3IVOKmUJNqG2lreZM0O-hRg,18356
-knowledge/services/asyncio/search.py,sha256=_ESVbNGLYbo7EmyMLtsh0pRiRHIyGeBicrcD2JKbFwY,16215
+knowledge/services/asyncio/search.py,sha256=fm1j6fJDQx831B82bqmZ3czYrYH3qtPCYlisSF26M5g,16217
 knowledge/services/asyncio/users.py,sha256=NJ7xagjr4gF6yKJXdwa0bz0eaYlQDee5RCEpfQJEHWk,10274
-knowledge/services/base.py,sha256=gXBIkbk7wXGrm_hZGfLvft7-E8fcSMjl-HIsLxfRZ6c,17849
-knowledge/services/graph.py,sha256=XhbB2-3CUkQ9-NdVoW9pcQfnItaX6H07WVTsK3ynZ5I,86888
+knowledge/services/base.py,sha256=PdHfObShUBpbAS71LBhe5jOA13Y1JXbUkhRi9op8wis,18018
+knowledge/services/graph.py,sha256=d5TLQOH7DiVcjQKaR8ZGHOGePcOhlRQnEDmIqlqkojI,89392
 knowledge/services/group.py,sha256=b8dBBrHXqgwpJ7BtUqqweoR_WQH5MZ0aLh0fBBTyHUI,30698
 knowledge/services/helper.py,sha256=NYhRkYXtiFgovsXaQr6rBVN2mjBwOT7cSSuLTyjvzKA,4990
-knowledge/services/ontology.py,sha256=u89S3GV0C2FWAviQxd5fvoCQWzo8EhYix7fQc1bEEc0,51534
-knowledge/services/search.py,sha256=-qB9J1pyqoq3RlH7iDlgozBImKFzTx1p1kC0XKWAPEs,19147
+knowledge/services/ontology.py,sha256=1QewHZoNTNrQe9cAgLMvWRPQ2YYn4IltscEOV9Dy2qM,51800
+knowledge/services/search.py,sha256=9I4ZdCFnVSCCmYHeQralrw47VwKnMqA08UpAq_BMxQs,19305
 knowledge/services/session.py,sha256=y8uTETRMDOBbC30UAlrrtWTN7Zgs2klqHsoMjLO2tq0,14145
 knowledge/services/tenant.py,sha256=rQsUe8qNFTt_WZG4XBTg8QSLoyavuCWLWk3QhU1fBG8,11728
 knowledge/services/users.py,sha256=nOwyZhqERTNFPTN21c_q7-6XaEMb3SnHfnXr4Kf22qk,16594
@@ -40,7 +40,7 @@ knowledge/utils/graph.py,sha256=kuPZEGhexVN9McoT8JK2ViIrfXTh-nFPv_8XPfG0wlA,1231
 knowledge/utils/import_format.py,sha256=fjuWpd91eAs7MbqSpLrFgdRvFaHK0nzV1L83ByjTmV0,5277
 knowledge/utils/wikidata.py,sha256=vRH-4AMR-3xywyvmDqbjI4KSw4tF4TEYqUGCJmUMqK8,5512
 knowledge/utils/wikipedia.py,sha256=rBuFqYVM58JCj5ISLxuhYVVl2gOIlPLWx7_CghyQgvE,5052
-personal_knowledge_library-3.2.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-personal_knowledge_library-3.2.0.dist-info/METADATA,sha256=4RhzFCxjAyhFmnRavgdpwY5x-9PWs9p08tEqd9j1f6U,57087
-personal_knowledge_library-3.2.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-personal_knowledge_library-3.2.0.dist-info/RECORD,,
+personal_knowledge_library-3.2.2.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+personal_knowledge_library-3.2.2.dist-info/METADATA,sha256=KBcGxJbB9Wqbt9snudWw3modgrNlirPNrF96kVOlbnA,57087
+personal_knowledge_library-3.2.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+personal_knowledge_library-3.2.2.dist-info/RECORD,,