:orphan:

.. title:: Quart-DB documentation

Quart-DB
========

Quart-DB is a `Quart <https://gitlab.com/pgjones/quart>`_ extension
that provides managed connection(s) to postgresql or sqlite
database(s). Using Quart-DB you can,

 * connect to Postgresql or SQLite databases,
 * on top of everything Quart can do.

Quart-DB when connecting to PostgresQL databases uses `asyncpg
<https://github.com/MagicStack/asyncpg>`_ with `buildpg
<https://github.com/samuelcolvin/buildpg>`_ to allow for named bind
parameters.

Quart-DB uses `aiosqlite <https://github.com/omnilib/aiosqlite>`_ to
connect to SQLite databases.

If you are,

 * new to Quart-DB then try the :ref:`quickstart`,
 * new to Quart then try the `Quart documentation
   <https://pgjones.gitlab.io/quart/>`_,

Quart-DB is developed on `GitHub
<https://github.com/pgjones/quart-db>`_. If you come across an issue,
or have a feature request please open an `issue
<https://github.com/pgjones/quart-db/issues>`_.If you want to
contribute a fix or the feature-implementation please do (typo fixes
welcome), by proposing a `merge request
<https://github.com/pgjones/quart-db/merge_requests>`_. If you want to
ask for help try `on gitter <https://gitter.im/python-quart/lobby>`_.

Tutorials
---------

.. toctree::
   :maxdepth: 2

   tutorials/index.rst

How to guides
-------------

.. toctree::
   :maxdepth: 2

   how_to_guides/index.rst

Discussion
----------

.. toctree::
   :maxdepth: 2

   discussion/index.rst

References
----------

.. toctree::
   :maxdepth: 2

   reference/index.rst