sqlalchemy-iris 0.5.0b3__py3-none-any.whl → 0.6.0b1__py3-none-any.whl

intersystems_iris/_IRISList.py

@@ -0,0 +1,360 @@
+import intersystems_iris._DBList
+import intersystems_iris._ListReader
+import intersystems_iris._ListWriter
+import intersystems_iris._IRIS
+
+class _IRISList(object):
+    '''
+    This class provides an interface to interact with IRIS $LIST data.
+'''
+
+    def __init__(self, buffer = None, locale = "latin-1", is_unicode = True, compact_double = False):
+        self._list_data = []
+        self._locale = locale
+        self._is_unicode = is_unicode
+        self.compact_double = compact_double
+        try:
+            if buffer == None:
+                return
+            if type(buffer) == intersystems_iris.IRISList:
+                buffer = buffer.getBuffer()
+            if type(buffer) == bytes or type(buffer) == bytearray:
+                list_reader = intersystems_iris._ListReader._ListReader(buffer, locale)
+                while not list_reader._is_end():
+                    value = list_reader._get(True)
+                    if value is None and list_reader.list_item.type !=  intersystems_iris._DBList._DBList.ITEM_UNDEF:
+                        value = bytes()
+                    self._list_data.append(value)
+                return
+        except Exception as ex:
+            pass
+        raise Exception("data is not valid for IRISList format")
+
+    def get(self, index):
+        '''
+Returns the value at a given index.
+
+get(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns bytes, Decimal, float, int, str, or IRISList.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            raw_data = raw_data.getBuffer()
+        if type(raw_data) == bytes:
+            return intersystems_iris.IRIS._convertToString(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale)
+        return raw_data
+
+    def getBoolean(self, index):
+        '''
+Returns the value at a given index as a boolean.
+
+getBoolean(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns bool.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            raw_data = raw_data.getBuffer()
+        return intersystems_iris.IRIS._convertToBoolean(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale)
+
+    def getBytes(self, index):
+        '''
+Returns the value at a given index as bytes.
+
+getBytes(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns bytes.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            return raw_data.getBuffer()
+        return intersystems_iris.IRIS._convertToBytes(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale, self._is_unicode)
+
+    def getDecimal(self, index):
+        '''
+Returns the value at a given index as a Decimal.
+
+getDecimal(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns Decimal.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            raw_data = raw_data.getBuffer()
+        return intersystems_iris.IRIS._convertToDecimal(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale)
+
+    def getFloat(self, index):
+        '''
+Returns the value at a given index as a float.
+
+getFloat(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns float.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            raw_data = raw_data.getBuffer()
+        return intersystems_iris.IRIS._convertToFloat(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale)
+
+    def getInteger(self, index):
+        '''
+Returns the value at a given index as an integer.
+
+getInteger(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns int.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            raw_data = raw_data.getBuffer()
+        return intersystems_iris.IRIS._convertToInteger(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale)
+
+    def getString(self, index):
+        '''
+Returns the value at a given index as a string.
+
+getString(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns str.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList:
+            raw_data = raw_data.getBuffer()
+        return intersystems_iris.IRIS._convertToString(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale)
+
+    def getIRISList(self, index):
+        '''
+Returns the value at a given index as an IRISList.
+
+getBytes(index)
+
+Parameters
+----------
+index : one-based index of the IRISList.
+
+Return Value
+------------
+Returns IRISList.
+'''
+        raw_data = self._list_data[index-1]
+        if type(raw_data) == intersystems_iris.IRISList or raw_data == None:
+            return raw_data
+        return intersystems_iris.IRISList(intersystems_iris.IRIS._convertToBytes(raw_data, intersystems_iris.IRIS.MODE_LIST, self._locale, self._is_unicode), self._locale, self._is_unicode, self.compact_double)
+
+    def add(self, value):
+        '''
+Adds a data element at the end of the IRISList.
+
+add(value)
+
+Parameters
+----------
+value : value of the data to be added.
+
+Return Value
+------------
+Returns the current IRISList object.
+'''
+        self._list_data.append(self._convertToInternal(value))
+        return self
+
+    def set(self, index, value):
+        '''
+Change data element at a given index location. If the index is beyond the length of the IRISList, IRISList will be first expanded to that many elements, paded with None elements.
+
+set(index, value)
+
+Parameters
+----------
+index: index at which the data is set to. index is one-based.
+value : value of the data to be added.
+
+Return Value
+------------
+Returns the current IRISList object.
+'''
+        if index>len(self._list_data):
+            self._list_data.extend([None]*(index-len(self._list_data)))
+        self._list_data[index-1] = self._convertToInternal(value)
+        return self
+
+    def _convertToInternal(self, value):
+        if type(value) == bytearray:
+            return bytes(value)
+        if type(value) == intersystems_iris.IRISList:
+            if not self.compact_double and value.compact_double:
+                raise ValueError("Cannot embed an IRISList with Compact Double enabled into an IRISList with Compact Double disabled")
+            return intersystems_iris.IRISList(value.getBuffer(), value._locale, value._is_unicode, value.compact_double)
+        return value
+
+    def remove(self, index):
+        '''
+Remove a data element at a given index location.
+
+remove(index, value)
+
+Parameters
+----------
+index: index at which the data is to be removed. index is one-based.
+
+Return Value
+------------
+Returns the current IRISList object.
+'''
+        del self._list_data[index-1]
+        return self
+
+    def size(self):
+        '''
+Return the length of the data buffer
+
+size()
+
+Return Value
+------------
+Returns int.
+'''
+        return len(self.getBuffer())
+
+    def count(self):
+        '''
+Return the unmber of data elements in the IRISList.
+
+count()
+
+Return Value
+------------
+Returns int.
+'''
+        return len(self._list_data)
+
+    def clear(self):
+        '''
+Clears out all data in the IRISList.
+
+clear()
+
+Return Value
+------------
+Returns the current IRISList object.
+'''
+        self._list_data = []
+        return self
+
+    def equals(self, irislist2):
+        '''
+Returns a boolean indicate if the IRISList is the same as the IRISList of the argument
+
+equals(irislist2)
+
+Parameters
+----------
+irislist2: the second IRISList object to which to compare.
+
+Return Value
+------------
+Returns bool.
+'''
+        if type(irislist2) != intersystems_iris.IRISList:
+            raise TypeError("Argument must be an instance of iris.IRISList")
+        if len(self._list_data) != len(irislist2._list_data):
+            return False
+        for i in range(len(self._list_data)):
+            if self.get(i+1) != irislist2.get(i+1):
+                return False
+        return True
+
+    def __str__(self):
+        display = []
+        for i in range(len(self._list_data)):
+            raw_data = self._list_data[i]
+            if type(raw_data) == intersystems_iris.IRISList:
+                raw_data = raw_data.__str__()
+            elif type(raw_data) == bool:
+                raw_data = 1 if raw_data else 0
+            if type(raw_data) == bytes:
+                try:
+                    if len(raw_data) == 0:
+                        one_value = "empty"
+                    else:
+                        one_value = intersystems_iris.IRISList(raw_data).__str__()
+                except Exception:
+                    one_value = str(raw_data)
+            elif type(raw_data) == str:
+                try:
+                    if len(raw_data) == 0:
+                        one_value = "empty"
+                    else:
+                        one_value = intersystems_iris.IRISList(bytes(raw_data,"latin-1")).__str__()
+                except Exception:
+                    one_value = str(raw_data)
+            elif type(raw_data) == int:
+                one_value = raw_data
+            else:
+                one_value = str(raw_data)
+            display.append(one_value)
+        return "$lb(" + ', '.join([repr(item) for item in display]) + ")"
+
+    def getBuffer(self):
+        '''
+Returns a byte array that contains the $LIST format of all the data elements.
+
+getBuffer()
+
+Return Value
+------------
+Returns bytes.
+'''
+        list_writer = intersystems_iris._ListWriter._ListWriter(self._locale, self._is_unicode, self.compact_double)
+        for i in range(len(self._list_data)):
+            if self._list_data[i] == None:
+                list_writer._set_undefined()
+            elif type(self._list_data[i]) == intersystems_iris.IRISList:
+                buffer = self._list_data[i].getBuffer()
+                list_writer._set(buffer)
+            else:
+                list_writer._set(self._list_data[i], True)
+        return bytes(list_writer._get_buffer())

intersystems_iris/_IRISNative.py

@@ -0,0 +1,208 @@
+import sys
+import ssl
+import intersystems_iris._PythonGateway
+import intersystems_iris._IRIS
+import intersystems_iris._IRISConnection
+
+def connect(
+    *args, 
+    connectionstr = None, 
+    hostname = None, 
+    port = None, 
+     namespace = None, 
+    username = None, 
+    password = None, 
+    timeout = None, 
+    sharedmemory = None, 
+    logfile = None, 
+    sslcontext = None, 
+    autoCommit=None, 
+    isolationLevel=None, 
+    featureOptions=None, 
+    application_name=None,
+):
+    '''Return a new open connection to an IRIS instance.
+
+iris.connect(hostname,port,namespace,username,password,timeout,sharedmemory,logfile,sslcontext,autoCommit,isolationLevel,featureOptions)
+
+iris.connect(connectionstr,username,password,timeout,sharedmemory,logfile,sslcontext,autoCommit,isolationLevel,featureOptions)
+
+Parameters may be passed by position or keyword.
+
+Parameters
+----------
+hostname : Unicode string
+    IRIS instance URL
+port : int/long
+    IRIS superserver port number
+namespace : Unicode string
+    IRIS namespace
+username : Unicode string
+    IRIS user
+password : Unicode string
+    IRIS user password
+timeout : int/long, optional
+    maximum number of seconds to wait while attempting the connection. defaults to 10
+sharedmemory : bool, optional
+    set to True to attempt a shared memory connection when the hostname
+    is localhost or 127.0.0.1. set to false to force a connection over
+    TCP/IP. defaults to True.
+logfile : Unicode string, optional
+    client-side log file path. the maximum path length is 255 ASCII characters.
+connectionstr : Unicode string, optional
+    "hostname:port/namespace". use this instead of the hostname, port,
+    and namespace
+sslcontext : ssl.SSLContext object, optional
+    SSL context to be used for SSL connection
+    If None, a non-SSL connection will be used
+autoCommit : bool, optional
+    Indicates if IRIS auto-commit is enabled
+isolationLevel : int, optional
+    Indicates iris.dbapi isolation level
+    PLEASE NOTE: isolationLevel is currently deactivated. Any value passed in is ignored.
+featureOptions : int, optional
+    With a series of bit flags, it specifies whether certain features are enabled or disabled.
+
+Returns
+-------
+iris.IRISConnection
+    A new client connection to an IRIS server
+'''
+    has_TypeError = True
+    while True:
+        if connectionstr != None:
+            if len(args) > 0:
+                break
+            if hostname != None or port != None or namespace != None:
+                break
+            if username == None or password == None:
+                break
+            hostname = connectionstr.split(":")[0]
+            port = int(connectionstr.split(":")[1].split("/")[0])
+            namespace = connectionstr.split(":")[1].split("/")[1]
+            has_TypeError = False
+            break
+        if hostname != None:
+            if len(args) > 0:
+                break
+            if port == None or namespace == None or username == None or password == None:
+                break
+            has_TypeError = False
+            break
+        if len(args) <= 0:
+            break
+        if ":" in args[0]:
+            hostname = args[0].split(":")[0]
+            port = int(args[0].split(":")[1].split("/")[0])
+            namespace = args[0].split(":")[1].split("/")[1]
+            consumed = 1
+        else:
+            if len(args)<3:
+                break
+            hostname = args[0]
+            port = args[1]
+            namespace = args[2]
+            consumed = 3
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if username != None:
+            break
+        username = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if password != None:
+            break
+        password = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if timeout != None:
+            break
+        timeout = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if sharedmemory != None:
+            break
+        sharedmemory = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if logfile != None:
+            break
+        logfile = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if sslcontext != None:
+            break
+        sslcontext = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if autoCommit != None:
+            break
+        autoCommit = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if isolationLevel != None:
+            break
+        isolationLevel = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        if featureOptions != None:
+            break
+        featureOptions = args[consumed]
+        consumed += 1
+        if len(args) <= consumed:
+            has_TypeError = False
+            break
+        break
+    if has_TypeError or username == None or password == None:
+        raise TypeError("invalid arguments: hostname, port, namespace, username, password are required. timeout, sharedmemory, logfile are optional.")
+    timeout = 10 if timeout == None else timeout
+    sharedmemory = True if sharedmemory == None else sharedmemory
+    logfile = "" if logfile == None else logfile
+    autoCommit = True if autoCommit == None else bool(autoCommit)
+    isolationLevel = 1
+    featureOptions = intersystems_iris._IRISConnection.Feature.optionDefaultOptions if featureOptions == None else int(featureOptions)
+    connection = intersystems_iris.IRISConnection()
+    connection._disable_output_redirect = True
+    connection._connect(hostname, port, namespace, username, password, timeout, sharedmemory, logfile, sslcontext, autoCommit, isolationLevel, featureOptions, application_name)
+    return connection
+
+def createIRIS(connection):
+    '''Return a new iris.IRIS object that uses the given connection.
+
+iris.createIRIS(conn)
+
+Throw an exception if the connection is closed.
+
+Parameters
+----------
+conn : iris.IRISConnection
+    connection object to use
+
+Returns
+-------
+iris.IRIS
+    A new IRIS object that uses the given connection.
+'''
+    return intersystems_iris.IRIS(connection)
+
+def createConnection(*args, **kwargs):
+    '''This method has been deprecated. Please use connect() method instead.
+'''
+    return connect(*args, **kwargs)

intersystems_iris/_IRISOREF.py

@@ -0,0 +1,4 @@
+class _IRISOREF(object):
+
+    def __init__(self, oref):
+        self._oref = oref