pyDict
======
The function pyDict creates a virtual Python object
of type PythonInR_Dict.    

If no value is provided a virtual Python dict for an existing
Python object is created. If the value is NULL, an empty
virtual Python object for an empty dict is created.
If the value is a named vector or named list, a new Python
object based on the vector or list is created.    


Usage
-----
.. code-block:: R

    pyDict(key, value, regFinalizer = TRUE)

Arguments
---------
.. raw:: html

    <table style="width:100%">
      <tr>
        <td style="background-color:#FFFFE0;"><b>key</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">a character string giving the name of the Python object.</td>
      </tr>
      <tr>
        <td style="background-color:#FFFFE0;"><b>value</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">if a value is provided, a new Python dictionary is created based
    on the value. Therefore allowed values of value are named lists and
    names vectors.</td>
      </tr>
      <tr>
        <td style="background-color:#FFFFE0;"><b>regFinalizer</b> &nbsp;</td>
        <td style="background-color:#E0E6F8;">a logical indicating if a finalizer should be
    be registered, the default value is TRUE.</td>
      </tr>
    </table>

Examples
--------
.. code-block:: R

    if ( pyIsConnected() ){
    pyExec('myPyDict = {"a":1, "b":2, "c":3}')
    ## create a virtual Python dictionary for an existing dictionary
    myDict <- pyDict("myPyDict")
    myDict["a"]
    myDict["a"] <- "set the key"
    myDict
    ## allowed keys are
    myDict['string'] <- 1
    myDict[3L] <- "long"
    myDict[5] <- "float"
    myDict[c("t", "u", "p", "l", "e")] <- "tuple"
    myDict
    ## NOTE: Python does not make a difference between a float key 3 and a long key 3L
    myDict[3] <- "float"
    myDict
    ## create a new Python dict and virtual dict
    myNewDict <- pyDict('myNewDict', list(p=2, y=9, r=1))
    myNewDict
    }