--------------------------------------------
lines 7-60 of file: python/dismod_at/main.py
--------------------------------------------

# {xrst_begin python_main}
# {xrst_comment_ch #}
#
# The Python Main Program
# #######################
#
# Syntax
# ******
#
# dismod-at
# =========
# |tab| ``dismod-at``  database command ...
#
# dismodat.py
# ===========
# The following syntax does not work on windows and was
# Deprecated on 2025-05-06.
#
# |tab| ``dismodat.py`` database command ...
#
# command
# *******
# The commands that use the python main program ``dismod-at``
# (as apposed to the C++ main program ``dismod_at`` ) are:
#
# .. csv-table::
#     :widths: auto
#     :header: *command* , documentation
#
#     ``db2csv``   , :ref:`db2csv_command-title`
#     ``perturb``  , :ref:`perturb_command-title`
#     ``plot_rate_fit`` , :ref:`plot_rate_fit-title`
#     ``plot_data_fit`` , :ref:`plot_data_fit-title`
#
# Log Table
# *********
#
# Start
# =====
# This program adds a
# :ref:`log_table@message_type@command`
# log entry with at the start of the command.
# The :ref:`log_table@message` for this entry is
#
#     ``begin`` *command*  ...
#
# End
# ===
# If the command completes, a log entry with the following message is added
# to the log:
#
#     ``end`` *command*
#
# {xrst_end python_main}