-----------------------------------------------
lines 6-41 of file: at_cascade/table_name2id.py
-----------------------------------------------

{xrst_begin table_name2id}
{xrst_spell
  tbl
}

Map a Table Row Name to The Row Index
#####################################

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

table
*****
This is a ``list`` of ``dict`` containing the table.
The primary key is not included because it is the row index.

tbl_name
********
This is a ``str`` containing the name of the table.
This table must have a column named *table_name*\ ``_name``.

row_name
********
This is the value we are searching for in the
*table_name*\ ``_name`` column.

row_id
******
This is the index of the row in the table where
*row_name* occurs. An assert will occur if there is no such row.

{xrst_end table_name2id}