dbobj3 0.1.0__tar.gz

dbobj3-0.1.0/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.5
+Name: dbobj3
+Version: 0.1.0
+Summary: High-level MySQL/MSSQL/Oracle access module
+Requires-Python: >=3.6
+Requires-Dist: pymysql
+Description-Content-Type: text/markdown
+
+# dbobj3
+
+High-level database access module for MySQL, MS SQL Server, and Oracle.
+Works identically across all supported databases.

dbobj3-0.1.0/README.md

@@ -0,0 +1,4 @@
+# dbobj3
+
+High-level database access module for MySQL, MS SQL Server, and Oracle.
+Works identically across all supported databases.

dbobj3-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dbobj3"
+version = "0.1.0"
+description = "High-level MySQL/MSSQL/Oracle access module"
+readme = "README.md"
+requires-python = ">=3.6"
+dependencies = [
+    "PyMySQL",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dbobj3.py"]
+
+[tool.bumpversion]
+current_version = "0.1.0"
+commit = true
+tag = true
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)"
+serialize = ["{major}.{minor}"]
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "src/dbobj3.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'

dbobj3-0.1.0/src/dbobj3.py

@@ -0,0 +1,458 @@
+#!/usr/local/bin/python3.6
+
+"""
+High-Level Access to MySQL, MS SQL Server and Oracle Module
+This module functions the same across all databases and works very similarly to ADO.
+
+This module is the latest version of dbObj which has been in use for some time.
+This module does not change the case of fields that are returned in record sets.
+
+Example:
+	myuser = input("MySQL Username: ")
+	mypassword = getpass.getpass()
+	connDb1a = dbObjConnection()
+	result = connDb1a.connect("db1a", "internet", myuser, mypassword)
+	rsServices = connDb1a.execute("select * from services")
+	while(not rsServices.EOF):
+		print(rsServices.fields["description"]
+		strSql = "select count(*) as ct from userservices where serviceid = '"+str(rsServices.fields["serviceid"])+"'"
+		rsCount = connDb1a.execute(strSql)
+		print(rsCount.fields["ct"]
+		rsServices.next()
+
+"""
+
+__version__ = "0.1.0"
+
+import MySQLdb
+import MySQLdb.cursors 
+import pymssql
+import sqlite3
+import getpass
+try:
+	import cx_Oracle
+except ImportError:
+	pass
+
+class dbConnMessage:
+	"""
+	The dbConnMessage is an object that is returned in response to a dbObjConnection.  It has two
+	properties:
+	   success - True or False
+	   message - Generally, reason for failure
+	"""
+	def __init__(self):
+		self.success = False
+		self.message = ""
+
+class dbObjCursor:
+	"""
+	Database cursor object controls the cursor connected to a database.  Multiple cursors
+	can exist for a single Database connection object
+	"""
+	def __init__(self, prmConnection=None, prmDBType="MYSQL"):
+		self.EOF = 1
+		self.connection = prmConnection
+		self.cursor = None
+		self.numFields = 0
+		self.numRows = 0
+		self.lstRecords = []				# Used by Oracle and Sqlite3
+		self.recordPointer = 0
+		self.success = True
+		self.dbType = prmDBType.upper()
+		self.create(self.dbType)
+		
+	def __del__(self):
+		if(self.dbType == "MYSQL"):
+			self.cursor.close()
+		
+	def create(self, prmDBType="MYSQL"):
+		if(prmDBType=="MYSQL"):
+			self.createMySql()
+		elif(prmDBType=="MSSQL"):
+			self.createMsSql()
+		elif(prmDBType=="ORACLE"):
+			self.createOracle()
+		elif(prmDBType=="SQLITE" or prmDBType=="SQLITE3"):
+			self.createSqlite3()
+				
+	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 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"):
+			self.mySqlNext()
+		elif(self.dbType == "MSSQL"):
+			self.msSqlNext()
+		elif(self.dbType == "ORACLE"):
+			self.oracleNext()
+		elif(self.dbType == "SQLITE" or self.dbType == "SQLITE3"):
+			self.sqlite3Next()
+
+	def mySqlNext(self):
+		resultSet = self.cursor.fetchone()
+		if(resultSet != None):
+			self.fieldByName = resultSet
+			self.fields = self.fieldByName
+			self.EOF = 0
+		else:
+			self.fieldByName = {}
+			self.fields = self.fieldByName
+			self.EOF = 1
+
+	def msSqlNext(self):
+		try:
+			resultSet = self.cursor.fetchone()
+		except Exception as e:
+			print(e)
+			self.EOF = 1	
+			return
+		if(resultSet != None):
+			self.fields = resultSet
+			self.EOF = 0
+		else:
+			self.EOF = 1			
+
+	def oracleNext(self):
+		if(self.recordPointer <= self.numRows):
+			self.fieldByName = {}
+			self.fieldNames = []
+			fieldNo = 0
+			for cursorFieldname in self.cursor.description:
+				self.fieldByName[cursorFieldname[0]] = self.lstRecords[(self.recordPointer-1)][fieldNo]
+				self.fieldNames.append(cursorFieldname[0])
+				fieldNo = fieldNo + 1
+			self.fields = self.fieldByName
+			self.recordPointer += 1
+			self.EOF = 0
+		else:
+			self.EOF = 1			
+
+	def sqlite3Next(self):
+		if(self.recordPointer <= self.numRows):
+			self.fieldByName = {}
+			self.fieldNames = []
+			fieldNo = 0
+			for cursorFieldname in self.cursor.description:
+				self.fieldByName[cursorFieldname[0]] = self.lstRecords[(self.recordPointer-1)][fieldNo]
+				self.fieldNames.append(cursorFieldname[0])
+				fieldNo = fieldNo + 1
+			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
+		transparently by dbObjConnection.execute and fetches all records at once where the other 
+		database types do not.
+		"""
+		self.cursor.execute(prmSql)
+		self.lstRecords = self.cursor.fetchall()
+		self.numRows = len(self.lstRecords)
+		self.numFields = len(self.cursor.description)
+		if(self.numRows > 0):
+			self.recordPointer = 1
+
+	def sqlite3Execute(self, prmSql):
+		"""
+		Sqlite3 method is called transparently by dbObjConnection.execute and fetches all records at once where the other 
+		database types do not.
+		"""
+		self.cursor.execute(prmSql)
+		self.lstRecords = self.cursor.fetchall()
+		self.numRows = len(self.lstRecords)
+		self.numFields = len(self.cursor.description)
+		if(self.numRows > 0):
+			self.recordPointer = 1
+
+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 and Oracle.
+	"""
+	def __init__(self, prmDBType="MYSQL"):
+		"""prmDBType can be:  MYSQL, MSSQL, or ORACLE"""
+		self.EOF = 1
+		self.connHandle = 0
+		self.dbType = prmDBType.upper()
+		self.msgObj = dbConnMessage()
+		self.lastInsId = 0
+
+	def __del__(self):
+		"""The default destructor will close the connection"""
+		if(self.dbType == "MYSQL"):
+			self.connHandle.commit()
+		self.connHandle.close()
+
+	def connect(self, prmHost="", prmDb="", prmUser="", prmPass=""):
+		"""
+		MySQL:
+			result = connMySQL.connect("db1a", "internet", myuser, mypassword)
+		MS SQL:
+			result = connMSSQL.connect("flexibill-mssql", "FLEXIBILL", msuser, mspassword)
+		Oracle:
+			result = connOracl.connect("", "MDDB", orauser, orapassword)
+		
+		returns: dbConnMessage 
+		"""
+		if(self.dbType == "MYSQL"):
+			return self.mySqlConnect(prmHost, prmDb, prmUser, prmPass)
+		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)
+
+	def mySqlConnect(self, prmHost, prmDb, prmUser, prmPass):
+		try:
+			self.connHandle = MySQLdb.connect(host=prmHost,db=prmDb,user=prmUser,passwd=prmPass)
+			if(self.connHandle):
+				self.msgObj.message = "Connected to MySqlDatabase okay."
+				self.msgObj.success = True
+			else:
+				self.msgObj.message = "Connection Failed."
+				self.msgObj.success = False
+		except Exception as e:
+			self.msgObj.message = "Connection Failed: "+str(e)
+			self.msgObj.success = False
+		return self.msgObj
+
+	def msSqlConnect(self, prmHost, prmDb, prmUser, prmPass):
+		try:
+			self.connHandle = pymssql.connect(prmHost, prmUser, prmPass, prmDb)
+			self.connHandle.autocommit(True)
+			if(self.connHandle):
+				self.msgObj.message = "Connected to MS SQL Database okay."
+				self.msgObj.success = True
+			else:
+				self.msgObj.message = "Connection Failed."
+				self.msgObj.success = False
+		except Exception as e:
+			self.msgObj.message = "Connection Failed: "+str(e)
+			self.msgObj.success = False
+		return self.msgObj
+
+	def oracleConnect(self, prmUser, prmPass, prmTns):
+		try:
+			self.connHandle = cx_Oracle.connect(prmUser, prmPass, prmTns)
+			if(self.connHandle):
+				self.msgObj.message = "Connected to Oracle Database okay."
+				self.msgObj.success = True
+			else:
+				self.msgObj.message = "Connection Failed."
+				self.msgObj.success = False
+		except Exception as e:
+			self.msgObj.message = "Connection Failed: "+str(e)
+			self.msgObj.success = False
+		return self.msgObj
+
+	def sqlite3Connect(self, prmDb):
+		try:
+			self.connHandle = sqlite3.connect(prmDb)
+			self.connHandle.row_factory = sqlite3.Row
+			if(self.connHandle):
+				self.msgObj.message = "Connected to Sqlite3 Database okay."
+				self.msgObj.success = True
+			else:
+				self.msgObj.message = "Connection Failed."
+				self.msgObj.success = False
+		except Exception as e:
+			self.msgObj.message = "Connection Failed: "+str(e)
+			self.msgObj.success = False
+		return self.msgObj
+
+	def disconnect(self):
+		"""Disconnect the connection handle to the database"""
+		if(self.dbType == "MYSQL"):
+			self.mySqlDisconnect()
+		elif(self.dbType == "MSSQL"):
+			self.msSqlDisconnect()
+		elif(self.dbType == "ORACLE"):
+			self.oracleDisconnect()
+		elif(self.dbType == "SQLITE" or self.dbType == "SQLITE3"):
+			self.sqlite3Disconnect()
+
+	def mySqlDisconnect(self):
+		self.connHandle.close()
+
+	def msSqlDisconnect(self):
+		self.connHandle.close()
+
+	def oracleDisconnect(self):
+		self.connHandle.close()
+
+	def sqlite3Disconnect(self):
+		self.connHandle.close()
+
+	def execute(self, prmSql):
+		"""Execute the SQL and return a record set if applicable"""
+		if(self.dbType == "MYSQL"):
+			return self.mySqlExecute(prmSql)
+		if(self.dbType == "MSSQL"):
+			return self.msSqlExecute(prmSql)
+		if(self.dbType == "ORACLE"):
+			return self.oracleExecute(prmSql)
+
+	def mySqlExecute(self, prmSql):
+		mySqlCursor = dbObjCursor(self.connHandle)
+		try:
+			mySqlCursor.cursor.execute(prmSql)
+			self.msgObj.message = "SQL Executed: "+prmSql
+			self.msgObj.success = True
+			mySqlCursor.numRows = mySqlCursor.cursor.rowcount
+			self.lastInsId = self.connHandle.insert_id()
+		except Exception as e:
+			self.msgObj.message = "SQL Failed: "+prmSql+" - "+str(e)
+			self.msgObj.success = False
+			mySqlCursor.numFields = 0
+			mySqlCursor.numRows = 0
+			mySqlCursor.EOF = 1
+			mySqlCursor.success = False
+			return mySqlCursor
+		try:
+			mySqlCursor.numFields = len(mySqlCursor.cursor.description)
+		except:
+			mySqlCursor.numFields = 0
+		if(mySqlCursor.numRows):
+			mySqlCursor.next()
+		else:
+			mySqlCursor.EOF = 1
+		return mySqlCursor
+
+	def msSqlExecute(self, prmSql):
+		msSqlCursor = dbObjCursor(self.connHandle, "MSSQL")
+		try:
+			msSqlCursor.cursor.execute(prmSql)
+			self.msgObj.message = "SQL Executed: "+prmSql
+			self.msgObj.success = True
+		except Exception as e:
+			self.msgObj.message = "SQL Failed: "+prmSql+" - "+str(e)
+			self.msgObj.success = False
+			msSqlCursor.numFields = 0
+			msSqlCursor.numRows = 0
+			msSqlCursor.EOF = 1
+			msSqlCursor.success = False
+			return mySqlCursor
+		msSqlCursor.next()
+		return msSqlCursor
+
+	def oracleExecute(self, prmSql):
+		oracleCursor = dbObjCursor(self.connHandle, "ORACLE")
+		try:
+			oracleCursor.oracleExecute(prmSql)
+			self.msgObj.message = "SQL Executed: "+prmSql
+			self.msgObj.success = True
+		except Exception as e:
+			self.msgObj.message = "SQL Failed: "+prmSql+" - "+str(e)
+			self.msgObj.success = False
+			print(str(e))
+			oracleCursor.numFields = 0
+			oracleCursor.numRows = 0
+			oracleCursor.EOF = 1
+			oracleCursor.success = False
+			return mySqlCursor
+		if(oracleCursor.numRows):
+			oracleCursor.next()
+		else:
+			oracleCursor.EOF = 1
+		return oracleCursor
+		
+	def commit(self):
+		if(self.dbType == "MYSQL"):
+			self.connHandle.commit()
+		
+if __name__== '__main__' :
+	# MySQL Testing - two cursors - nested
+	print("********************** MySQL Test **********************")
+	myuser = input("MySQL Username: ")
+	mypassword = getpass.getpass()
+	conn = dbObjConnection()
+	result = conn.connect("127.0.0.1", "internet", myuser, mypassword)
+	print(result.message)
+	if(result.success):
+		try:
+			rsServices = conn.execute("select * from services")
+			while(not rsServices.EOF):
+				print(rsServices.fields["description"])
+				strSql = "select count(*) as ct from userservices where serviceid = '"+str(rsServices.fields["serviceid"])+"'"
+				rsCount = conn.execute(strSql)
+				#print(rsCount.fields["ct"])
+				rsServices.next()
+			rsServices.first()
+			print("-----------------------------")
+			while(not rsServices.EOF):
+				print(rsServices.fields["description"])
+				strSql = "select count(*) as ct from userservices where serviceid = '"+str(rsServices.fields["serviceid"])+"'"
+				rsCount = conn.execute(strSql)
+				#print(rsCount.fields["ct"])
+				rsServices.next()
+		except Exception as e:
+			print(e)
+	# MS SQL Testing
+	try:
+		print("********************** MS SQL Server Test **********************")
+		msuser = input("MS SQL Server Username: ")
+		mspassword = getpass.getpass()
+		conn2 = dbObjConnection("MSSQL")
+		result = conn2.connect("flexibill-mssql", "FLEXIBILL", msuser, mspassword)
+		print(result.message)
+		print(result.success)
+		rsExgTab = conn2.execute("SELECT * FROM EXGTAB")
+		while(not rsExgTab.EOF):
+			print(rsExgTab.fields["EXCHANGE"])
+			rsExgTab.moveNext()
+		#rsExgTab.first()
+		#print"-----------------------------------")
+		#while(not rsExgTab.EOF):
+		#	print(rsExgTab.fields["EXCHANGE"])
+		#	rsExgTab.moveNext()
+		#rsNextCustPsocAcct = conn2.execute("EXEC GETNEXTCUSTPSOCACCT")
+		#print(rsNextCustPsocAcct.fields)
+	except Exception as e:
+		print(e)
+	# Oracle Testing
+	try:
+		print("********************** Oracle Test **********************")
+		orauser = input("Oracle Server Username: ")
+		orapassword = getpass.getpass()
+		conn3 = dbObjConnection("ORACLE")
+		result = conn3.connect("", "MDDB", orauser, orapassword)
+		print(result.message)
+		print(result.success)
+		rsChannel = conn3.execute("select * from channel")
+		x=1
+		while(not rsChannel.EOF):
+			print(str(x)+" - "+ rsChannel.fields["CHANNEL_NAME"])
+			x+= 1
+			#print(rsChannel.fields)
+			rsChannel.moveNext()
+		print("Total records: "+str(rsChannel.numRows))
+	except Exception as e:
+		print(e)