qe-api-client 2.2.0__tar.gz → 2.3.0__tar.gz

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qe-api-client
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python wrapper around Qlik Engine JSON API
 Home-page: https://github.com/lr-bicc/qe-api-client
 Author: Rumen Vasilev
@@ -28,7 +28,7 @@ Forked from [jhettler/pyqlikengine](https://github.com/jhettler/pyqlikengine)
 pip install qe-api-client
 ```
 
-## Example of usage on Qlik Sense Enterprise Server
+## Connecting to Qlik Sense Enterprise Server
 You need to export the Qlik Sense certificates in PEM format from the Qlik Sense Enterprise server to a local folder in 
 order to authenticate on the server.
 
@@ -48,7 +48,7 @@ qixe = QixEngine(url=url, user_directory=user_directory, user_id=user_id, ca_cer
 print(qixe.ega.get_doc_list())
 ```
 
-## Example of usage on Qlik Sense Desktop
+## Connecting to Qlik Sense Desktop
 You need to start your Qlik Sense Desktop client on your local PC.
 
 ```python
@@ -61,5 +61,8 @@ qixe = QixEngine(url=url)
 print(qixe.ega.get_doc_list())
 ```
 
+## Examples of usage
+Please click on this [link](https://github.com/lr-bicc/qe-api-client/tree/master/examples) to find examples of usage of this client.
+
 ## API reference
 Please click on this [link](https://lr-bicc.github.io/qe-api-client) for full API reference documentation .

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/README.md

@@ -13,7 +13,7 @@ Forked from [jhettler/pyqlikengine](https://github.com/jhettler/pyqlikengine)
 pip install qe-api-client
 ```
 
-## Example of usage on Qlik Sense Enterprise Server
+## Connecting to Qlik Sense Enterprise Server
 You need to export the Qlik Sense certificates in PEM format from the Qlik Sense Enterprise server to a local folder in 
 order to authenticate on the server.
 
@@ -33,7 +33,7 @@ qixe = QixEngine(url=url, user_directory=user_directory, user_id=user_id, ca_cer
 print(qixe.ega.get_doc_list())
 ```
 
-## Example of usage on Qlik Sense Desktop
+## Connecting to Qlik Sense Desktop
 You need to start your Qlik Sense Desktop client on your local PC.
 
 ```python
@@ -46,5 +46,8 @@ qixe = QixEngine(url=url)
 print(qixe.ega.get_doc_list())
 ```
 
+## Examples of usage
+Please click on this [link](https://github.com/lr-bicc/qe-api-client/tree/master/examples) to find examples of usage of this client.
+
 ## API reference
 Please click on this [link](https://lr-bicc.github.io/qe-api-client) for full API reference documentation .

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/qe_api_client/api_classes/engine_app_api.py

@@ -79,7 +79,7 @@ class EngineAppApi:
         except KeyError:
             return response['error']
 
-    def do_reload_ex(self, doc_handle, param_list=[]):
+    def do_reload_ex(self, doc_handle, param_list={}):
         """
         Triggers an extended reload of the app identified by the document handle.
 
@@ -91,10 +91,10 @@ class EngineAppApi:
             dict: The result of the extended reload operation. In case of an error, returns the error information.
         """
         msg = json.dumps({"jsonrpc": "2.0", "id": 0, "handle": doc_handle, "method": "DoReloadEx",
-                          "params": param_list})
+                          "params": {"qParams": param_list}})
         response = json.loads(self.engine_socket.send_call(self.engine_socket, msg))
         try:
-            return response['result']
+            return response["result"]["qResult"]
         except KeyError:
             return response['error']
 
@@ -435,8 +435,9 @@ class EngineAppApi:
 
     # DoSave method: Saves an app - All objects and data in the data model are saved.  # NOQA
     # Desktop only - server auto saves
-    def do_save(self, doc_handle):
-        msg = json.dumps({"jsonrpc": "2.0", "id": 0, "handle": doc_handle, "method": "DoSave", "params": []})
+    def do_save(self, doc_handle, file_name=""):
+        msg = json.dumps({"jsonrpc": "2.0", "id": 0, "handle": doc_handle, "method": "DoSave",
+                          "params": {"qFileName": file_name}})
         response = json.loads(self.engine_socket.send_call(self.engine_socket, msg))
         try:
             return response['result']
@@ -666,7 +667,17 @@ class EngineAppApi:
 
     # GetAllInfos method: Get the identifier and the type of any generic object in an app by using the GetAllInfos method.  # NOQA
     def get_lineage(self, doc_handle):
-        msg = json.dumps({"jsonrpc": "2.0", "id": 0, "handle": doc_handle, "method": "GetLineage", "params": []})
+        """
+        Gets the lineage information of the app. The lineage information includes the LOAD and STORE statements from
+        the data load script associated with this app.
+
+        Parameters:
+            doc_handle (int): The handle identifying the app document.
+
+        Returns:
+            list: Information about the lineage of the data in the app.
+        """
+        msg = json.dumps({"jsonrpc": "2.0", "id": 0, "handle": doc_handle, "method": "GetLineage", "params": {}})
         response = json.loads(self.engine_socket.send_call(self.engine_socket, msg))
         try:
             return response['result']['qLineage']

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/qe_api_client/engine.py

@@ -90,12 +90,62 @@ class QixEngine:
         return self.efa.clear(fld_handle)
 
     def create_single_master_dimension(self, app_handle, dim_title, dim_def, dim_label):
+        """
+        Creates a single master dimension.
+
+        Parameters:
+            app_handle (int): The handle of the app.
+            dim_title (str): The title of the dimension.
+            dim_def (str): The definition of the dimension.
+            dim_label (str): The label of the dimension.
+
+        Returns:
+            dict: The handle and Id of the dimension.
+        """
         nx_info = self.structs.nx_info("dimension")
         lb_dim_def = self.structs.nx_library_dimension_def("N",[dim_def],[""],dim_label)
         gen_dim_props = self.structs.generic_dimension_properties(nx_info, lb_dim_def, dim_title)
         master_dim = self.eaa.create_dimension(app_handle, gen_dim_props)
         return master_dim
 
+    def create_master_measure(self, app_handle, mes_title, mes_def, mes_label):
+        """
+        Creates a master measure.
+
+        Parameters:
+            app_handle (int): The handle of the app.
+            mes_title (str): The title of the measure.
+            mes_def (str): The definition of the measure.
+            mes_label (str): The label of the measure.
+
+        Returns:
+            dict: The handle and Id of the measure.
+        """
+        nx_info = self.structs.nx_info("measure")
+        lb_mes_def = self.structs.nx_inline_measure_def(mes_def,mes_label)
+        gen_mes_props = self.structs.generic_measure_properties(nx_info, lb_mes_def, mes_title)
+        master_mes = self.eaa.create_measure(app_handle, gen_mes_props)
+        return master_mes
+
+    def get_app_lineage_info(self, app_handle):
+        """
+        Gets the lineage information of the app. The lineage information includes the LOAD and STORE statements from
+        the data load script associated with this app.
+
+        Parameters:
+            app_handle (int): The handle of the app.
+
+        Returns:
+        DataFrame: Information about the lineage of the data in the app.
+        """
+        # Lineage-Daten aus der API holen
+        lineage_info = self.eaa.get_lineage(app_handle)
+
+        # Erstelle den DataFrame und fülle fehlende Werte mit ""
+        df_lineage_info = pd.DataFrame(lineage_info)
+        df_lineage_info = df_lineage_info[(df_lineage_info["qDiscriminator"].notna()) | (df_lineage_info["qStatement"].notna())].fillna("")
+        return df_lineage_info
+
     def disconnect(self):
         self.conn.close_qvengine_connection(self.conn)
 

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/qe_api_client/structs.py

@@ -66,4 +66,8 @@ def num_format(type="U", n_dec=10, use_thou=0, fmt="", dec="", thou=""):
     return {"qType": type, "qnDec": n_dec, "qUseThou": use_thou, "qFmt": fmt, "qDec": dec, "qThou": thou}
 
 def generic_measure_properties(info, lb_meas_def, meas_title):
-    return {"qInfo": info, "qMeasure": lb_meas_def, "qMetaDef": {"title": meas_title}}
+    return {"qInfo": info, "qMeasure": lb_meas_def, "qMetaDef": {"title": meas_title}}
+
+def do_reload_ex_params(mode=0, partial=False, debug=False, reload_id="", skip_store=False, row_limit=0):
+    return {"qMode": mode, "qPartial": partial, "qDebug": debug, "qReloadId": reload_id, "qSkipStore": skip_store,
+            "qRowLimit": row_limit}

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/qe_api_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qe-api-client
-Version: 2.2.0
+Version: 2.3.0
 Summary: Python wrapper around Qlik Engine JSON API
 Home-page: https://github.com/lr-bicc/qe-api-client
 Author: Rumen Vasilev
@@ -28,7 +28,7 @@ Forked from [jhettler/pyqlikengine](https://github.com/jhettler/pyqlikengine)
 pip install qe-api-client
 ```
 
-## Example of usage on Qlik Sense Enterprise Server
+## Connecting to Qlik Sense Enterprise Server
 You need to export the Qlik Sense certificates in PEM format from the Qlik Sense Enterprise server to a local folder in 
 order to authenticate on the server.
 
@@ -48,7 +48,7 @@ qixe = QixEngine(url=url, user_directory=user_directory, user_id=user_id, ca_cer
 print(qixe.ega.get_doc_list())
 ```
 
-## Example of usage on Qlik Sense Desktop
+## Connecting to Qlik Sense Desktop
 You need to start your Qlik Sense Desktop client on your local PC.
 
 ```python
@@ -61,5 +61,8 @@ qixe = QixEngine(url=url)
 print(qixe.ega.get_doc_list())
 ```
 
+## Examples of usage
+Please click on this [link](https://github.com/lr-bicc/qe-api-client/tree/master/examples) to find examples of usage of this client.
+
 ## API reference
 Please click on this [link](https://lr-bicc.github.io/qe-api-client) for full API reference documentation .

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/qe_api_client.egg-info/SOURCES.txt

@@ -4,7 +4,6 @@ setup.py
 qe_api_client/__init__.py
 qe_api_client/engine.py
 qe_api_client/engine_communicator.py
-qe_api_client/engine_helper.py
 qe_api_client/structs.py
 qe_api_client.egg-info/PKG-INFO
 qe_api_client.egg-info/SOURCES.txt

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setuptools.setup(
     name="qe-api-client",
-    version="2.2.0",
+    version="2.3.0",
     author="Rumen Vasilev",
     author_email="R.Vasilev@LRWorld.com",
     description="Python wrapper around Qlik Engine JSON API",

{qe_api_client-2.2.0 → qe_api_client-2.3.0}/test/test_field_api.py

@@ -1,14 +1,6 @@
 import unittest
-
-from qe_api_client.api_classes.engine_app_api import EngineAppApi
-from qe_api_client.engine_communicator import EngineCommunicator
-from qe_api_client.api_classes.engine_field_api import EngineFieldApi
-from qe_api_client.api_classes.engine_global_api import EngineGlobalApi
-import qe_api_client.structs as structs
 from qe_api_client.engine import QixEngine
 
-from qe_api_client.api_classes.engine_generic_object_api import EngineGenericObjectApi
-
 
 class TestFieldApi(unittest.TestCase):
 
@@ -24,14 +16,14 @@ class TestFieldApi(unittest.TestCase):
         self.qixe.eaa.do_reload_ex(self.app_handle)
 
         nx_inline_dimension_def = self.qixe.structs.nx_inline_dimension_def(["Alpha"])
-        nx_page_initial = structs.nx_page(0, 0, 1, 26)
-        lb_def = structs.list_object_def("$", "", nx_inline_dimension_def,[nx_page_initial])
+        nx_page_initial = self.qixe.structs.nx_page(0, 0, 1, 26)
+        lb_def = self.qixe.structs.list_object_def("$", "", nx_inline_dimension_def,[nx_page_initial])
 
         # Create info structure
-        nx_info = structs.nx_info("ListObject", "SLB01")
+        nx_info = self.qixe.structs.nx_info("ListObject", "SLB01")
 
         # Create generic object properties structure
-        gen_obj_props = structs.generic_object_properties(nx_info, "qListObjectDef", lb_def)
+        gen_obj_props = self.qixe.structs.generic_object_properties(nx_info, "qListObjectDef", lb_def)
         listobj = self.qixe.eaa.create_session_object(self.app_handle, gen_obj_props)  # NOQA
 
         self.lb_handle = self.qixe.get_handle(listobj)

qe_api_client-2.2.0/qe_api_client/engine_helper.py

@@ -1,67 +0,0 @@
-import math
-
-from qe_api_client.api_classes.engine_app_api import EngineAppApi
-from qe_api_client.api_classes.engine_field_api import EngineFieldApi
-from qe_api_client.api_classes.engine_generic_object_api import EngineGenericObjectApi
-from qe_api_client.api_classes.engine_global_api import EngineGlobalApi
-import qe_api_client.structs as structs
-
-import pandas as pd
-
-
-def getDataFrame(connection, appHandle, measures, dimensions, selections={}):
-    engineGlobalApi = EngineGlobalApi(connection)
-    # Define Dimensions of hypercube
-    hc_inline_dim = structs.nx_inline_dimension_def(dimensions)
-
-    # Set sorting of Dimension by Measure
-    hc_mes_sort = structs.sort_criteria()
-
-    # Define Measure of hypercube
-    hc_inline_mes = structs.nx_inline_measure_def(measures)
-
-    # Build hypercube from above definition
-    hc_dim = structs.nx_dimension(hc_inline_dim)
-    hc_mes = structs.nx_measure("", hc_inline_mes, hc_mes_sort)
-
-    width = len(measures) + len(dimensions)
-    height = int(math.floor(10000 / width))
-    nx_page = structs.nx_page(0, 0, width, height)
-    hc_def = structs.hypercube_def("$", [hc_dim], [hc_mes], [nx_page])
-
-    engineAppApi = EngineAppApi(connection)
-    hc_response = engineAppApi.create_object(appHandle, "CH01", "Chart", "qHyperCubeDef", hc_def)  # NOQA
-    hc_handle = engineGlobalApi.get_handle(hc_response['qReturn'])
-
-    engineGenericObjectApi = EngineGenericObjectApi(connection)
-
-    engineFieldApi = EngineFieldApi(connection)
-
-    for field in selections.keys():
-        fieldHandle = engineGlobalApi.get_handle(engineAppApi.get_field(appHandle, field))  # NOQA
-        values = []
-        for selectedValue in selections[field]:
-            values.append({'qText': selectedValue})
-
-        engineFieldApi.select_values(fieldHandle, values)
-
-    i = 0
-    while i % height == 0:
-        nx_page = structs.nx_page(0, i, width, height)
-        hc_data = engineGenericObjectApi.get_hypercube_data(hc_handle, "/qHyperCubeDef", nx_page)  # NOQA
-        elems = hc_data["qDataPages"][0]['qMatrix']
-
-        df = pd.DataFrame()
-
-        for elem in elems:
-            j = 0
-            for dim in dimensions:
-                df.set_value(i, dim, elem[j]["qText"])
-                j += 1
-            for meas in measures:
-                df.set_value(i, meas, elem[j]["qNum"])
-                j += 1
-
-            i += 1
-
-    return df