pyList
======
The function pyList creates a virtual Python object
of type PythonInR_List.    

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


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

    pyList(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;">an optional value, allowed values are vectors, lists and NULL.</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('myPyList = [1, 2, 5, "Hello R!"]')
    # create a virtual Python list for an existing list
    myList <- pyList("myPyList")
    myList[0]
    myList[1] <- "changed"
    myList
    # create a new Python list and virtual list
    myNewList <- pyList('myNewList', list(1:3, 'Hello Python'))
    myNewList[1]
    myNewList$append(4L)
    ls(myNewList)
    ## NOTE: Indexing which can not be interpreted as correct R
    ##       syntax should be provided as a character string.
    myNewList['::2']
    }