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

intersystems_iris/_IRISObject.py

@@ -0,0 +1,424 @@
+import decimal
+import weakref
+import intersystems_iris._IRIS
+
+class _IRISObject(object):
+    '''
+Class for Python proxy objects created on behalf of IRIS objects.
+'''
+
+    def __init__(self, connection, oref):
+        self._connection = connection
+        self._iris = intersystems_iris.IRIS(connection)
+        self._oref = oref
+        self._closed = False
+        self._connection._iris_object_proxy_map[oref] = weakref.ref(self)
+
+    def getOREF(self):
+        '''
+Returns the IRIS object OREF as a string.
+
+getOREF()
+
+Return Value
+------------
+Returns str.
+        '''
+        return self._oref
+
+    def get(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object.
+
+get(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns bytes, Decimal, float, int, or str.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(object, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getObject(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object.
+
+getObject(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns bytes, Decimal, float, int, or str.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(object, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getBoolean(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as a boolean.
+
+getBoolean(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns a bool.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(bool, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getBytes(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as bytes.
+
+getBytes(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns bytes.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(bytes, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getDecimal(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as a Decimal.
+
+getDecimal(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns a Decimal.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(decimal.Decimal, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getFloat(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as a float.
+
+getFloat(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns a float.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(float, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getInteger(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as an integer.
+
+getInteger(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns an int.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(int, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getString(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as a string.
+
+getString(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns a str.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(str, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def getIRISList(self, propertyName):
+        '''
+Fetches the value of a property of the IRISObject object as an IRISList.
+
+getIRISList(propertyName)
+
+Parameters
+----------
+propertyName : name of a property
+
+Return Value
+------------
+Returns None for IRIS empty string ($$$NULLOREF); otherwise, returns an IRISList.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(intersystems_iris.IRISList, intersystems_iris.IRIS.GET_PROPERTY, self, propertyName, None)
+
+    def set(self, propertyName, propertyValue):
+        '''
+Set the value of a property of the IRISObject object.
+
+set(propertyName, propertyValue)
+
+Parameters
+----------
+propertyName : name of a property
+propertyValue : new value of the property
+
+Return Value
+------------
+Returns None.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        self._iris._execute(None, intersystems_iris.IRIS.SET_PROPERTY, self, propertyName, None, propertyValue, honorByReference = False)
+        return
+
+    def invoke(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value.
+
+invoke(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns bytes, Decimal, float, int, or str.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(object, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeObject(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value.
+
+invokeObject(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns bytes, Decimal, float, int, or str.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(object, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeBoolean(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as a boolean.
+
+invokeBoolean(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns a bool.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(bool, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeBytes(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as bytes.
+
+invokeBytes(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns bytes.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(bytes, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeDecimal(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as a Decimal.
+
+invokeDecimal(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns a Decimal.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(decimal.Decimal, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeFloat(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as a float.
+
+invokeFloat(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns a float.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(float, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeInteger(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as an integer.
+
+invokeInteger(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns a int.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(int, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeString(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as a string.
+
+invokeString(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns a str.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(str, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeIRISList(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that returns a value as an IRISList.
+
+invokeIRISList(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None if IRIS empty string ($$$NULLOREF) is returned; otherwise, returns an IRISList.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        return self._iris._execute(intersystems_iris.IRISList, intersystems_iris.IRIS.VALUE_METHOD, self, methodName, args)
+
+    def invokeVoid(self, methodName, *args):
+        '''
+Invoke a method of the IRISObject object that does not return a value.
+
+invokeVoid(methodName, args...)
+
+Parameters
+----------
+methodName : name of a method.
+args... : zero or more arguments to be passed to the function, optional, variable length.
+          None is projected as empty string ($$$NULLOREF) in IRIS.
+          bool, bytes, Decimal, float, int, str, and IRISList are projected as literals in IRIS.
+          all other types are projected as proxy objects.
+
+Return Value
+------------
+Returns None.
+        '''
+        if ( self._closed ): raise RuntimeError("IRISObject is closed")
+        self._iris._execute(None, intersystems_iris.IRIS.VOID_METHOD, self, methodName, args)
+        return
+
+    def getConnection():
+        return self._connection
+
+    def close(self):
+        if not self._closed:
+            with self._connection._lock_closed_oref:
+                del self._connection._iris_object_proxy_map[self._oref]
+                self._connection._iris_object_proxy_closed.append(self._oref)
+                self._closed = True
+
+    def __del__(self):
+        if not self._closed:
+            self.close()

intersystems_iris/_IRISReference.py

@@ -0,0 +1,133 @@
+import decimal
+import intersystems_iris._IRISList
+import intersystems_iris._IRISObject
+
+class _IRISReference(object):
+    '''
+Used to call method/routine for pass-by-reference arguments
+
+iris.IRISReference(value, type)
+
+Parameters
+----------
+type : Python type used as a type hint for unmarshaling modified value of the argument. Supported types are  bool, bytes, bytearray, Decimal, float, int, str or IRISList. if none is specified, Python Gateway uses the type that matches the original IRIS type.
+'''
+
+    def __init__(self, value, type = None):
+        self._value = value
+        self._type = type
+        self._locale = "latin-1"
+        self._is_unicode = True
+
+    def setValue(self, value):
+        '''set the value of this IRISReference object.'''
+        self._value = value
+        return
+
+    def getValue(self):
+        '''Get the value of this IRISReference object.'''
+        return self.getObject()
+
+    def getObject(self):
+        '''Get the value of this IRISReference object.'''
+        if self._type == None:
+            return self._value
+        elif self._type == bool:
+            return self.getBoolean()
+        elif self._type == bytes:
+            return self.getBytes()
+        elif self._type == decimal.Decimal:
+            return self.getDecimal()
+        elif self._type == float:
+            return self.getFloat()
+        elif self._type == int:
+            return self.getInteger()
+        elif self._type == str:
+            return self.getString()
+        elif self._type == intersystems_iris.IRISList:
+            return self.getIRISList()
+        else:
+            return self._value
+
+    def getBoolean(self):
+        '''Get the value of this IRISReference object as a bool.'''
+        if self._value is None: return None
+        list = intersystems_iris.IRISList(None, self._locale, self._is_unicode)
+        if isinstance(self._value, intersystems_iris.IRISObject):
+            list.add(self._value._oref)
+        else:
+            list.add(self._value)
+        return list.getBoolean(1)
+        
+    def getBytes(self):
+        '''Get the value of this IRISReference object as bytes.'''
+        if self._value is None: return None
+        list = intersystems_iris.IRISList(None, self._locale, self._is_unicode)
+        if isinstance(self._value, intersystems_iris.IRISObject):
+            list.add(self._value._oref)
+        else:
+            list.add(self._value)
+        return list.getBytes(1)
+        
+    def getDecimal(self):
+        '''Get the value of this IRISReference object as a Decimal.'''
+        if self._value is None: return None
+        list = intersystems_iris.IRISList(None, self._locale, self._is_unicode)
+        if isinstance(self._value, intersystems_iris.IRISObject):
+            list.add(self._value._oref)
+        else:
+            list.add(self._value)
+        return list.getDecimal(1)
+        
+    def getFloat(self):
+        '''Get the value of this IRISReference object as a float.'''
+        if self._value is None: return None
+        list = intersystems_iris.IRISList(None, self._locale, self._is_unicode)
+        if isinstance(self._value, intersystems_iris.IRISObject):
+            list.add(self._value._oref)
+        else:
+            list.add(self._value)
+        return list.getFloat(1)
+        
+    def getInteger(self):
+        '''Get the value of this IRISReference object as a int.'''
+        if self._value is None: return None
+        list = intersystems_iris.IRISList(None, self._locale, self._is_unicode)
+        if isinstance(self._value, intersystems_iris.IRISObject):
+            list.add(self._value._oref)
+        else:
+            list.add(self._value)
+        return list.getInteger(1)
+        
+    def getString(self):
+        '''Get the value of this IRISReference object as a str.'''
+        if self._value is None: return None
+        list = intersystems_iris.IRISList(None, self._locale, self._is_unicode)
+        if isinstance(self._value, intersystems_iris.IRISObject):
+            list.add(self._value._oref)
+        else:
+            list.add(self._value)
+        return list.getString(1)
+        
+    def getIRISList(self):
+        '''Get the value of this IRISReference object as an IRISList.'''
+        if self._value is None: return None
+        return intersystems_iris.IRISList(self.getBytes(), self._locale, self._is_unicode)
+        
+    def get_value(self):
+        '''This method is deprecated. Use getObject() instead.'''
+        return self.getObject()
+
+    def set_value(self, value):
+        '''This method is deprecated. Use setValue() instead.'''
+        self.setValue(value)
+        return
+
+    def get_type(self):
+        '''This method is deprecated. Use an appropriate typed getter instead.'''
+        return self._type
+
+    def set_type(self, type):
+        '''This method is deprecated. Use an appropriate typed getter instead.'''
+        self._type = type
+        return

intersystems_iris/_InStream.py

@@ -0,0 +1,149 @@
+import hashlib
+from ._BufferReader import _BufferReader
+from ._LogFileStream import _LogFileStream
+from ._MessageHeader import _MessageHeader
+from ._Device import _Device
+
+
+class _InStream(object):
+
+    SEND_DATA = 0
+    BYTE_STREAM = 1
+    FETCH_DATA = 2
+    OOB_FETCH = 3
+    GATEWAY = 4
+    IRISNATIVE = 5
+
+    def __init__(self, connection):
+        self._connection = connection
+        self._device = connection._device
+        self._log_stream = connection._log_stream
+        self.wire = None
+
+    def _read_message_gateway(self, expected_message_id=-1):
+        is_for_gateway = self.__read_message_internal(expected_message_id, -1, _InStream.GATEWAY)
+        if expected_message_id != -1 and is_for_gateway:
+            raise Exception("Invalid message received")
+        if expected_message_id == -1 and not is_for_gateway:
+            raise Exception("Invalid message received")
+        code = self.wire.header._get_function_code()
+        return ((0xFF00 & code) >> 8) - 48
+
+    def _read_message_sysio(self, expected_message_id, allowedErrors):
+        while True:
+            is_for_gateway = self.__read_message_internal(expected_message_id, -1, _InStream.IRISNATIVE)
+            if is_for_gateway:
+                self._connection._get_gateway()._dispatch_reentrancy(self)
+                continue
+            code = self.wire.header._get_function_code() - 51712
+            if code != 0 and (allowedErrors == None or code not in allowedErrors):
+                error_message = self.wire._get()
+                raise RuntimeError(error_message)
+            return code
+
+    def _read_message_sql(self, expected_message_id, expected_statement_id=-1, type=0, allowedErrors=None):
+        while True:
+            is_for_gateway = self.__read_message_internal(expected_message_id, expected_statement_id, type)
+            if is_for_gateway:
+                self._connection._get_gateway()._dispatch_reentrancy(self)
+                continue
+            code = self.wire.header._get_function_code()
+            return code
+
+    def __read_message_internal(self, expected_message_id, expected_statement_id, call_type):
+        high_bit = 1
+        is_for_gateway = False
+        header = _MessageHeader()
+        final_buffer = bytearray()
+        while high_bit != 0:
+            self.__read_buffer(header.buffer, 0, _MessageHeader.HEADER_SIZE)
+            if self._log_stream is not None:
+                self._log_stream._dump_header(
+                    header.buffer, _LogFileStream.LOG_RECEIVED, self._connection)
+            if ((expected_message_id == -1 or expected_message_id) == header._get_message_id()) and (expected_statement_id == -1 or expected_statement_id == header._get_statement_id()):
+                is_for_gateway = False
+            elif self.__is_header_initizted_from_iris(header, call_type):
+                is_for_gateway = True
+            else:
+                self._connection.close()
+                raise Exception("Invalid Message Count: expected: " + str(expected_message_id) +
+                                " got: " + str(header._get_message_id()))
+
+            high_bit = (header._MessageHeader__get_4_byte_int_raw(8) & 0x80000000)
+
+            header_msg_length = header._get_message_length()
+            if header_msg_length == 0:
+                buffer = bytearray(0)
+            else:
+                buffer = bytearray(header_msg_length)
+                self.__read_buffer(buffer, 0, header_msg_length)
+                if self._log_stream is not None:
+                    self._log_stream._dump_message(buffer)
+
+            if not high_bit and len(final_buffer) == 0:
+                self.wire = _BufferReader(
+                    header, buffer, self._connection._connection_info._locale)
+                return is_for_gateway
+
+            final_buffer.extend(buffer)
+        self.wire = _BufferReader(
+            header, final_buffer, self._connection._connection_info._locale)
+        return is_for_gateway
+
+    def _check_sheader(self, hash, sock):
+        sheader = _MessageHeader()
+        try:
+            timeout = sock.gettimeout()
+            sock.settimeout(5)
+            self.__read_buffer(sheader.buffer, 0, _MessageHeader.HEADER_SIZE)
+            sock.settimeout(timeout)
+        except Exception as e:
+            return False
+        if self._log_stream is not None:
+            self._log_stream._dump_header(
+                sheader.buffer, _LogFileStream.LOG_RECEIVED, self._connection)
+        if sheader._get_message_length() != 0 or sheader._get_error() != 0:
+            return False
+        header_bytes = sheader.buffer[4:12]
+        header_bytes_str = b''
+        for i in range(len(header_bytes)):
+            header_bytes_str += bytes([header_bytes[i]])
+        in_hash = hashlib.sha256(header_bytes_str).hexdigest()
+        if len(hash) != len(in_hash):
+            return False
+        for i in range(len(hash)):
+            if hash[i] != in_hash[i]:
+                return False
+        return True
+
+    def __is_header_initizted_from_iris(self, header, call_type):
+        data_length = header._get_message_length()
+        message_id = header._get_count()
+        statement_id = header._get_statement_id()
+        # Gateway initiated message: message-ID is even. if type==GATEWAY, zero is allowed, otherwise, zero is not allowed.
+        if (call_type == _InStream.GATEWAY or message_id > 0) and message_id % 2 == 0:
+            return True
+        function_code = header._get_function_code()
+        # Special case for PassPhrase: type=GATEWAY, data_length==0 and function_code==0, middle 8 bytes are for SHA-256 hash code)
+        if call_type == _InStream.GATEWAY and data_length == 0 and function_code == 0:
+            return True
+        # Special case for %Ping (YQ) and %Disconnect (Y4) data_length==0 and message_id==0 and statement_id==0 and function_code=="YQ" or "Y4"
+        if data_length == 0 and message_id == 0 and statement_id == 0 and (function_code == 20825 or function_code == 13401):
+            return True
+        return False
+
+    def __read_buffer(self, buffer, offset, length):
+        if self._device is None:
+            raise RuntimeError("no longer connected to server")
+        data = self._device.recv(length)
+        buffer[offset:offset+len(data)] = data
+        if len(data) == length:
+            return
+        cb = len(data)
+        while cb < length:
+            data = self._device.recv(length-cb)
+            if len(data) == 0:
+                raise Exception("Server unexpectedly closing communication device")
+            buffer[offset+cb:offset+cb+len(data)] = data
+            cb += len(data)
+        return