Examples
********

These examples illustrate the ways in 
which OpenAPI programming in Python differs from using C. They are
presented in no particular order.

For comprehensive instruction in the workings of the OpenAPI refer to
the `OpenAPI User Guide <https://docs.actian.com/actianingres/12.0/OpenAPIUser/OpenAPIUser_Title.htm#>`_.


Most of the examples here are only illustrative fragments of code, not
complete applications. See :ref:`hello-pyngres` for an example of a 
complete but trivial application that can be used as a starting point
for experimentation.

..  NOTE::

    Basic knowledge of ``asyncio`` is assumed for some of the examples.

..  INCLUDE:: brownlee-tip.rst


..  toctree::
    :caption: Contents:
    :maxdepth: 2

    example-connect-sync.rst
    example-connect-async.rst
    example-data-buffer.rst
    example-varchar-handling.rst
    example-date-handling.rst
    example-exec-sql.rst
    example-exec-parm-sql.rst
    example-exec-select.rst
    example-error-handling.rst
    example-callback.rst
    example-tracing.rst
    example-dbevents.rst