***************************************
:mod:`commsocket` -- commsocket module
***************************************

.. module:: commsocket
   :synopsis: commsocket module

This module a socket like class for allowing an @TXMODE function to handle message delivery

Functions
---------

.. function:: commsocket.commsocket()

   This will construct an unconnected CommSocket. You would normally never do this in your Python script as 
   a connected commsocket object is automatically passed in to a @TXMODE function.

class commsocket
================

Methods
-------

    .. method:: commsocket.send(bytes)

       Send data to the commsocket. 

    .. method:: commsocket.recv(bufsize)

       Receive data from the commsocket. The return value is a bytes object representing the data
       received. The maximum amount of data to be received at once is specified by bufsize.

    .. method:: commsocket.settimeout(value)

       Set a timeout on a commsocket operation. The value argument can be a nonnegative floating
       point number expressing seconds, or None. If a non-zero value is given, subsequent commsocket operations
       will raise a timeout exception if the timeout period value has elapsed before the operation has
       completed. If zero is given, the commsocket is put in non-blocking mode. If None is given, the commsocket
       is put in blocking mode.