-----------------------------------------------
lines 7-53 of file: at_cascade/csv/empty_str.py
-----------------------------------------------

{xrst_begin csv.empty_str}

Create A Table from a CSV File
##############################

Prototype
*********
{xrst_literal ,
   BEGIN_DEF, END_DEF
   BEGIN_RETURN, END_RETURN
}


table_in
********
is a ``list`` of ``dict``.
We use *n* to denote the length of the list which is
the number of lines in the file minus one.
For *i*, an ``int`` ,  between zero and *n* -1,
and each column name *key* , a string,
*table* [ *i* ][ *key* ] is the ``str`` in line *i* +2 and column *key*.

direction
*********
is a ``str`` that is equal to ``to_none`` or ``from_none``.

to_none
=======
If *direction* is to_none, then every empty string is converted to None.
In this case there cannot be any None field values in the input.

from_none
=========
If *direction* is from_none, then every None value is converted to
the empty string.
In this case there cannot be any empty string values in the input.

table_out
*********
Is a copy of *table_in* after doing the conversion.


Example
*******
:ref:`csv.table-name`

{xrst_end csv.empty_str}