hana-cloud-interface 0.1.5__py3-none-any.whl → 0.1.7__py3-none-any.whl

hana_cloud_interface/__init__.py

@@ -1 +1 @@
-from .main import hana_sql, config_file, data_frame_type, Browser_override
+from .main import hana_sql, initialize_settings

hana_cloud_interface/main.py

@@ -13,11 +13,29 @@ import polars as pl
 import pandas as pd
 import os
 
-config_file = ''
-Browser_override = ''
-data_frame_type = 'pandas' # Default data frame type for hana_sql function
+config_file_g = ''
+Browser_override_g = ''
+data_frame_type_g = 'pandas' # Default data frame type for hana_sql function
 debug = False
 
+def initialize_settings(config_file = '', Browser_override = '', data_frame_type = 'pandas'):
+    """
+    Initializes global settings for the Hana Cloud interface.
+
+    Parameters:
+    config_file (str): Path to the configuration file.
+    Browser_override (str): Optional browser override for OAuth authentication.
+    data_frame_type (str): Default data frame type for SQL query results ('pandas' or 'polars').
+
+    Sets global variables for configuration file path, browser override, and data frame type.
+    """
+    global config_file_g, Browser_override_g, data_frame_type_g
+    config_file_g = config_file
+    Browser_override_g = Browser_override
+    data_frame_type_g = data_frame_type
+    
+    
+    
 def test_connection(oauth_config):
     oauth_Token = keyring.get_password('SAP_hana_sso', 'oauth_Token')
     
@@ -159,8 +177,8 @@ def get_token(i=0):
         authorization_url = f"{oauth_config['AUTH_URL']}?{urllib.parse.urlencode(params)}"
 
         # Open web browser and go to oauth url
-        if Browser_override != '':
-            webbrowser.get(Browser_override).open(authorization_url,new=1)
+        if Browser_override_g != '':
+            webbrowser.get(Browser_override_g).open(authorization_url,new=1)
         else:
             webbrowser.open(authorization_url,new=1)
             
@@ -188,9 +206,9 @@ def config_reader():
     # reads config data from keychain
     config_data = keyring.get_password('SAP_hana_sso', 'config_data')
     if not config_data: # If there is no existing config data saved to the credentials manager read from file and save it
-        if not os.path.exists(config_file):
-            raise FileNotFoundError(f"Config file not found: {config_file}")
-        with open(config_file) as file:
+        if not os.path.exists(config_file_g):
+            raise FileNotFoundError(f"Config file not found: {config_file_g}")
+        with open(config_file_g) as file:
             config_data = json.load(file)
         keyring.set_password('SAP_hana_sso', 'config_data', json.dumps(config_data))
         return config_data
@@ -200,7 +218,7 @@ def config_reader():
 
 
 
-def hana_sql(sql_command='test',DF_type = data_frame_type):
+def hana_sql(sql_command='test',DF_type = data_frame_type_g):
     """ handles single sign on then runs a SQL command
 
     Parameters:

{hana_cloud_interface-0.1.5.dist-info → hana_cloud_interface-0.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hana-cloud-interface
-Version: 0.1.5
+Version: 0.1.7
 Summary: Runs a SQL command on SAP HANA Cloud using OAuth single sign on and returns a pandas or polars dataframe
 Author: charlotte corpe
 Author-email: charlotte corpe <charlotte.corpe@powerco.co.nz>
@@ -32,11 +32,17 @@ data = hci.hana_sql(sql_command)
 
 ```
 
-## Configuration file
-You need specify the location of your configuration file by setting the `config_file` attribute of the `hci` module. For example:
+## initialising settings
+Before using the package, you need to initialize the settings by specifying the configuration file location, browser override (if needed), and the default data frame type for SQL query results.
+
+config_file : Path to the configuration file (JSON format) containing OAuth credentials and other settings.
+
+Browser_override : Optional parameter to specify a browser for OAuth authentication. If left empty, the default browser will be used. this needs to be the path to the executable for the browser
+
+data_frame_type : Default data frame type for SQL query results. Options are 'pandas' or 'polars'. Default is 'pandas'.
 
 ```python
-hci.config_file = 'location of configuration file'
+hci.initialize_settings(config_file = 'location of configuration file', Browser_override = '', data_frame_type = 'pandas')
 ```
 the configuration file is a .json file
 ```python

hana_cloud_interface-0.1.7.dist-info/RECORD

@@ -0,0 +1,6 @@
+hana_cloud_interface/__init__.py,sha256=906f9595b4c5204bd8fa8ee1339d5a60da87904eb00bafaec724ab8c9f0e7305,47
+hana_cloud_interface/main.py,sha256=72c5ca2bc15ef8da55d8a8dcd3500cd2a8dbb8e744bb3999962e141dcd002580,9650
+hana_cloud_interface/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
+hana_cloud_interface-0.1.7.dist-info/WHEEL,sha256=b70116f4076fa664af162441d2ba3754dbb4ec63e09d563bdc1e9ab023cce400,78
+hana_cloud_interface-0.1.7.dist-info/METADATA,sha256=4ddd10b178a90250786537b3be366069dfb0d392fff63b2102024aec853b6f4b,1943
+hana_cloud_interface-0.1.7.dist-info/RECORD,,

hana_cloud_interface-0.1.5.dist-info/RECORD

@@ -1,6 +0,0 @@
-hana_cloud_interface/__init__.py,sha256=afee63541644ae210da90e08e3cee1af035edaa6905ff49ee2ac2aca921e6897,74
-hana_cloud_interface/main.py,sha256=7efa064a184742ddf9255ec8de4ff326deec495aa4af7fd297d662cfc8091cf1,8923
-hana_cloud_interface/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
-hana_cloud_interface-0.1.5.dist-info/WHEEL,sha256=b70116f4076fa664af162441d2ba3754dbb4ec63e09d563bdc1e9ab023cce400,78
-hana_cloud_interface-0.1.5.dist-info/METADATA,sha256=1b2342c771e8c91f30a03ecff86a9a3fe29450bd7363089803ea9b5764ac6900,1373
-hana_cloud_interface-0.1.5.dist-info/RECORD,,