diff --git a/docs/contents.rst.inc b/docs/contents.rst.inc index 4c6fc7b..515c0a4 100644 --- a/docs/contents.rst.inc +++ b/docs/contents.rst.inc @@ -68,6 +68,7 @@ different scenarios. scenarios/cli scenarios/gui scenarios/web + scenarios/db scenarios/admin scenarios/ci scenarios/speed diff --git a/docs/scenarios/db.rst b/docs/scenarios/db.rst new file mode 100644 index 0000000..ad04d04 --- /dev/null +++ b/docs/scenarios/db.rst @@ -0,0 +1,24 @@ +Databases +========= + +DB-API +------ + +The Python Database API (DB-API) defines a standard interface for Python +database access modules. It's documented in `PEP 249 `_. +Nearly all Python database modules such as `sqlite3`, `psycopg` and +`mysql-python` conform to this interface. + + + +SQLAlchemy +---------- + +`SQLAlchemy `_ is a commonly used database toolkit. Unlike many database libraries +it not only provides an ORM layer but also a generalized API for writing +database-agnostic code without SQL. + +:: + + pip install sqlalchemy +