dbobj3 0.3.0__tar.gz → 0.5.0__tar.gz

{dbobj3-0.3.0 → dbobj3-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: dbobj3
-Version: 0.3.0
+Version: 0.5.0
 Summary: High-level MySQL/MSSQL/Oracle access module
 Requires-Python: >=3.6
 Requires-Dist: pymysql

{dbobj3-0.3.0 → dbobj3-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dbobj3"
-version = "0.3.0"
+version = "0.5.0"
 description = "High-level MySQL/MSSQL/Oracle access module"
 readme = "README.md"
 requires-python = ">=3.6"
@@ -16,7 +16,7 @@ dependencies = [
 packages = ["src/dbobj3.py"]
 
 [tool.bumpversion]
-current_version = "0.3.0"
+current_version = "0.5.0"
 commit = true
 tag = true
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)"

{dbobj3-0.3.0 → dbobj3-0.5.0}/src/dbobj3.py

@@ -21,12 +21,13 @@ Example:
 		rsServices.next()
 
 """
-__version__ = "0.3.0"
+__version__ = "0.5.0"
 
 from sys import version as sys_version, exit
 pyversion = sys_version[0:sys_version.find(' ')]
 using_mysqlclient, using_pymysql = False, False
 
+lstLoadedDrivers = []
 try:
 	#raise ImportError
 	import MySQLdb
@@ -39,8 +40,9 @@ try:
 	# - For Python3.x use the fork MySQLdb
 	#   - pip install mysqlclient ( developed by pymysql devs )
 	using_mysqlclient = True
+	lstLoadedDrivers.append({"MySQLdb": "Loaded (MySQL)"})
 except ImportError:
-	pass
+	lstLoadedDrivers.append({"MySQLdb": "Not Loaded (MySQL)"})
 
 if not using_mysqlclient:
 	try:
@@ -55,40 +57,56 @@ if not using_mysqlclient:
 		#import pymysql.cursors
 		#import pymysql.converters
 		using_pymysql = True
+		lstLoadedDrivers.append({"pymysql": "Loaded (MySQL)"})
 	except ImportError:
 		#print('Python {0}: could neither import pymysql nor MySQLdb'.format(pyversion))
-		pass
+		lstLoadedDrivers.append({"pymysql": "Not Loaded (MySQL)"})
 #'''
 
 try:
 	import pymssql
+	lstLoadedDrivers.append({"pymssql": "Loaded (Microsoft SQL Server)"})
 except ImportError:
 	#print('could not import pymssql')
-	pass
+	lstLoadedDrivers.append({"pymssql": "Not Loaded (Microsoft SQL Server)"})
 
 try:
 	import cx_Oracle
+	lstLoadedDrivers.append({"cx_Oracle": "Loaded (Oracle)"})
 except ImportError:
 	#print('could not import cx_Oracle')
-	pass
+	lstLoadedDrivers.append({"cx_Oracle": "Not Loaded (Oracle)"})
 
 try:
 	import sqlite3
+	lstLoadedDrivers.append({"sqlite3": "Loaded (Sqlite3)"})
 except ImportError:
 	#print('could not import sqlite3')
-	pass
+	lstLoadedDrivers.append({"sqlite3": "Not Loaded (Sqlite3)"})
 
 try:
 	import pyodbc
+	lstLoadedDrivers.append({"pyodbc": "Loaded (ODBC)"})
 except ImportError:
 	#print('could not import pyodbc')
-	pass
+	lstLoadedDrivers.append({"pyodbc": "Not Loaded (ODBC)"})
+
+try:
+	import requests
+	lstLoadedDrivers.append({"requests": "Loaded (API)"})
+except ImportError:
+	#print('could not import pyodbc')
+	lstLoadedDrivers.append({"requests": "Not Loaded (API)"})
+
+try:
+	import json
+except ImportError:
+	print(str(ImportError))
 
 import os, getpass, time
 currUser = getpass.getuser()
 homeDir = '/root' if currUser == 'root' else '/home/{u}'.format(u=currUser)
 
-
 class dbConnMessage:
 	"""
 	The dbConnMessage is an object that is returned in response to a dbObjConnection.  It has two
@@ -100,7 +118,6 @@ class dbConnMessage:
 		self.success = False
 		self.message = ""
 
-
 class dbObjCursor:
 	"""
 	Database cursor object controls the cursor connected to a database.  Multiple cursors
@@ -118,7 +135,6 @@ class dbObjCursor:
 		self.dbType = prmDBType.upper()
 		self.create(self.dbType)
 
-
 	def __del__(self):
 		if(self.dbType == "MYSQL"):
 			try:
@@ -127,7 +143,6 @@ class dbObjCursor:
 			except:
 				pass
 
-
 	def create(self, prmDBType="MYSQL"):
 		if(prmDBType=="MYSQL"):
 			self.createMySql()
@@ -139,35 +154,33 @@ class dbObjCursor:
 			self.createSqlite3()
 		elif(prmDBType=="PROGRESS"):
 			self.createProgress()
-
+		elif(prmDBType=="API"):
+			self.createAPI()
 
 	def createMySql(self):
 		self.cursor = self.connection.cursor(MySQLdb.cursors.DictCursor)
 
-
 	def createMsSql(self):
 		self.cursor = self.connection.cursor(as_dict=True)
 
-
 	def createOracle(self):
 		self.cursor = self.connection.cursor()
 
-
 	def createSqlite3(self):
 		self.cursor = self.connection.cursor()
 
-
 	def createProgress(self):
 		self.cursor = self.connection.cursor()
 		#for ln in [ i for i in dir(self.cursor) if not i[0]=='_']:
 		#	print(ln)
 
+	def createAPI(self):
+		self.lstRecords = []
 
 	def moveNext(self):
 		"""Same as next"""
 		self.next()
 
-
 	def next(self):
 		"""Move to the next record in the record set and loads the data into the fields property.  Sets EOF at end of records."""
 		if(self.dbType == "MYSQL"):
@@ -180,7 +193,8 @@ class dbObjCursor:
 			self.sqlite3Next()
 		elif(self.dbType == "PROGRESS"):
 			self.progressNext()
-
+		elif(self.dbType == "API"):
+			self.apiNext()
 
 	def mySqlNext(self):
 		resultSet = self.cursor.fetchone()
@@ -193,7 +207,6 @@ class dbObjCursor:
 			self.fields = self.fieldByName
 			self.EOF = 1
 
-
 	def msSqlNext(self):
 		try:
 			resultSet = self.cursor.fetchone()
@@ -207,7 +220,6 @@ class dbObjCursor:
 		else:
 			self.EOF = 1
 
-
 	def oracleNext(self):
 		if(self.recordPointer <= self.numRows):
 			self.fieldByName = {}
@@ -223,7 +235,6 @@ class dbObjCursor:
 		else:
 			self.EOF = 1
 
-
 	def sqlite3Next(self):
 		if(self.recordPointer <= self.numRows):
 			self.fieldByName = {}
@@ -239,7 +250,6 @@ class dbObjCursor:
 		else:
 			self.EOF = 1
 
-
 	def progressNext(self):
 		if(self.recordPointer <= self.numRows):
 			self.fieldByName = {}
@@ -255,18 +265,25 @@ class dbObjCursor:
 		else:
 			self.EOF = 1
 
+	def apiNext(self):
+		if(self.recordPointer < self.numRows):
+			self.fieldNames = self.lstRecords[self.recordPointer].keys()
+			self.fieldByName = self.lstRecords[self.recordPointer]
+			self.fields = self.fieldByName
+			self.recordPointer += 1
+			self.EOF = 0
+		else:
+			self.EOF = 1
 
 	def first(self):
 		"""Move to the next record in the record set and loads the data into the fields property.  Sets EOF at end of records."""
 		if(self.dbType == "MYSQL"):
 			self.mySqlFirst()
 
-
 	def mySqlFirst(self):
 		resultSet = self.cursor.scroll(0,'absolute')
 		self.mySqlNext()
 
-
 	def oracleExecute(self, prmSql):
 		"""
 		Oracle had to be handled differently due to cursor.rowcount failing.  This method is called
@@ -280,7 +297,6 @@ class dbObjCursor:
 		if(self.numRows > 0):
 			self.recordPointer = 1
 
-
 	def sqlite3Execute(self, prmSql):
 		"""
 		Sqlite3Execute method is called transparently by dbObjConnection.execute and fetches all records at once where the other
@@ -293,7 +309,6 @@ class dbObjCursor:
 		if(self.numRows > 0):
 			self.recordPointer = 1
 
-
 	def progressExecute(self, prmSql):
 		"""
 		progressExecute method is called transparently by dbObjConnection.execute and fetches all records at once where the other
@@ -308,25 +323,27 @@ class dbObjCursor:
 			self.recordPointer = 1
 		#print('progressExecute (fetchs all) time.time()-t0: ',str(round(time.time()-t0,3)),' seconds')
 
-
-
 class dbObjConnection:
 	"""
 	dbObjConnection is the database connection object.  It is responsible for connecting to
 	the database.  This object supports access to MySQL, Microsoft SQL Server, Oracle,
 	SQLite3, and Progress DataDirect.
 	
-	prmDBType can be:  MYSQL, MSSQL, ORACLE, SQLITE3, or PROGRESS 
+	prmDBType can be:  MYSQL, MSSQL, ORACLE, SQLITE3, PROGRESS, or API
 	"""
 	def __init__(self, 
 				prmDBType="MYSQL", 
 				prmHost="localhost", 
 				prmDb="", 
 				prmUser="", 
-				prmPass="", prmPort=3306, 
+				prmPass="", 
+				prmPort=3306, 
 				envOracle={}, 
 				envProgress={},
-				driver=''):
+				driver='',
+				prmApiBaseUrl="",
+				prmApiKey="",
+				prmApiKeyName="sk"):
 		self.set_env( envOracle=envOracle, envProgress=envProgress, driver=driver )
 		self.EOF = 1
 		self.connHandle = 0
@@ -336,16 +353,21 @@ class dbObjConnection:
 		self.autoreconnect = True if self.dbType == "MYSQL" else False
 		self.reconnect_max = 2
 		self.reconnect_attempts = 0
-		self.using_pymysql = using_pymysql	
-		self.host, self.db, self.user, self.passwd, self.port = prmHost, prmDb, prmUser, prmPass, prmPort
-		if( self.dbType and self.host and self.db and self.user and self.passwd and self.port ):
+		self.using_pymysql = using_pymysql
+		self.drivers = lstLoadedDrivers
+		if(prmDBType == "API"):
+			self.apiBaseUrl = prmApiBaseUrl
+			self.apiKeyName = prmApiKeyName
+			self.apiKey = prmApiKey
 			self.connect()
-
+		else:
+			self.host, self.db, self.user, self.passwd, self.port = prmHost, prmDb, prmUser, prmPass, prmPort
+			if( self.dbType and self.host and self.db and self.user and self.passwd and self.port ):
+				self.connect()
 
 	def __del__(self):
 		self.close_connection()
 
-
 	def set_env(self, envOracle={}, envProgress={}, driver={}):
 		default_envOracle = { 	'LD_LIBRARY_PATH': '/usr/lib/oracle/instantclient_12_2/',
 								'ORACLE_HOME': '/usr/lib/oracle/instantclient_12_2/',
@@ -365,7 +387,6 @@ class dbObjConnection:
 			os.putenv( env_var, env_val )
 			os.environ[ env_var ] = env_val
 
-
 	def close_connection(self):
 		try:
 			if self.connHandle and not( isinstance(self.connHandle, int) ):
@@ -375,37 +396,36 @@ class dbObjConnection:
 		except Exception as e:
 			print(str(e))
 
-
 	def connect(self, prmHost="", prmDb="", prmUser="", prmPass="", prmPort=3306):
-		prmHost = prmHost or self.host
-		prmDb = prmDb or self.db
-		prmUser = prmUser or self.user
-		prmPass = prmPass or self.passwd
-		prmPort = prmPort or self.port
-		self.host, self.db, self.user, self.passwd, self.port = prmHost, prmDb, prmUser, prmPass, prmPort
-		if(self.dbType == "MYSQL"):
-			return self.mySqlConnect(prmHost, prmDb, prmUser, prmPass, prmPort)
-		elif(self.dbType == "MSSQL"):
-			return self.msSqlConnect(prmHost, prmDb, prmUser, prmPass)
-		elif(self.dbType == "ORACLE"):
-			return self.oracleConnect(prmUser, prmPass, prmDb)
-		elif(self.dbType == "SQLITE" or self.dbType == "SQLITE3"):
-			return self.sqlite3Connect(prmDb)
-		elif(self.dbType == "PROGRESS"):
-			return self.progressConnect(prmHost, prmDb, prmUser, prmPass, prmPort)
-
+		if(self.dbType == "API"):
+			return self.apiConnect()
+		else:
+			prmHost = prmHost or self.host
+			prmDb = prmDb or self.db
+			prmUser = prmUser or self.user
+			prmPass = prmPass or self.passwd
+			prmPort = prmPort or self.port
+			self.host, self.db, self.user, self.passwd, self.port = prmHost, prmDb, prmUser, prmPass, prmPort
+			if(self.dbType == "MYSQL"):
+				return self.mySqlConnect(prmHost, prmDb, prmUser, prmPass, prmPort)
+			elif(self.dbType == "MSSQL"):
+				return self.msSqlConnect(prmHost, prmDb, prmUser, prmPass)
+			elif(self.dbType == "ORACLE"):
+				return self.oracleConnect(prmUser, prmPass, prmDb)
+			elif(self.dbType == "SQLITE" or self.dbType == "SQLITE3"):
+				return self.sqlite3Connect(prmDb)
+			elif(self.dbType == "PROGRESS"):
+				return self.progressConnect(prmHost, prmDb, prmUser, prmPass, prmPort)
 
 	def setConnectSuccess(self):
 		self.reconnect_attempts = 0
 		self.msgObj.message = "Connected to {0} Database okay.".format(self.dbType)
 		self.msgObj.success = True
 
-
 	def setConnectFail(self, msgException=""):
 		self.msgObj.message += " - Connection to {0} Database Failed. {1}".format(self.dbType, msgException)
 		self.msgObj.success = False
 
-
 	def mySqlConnect(self, prmHost, prmDb, prmUser, prmPass, prmPort=3306):
 		try:
 			self.connHandle = MySQLdb.connect(host=prmHost,db=prmDb,user=prmUser,passwd=prmPass,port=prmPort)
@@ -418,7 +438,6 @@ class dbObjConnection:
 			self.setConnectFail(e)
 		return self.msgObj
 
-
 	def msSqlConnect(self, prmHost, prmDb, prmUser, prmPass):
 		try:
 			self.connHandle = pymssql.connect(prmHost, prmUser, prmPass, prmDb)
@@ -431,7 +450,6 @@ class dbObjConnection:
 			self.setConnectFail(e)
 		return self.msgObj
 
-
 	def oracleConnect(self, prmUser, prmPass, prmTns):
 		try:
 			self.connHandle = cx_Oracle.connect(prmUser, prmPass, prmTns)
@@ -443,7 +461,6 @@ class dbObjConnection:
 			self.setConnectFail(e)
 		return self.msgObj
 
-
 	def sqlite3Connect(self, prmDb):
 		try:
 			self.connHandle = sqlite3.connect(prmDb)
@@ -456,7 +473,6 @@ class dbObjConnection:
 			self.setConnectFail(e)
 		return self.msgObj
 
-
 	def progressConnect(self, prmHost, prmDb, prmUser, prmPass, prmPort=35078, envProgress={}, driver=None):
 		try:
 			driver = driver or self.driver
@@ -483,6 +499,12 @@ class dbObjConnection:
 
 		return self.msgObj
 
+	def apiConnect(self):
+		if(self.apiBaseUrl == "" or self.apiKey == ""):
+			self.setConnectFail("API URL or Key missing")
+		else:
+			self.setConnectSuccess()
+		return self.msgObj
 
 	def reconnect(self):
 		# https://dev.mysql.com/doc/refman/8.0/en/gone-away.html
@@ -534,7 +556,6 @@ class dbObjConnection:
 			print('Connection to {0} Restored.'.format(self.dbType))
 		return self.msgObj
 
-
 	def getCursor(self):
 		if(self.dbType == "MYSQL"):
 			return self.mySqlGetCursor()
@@ -546,7 +567,8 @@ class dbObjConnection:
 			return self.sqlite3GetCursor()
 		elif(self.dbType == "PROGRESS"):
 			return self.progressGetCursor()
-
+		elif(self.dbType == "API"):
+			return self.apiGetCursor()
 
 	def setCursorSuccess(self, cursor):
 		if cursor:
@@ -555,12 +577,10 @@ class dbObjConnection:
 		else:
 			self.setCursorFail()
 
-
 	def setCursorFail(self,msgException):
 		self.msgObj.message = "Exception Getting {0} Cursor: {1}".format(self.dbType,msgException)
 		self.msgObj.success = False
 
-
 	def mySqlGetCursor(self):
 		try:
 			cursor = dbObjCursor(self.connHandle, self.dbType)
@@ -569,7 +589,6 @@ class dbObjConnection:
 		except Exception as e:
 			self.setCursorFail(e)
 
-
 	def mssqlGetCursor(self):
 		try:
 			cursor = dbObjCursor(self.connHandle, self.dbType)
@@ -578,7 +597,6 @@ class dbObjConnection:
 		except Exception as e:
 			self.setCursorFail(e)
 
-
 	def oracleGetCursor(self):
 		try:
 			cursor = dbObjCursor(self.connHandle, self.dbType)
@@ -587,7 +605,6 @@ class dbObjConnection:
 		except Exception as e:
 			self.setCursorFail(e)
 
-
 	def sqlite3GetCursor(self):
 		try:
 			cursor = dbObjCursor(self.connHandle, self.dbType)
@@ -596,7 +613,6 @@ class dbObjConnection:
 		except Exception as e:
 			self.setCursorFail(e)
 
-
 	def progressGetCursor(self):
 		try:
 			cursor = dbObjCursor(self.connHandle, self.dbType)
@@ -605,6 +621,13 @@ class dbObjConnection:
 		except Exception as e:
 			self.setCursorFail(e)
 
+	def apiGetCursor(self):
+		try:
+			cursor = dbObjCursor(None, self.dbType)
+			self.setCursorSuccess(cursor)
+			return cursor
+		except Exception as e:
+			self.setCursorFail(e)
 
 	def disconnect(self):
 		"""Disconnect the connection handle to the database"""
@@ -619,36 +642,33 @@ class dbObjConnection:
 		elif(self.dbType == "PROGRESS"):
 			self.progressDisconnect()
 
-
 	def mySqlDisconnect(self):
 		if self.connHandle and self.connHandle.open:
 			self.connHandle.close()
 			self.connHandle = None
 
-
 	def msSqlDisconnect(self):
 		if self.connHandle and self.connHandle.open:
 			self.connHandle.close()
 			self.connHandle = None
 
-
 	def oracleDisconnect(self):
 		if self.connHandle:
 			self.connHandle.close()
 			self.connHandle = None
 
-
 	def sqlite3Disconnect(self):
 		if self.connHandle and self.connHandle.open:
 			self.connHandle.close()
 			self.connHandle = None
 
-
 	def progressDisconnect(self):
 		if self.connHandle:
 			self.connHandle.close()
 			self.connHandle = None
 
+	def apiDisconnect(self):
+		pass
 
 	def execute(self, prmSql, *args):
 		"""Execute the SQL and return a record set if applicable"""
@@ -662,6 +682,8 @@ class dbObjConnection:
 			return self.sqlite3Execute(prmSql)
 		if(self.dbType in ("PROGRESS")):
 			return self.progressExecute(prmSql)
+		if(self.dbType in ("API")):
+			return self.apiExecute(prmSql)
 
 
 	def fetchall(self, prmSql, *args):
@@ -688,6 +710,21 @@ class dbObjConnection:
 		return None if not listVals else listVals[0]
 
 
+	def fetchlistvals(self, prmSql, *args):
+		"""Returns a list of vals; if more than one key/column, returns a list of value tuples"""
+		listvals = []
+		rset = self.fetchall(prmSql, *args)
+		if not rset:
+			return []
+		keys = list(rset[0].keys())
+		for dictRow in rset:
+			if len(keys) == 1:
+				listvals.append( dictRow.get(keys[0]) )
+			else:
+				listvals.append( tuple( dictRow.get(k) for k in keys  ) )
+		return listvals
+
+
 	def insert(self, table, prmDict, update_on_duplicate=False):
 		if update_on_duplicate:
 			keystr = ','.join(prmDict.keys())
@@ -704,14 +741,12 @@ class dbObjConnection:
 			strSql = "INSERT INTO {table} ({keystr}) VALUES ({valstr})".format(table=table,keystr=keystr,valstr=valstr)
 			return self.execute(strSql, *args)
 
-
 	def updatedict(self, table, unique_column, unique_value, prmDict):
 		setstr = ",".join(["{k}=%s".format(k=k) for k in prmDict.keys()])
 		args = tuple(prmDict.values())
 		strSql = "UPDATE {table} SET {setstr} WHERE {unique_column} = {unique_value}".format(table=table,setstr=setstr,unique_column=unique_column,unique_value=unique_value)
 		return self.execute(strSql, *args)
 
-
 	def ping(self, reconnect=True):
 		if(self.dbType == "MYSQL"):
 			self.mySqlPing()
@@ -732,7 +767,6 @@ class dbObjConnection:
 			pass
 			self.progressPing()
 
-
 	def mySqlPing(self, reconnect=True):
 		"""
 		Check if the server is alive.
@@ -771,7 +805,6 @@ class dbObjConnection:
 			else:
 				raise Exception
 
-
 	def setMySqlExecuteFail(self, mySqlCursor, prmSql, e, *args):
 		self.msgObj.success = False
 		prmSql += '' if not args else ' ({0}) '.format( repr(args) )
@@ -801,7 +834,6 @@ class dbObjConnection:
 		finally:
 			return mySqlCursor
 
-
 	def mySqlExecute(self, prmSql, *args):
 		mySqlCursor = self.getCursor()
 		try:
@@ -838,7 +870,6 @@ class dbObjConnection:
 			mySqlCursor = self.setMySqlExecuteSuccess(mySqlCursor, prmSql, *args)
 			return mySqlCursor
 
-
 	def msSqlExecute(self, prmSql):
 		msSqlCursor = self.getCursor()
 		try:
@@ -857,7 +888,6 @@ class dbObjConnection:
 		msSqlCursor.next()
 		return msSqlCursor
 
-
 	def oracleExecute(self, prmSql):
 		oracleCursor = self.getCursor()
 		try:
@@ -879,7 +909,6 @@ class dbObjConnection:
 			oracleCursor.EOF = 1
 		return oracleCursor
 
-
 	def sqlite3Execute(self, prmSql):
 		sqliteCursor = self.getCursor()
 		try:
@@ -900,7 +929,6 @@ class dbObjConnection:
 			sqliteCursor.EOF = 1
 		return sqliteCursor
 
-
 	def progressExecute(self, prmSql):
 		progressCursor = self.getCursor()
 		try:
@@ -922,12 +950,54 @@ class dbObjConnection:
 			progressCursor.EOF = 1
 		return progressCursor
 
+	def apiExecute(self, prmSql):
+		apiCursor = self.getCursor()
+		apiCursor.success = False
+		try:
+			# convert sqls to url safe version
+			#sqls = requests.compat.quote_plus( prmSql )
+			sqls = prmSql
+			headers = {'Content-type':'application/json'}
+			payload = {self.apiKeyName: self.apiKey, "sql": sqls}
+			r = requests.post(self.apiBaseUrl + "/execute", data=json.dumps(payload), headers=headers)
+			#print(r.request.body)
+			#print(r.request.headers)
+			if(r.status_code == requests.codes.ok):
+				retVal = r.json()
+				#print(retVal)
+				if(retVal["error"] == 0):
+					apiCursor.lstRecords = retVal["data"]
+					apiCursor.numRows = len(apiCursor.lstRecords)
+					if(apiCursor.numRows > 0):
+						apiCursor.numFields = len(apiCursor.lstRecords[0].keys())
+						apiCursor.EOF = 0
+						self.lastInsId = retVal["message"]
+						apiCursor.next()
+					else:
+						apiCursor.numFields = 0
+						apiCursor.EOF = 1
+					apiCursor.success = True
+					self.msgObj.message = "SQL Executed: "+prmSql
+					self.msgObj.success = True
+				else:
+					self.msgObj.message = "SQL Failed: "+str(retVal["message"])
+					self.msgObj.success = False
+			else:
+				self.msgObj.message = "SQL Failed: "+str(r.status_code)
+				self.msgObj.success = False
+		except Exception as e:
+			self.msgObj.message = "SQL Failed: "+prmSql+" - "+str(e)
+			self.msgObj.success = False
+			apiCursor.numFields = 0
+			apiCursor.numRows = 0
+			apiCursor.EOF = 1
+			apiCursor.success = False
+		return apiCursor
 
 	def commit(self):
 		if(self.dbType == "MYSQL"):
 			self.connHandle.commit()
 
-
 if __name__ == '__main__':
 	import time, pprint
 	pp = pprint.PrettyPrinter(indent=4, width=80).pprint
@@ -940,7 +1010,6 @@ if __name__ == '__main__':
 		else:
 			return input(prompt,*args,**kwargs)
 
-
 	def dbtest():
 		dbhost = getInput( "MySQL Hostname: " )
 		dbname = getInput( "MySQL Database Name: ")
@@ -952,7 +1021,6 @@ if __name__ == '__main__':
 		print( "message: {v}".format(v=result.message) )
 		return odb if result.success else None
 
-
 	def sqltest(dbConn=None,sqls=''):
 		sqls = sqls or getInput( "\nEnter SQL Statement: ")
 		t0 = time.time()
@@ -971,7 +1039,6 @@ if __name__ == '__main__':
 				print('\n')
 		return sqls, rset
 
-
 	def run_test():
 		odb = None
 		print("<enter> for yes or 'n' for no\n")
@@ -1022,7 +1089,5 @@ if __name__ == '__main__':
 			odb.autoreconnect = True
 		return odb
 
-
-
 	# odb will be the interactively instantiated dbObj connection 
 	odb = run_test()