From 66760936db8278a23294078b1750c91ba03bf9bf Mon Sep 17 00:00:00 2001
From: Kamil Kisiel <kamil@kamilkisiel.net>
Date: Fri, 23 Dec 2011 15:18:34 -0800
Subject: [PATCH] Added a scenario for working with databases

---
 docs/contents.rst.inc |  1 +
 docs/scenarios/db.rst | 24 ++++++++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 docs/scenarios/db.rst

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 <http://www.python.org/dev/peps/pep-0249/>`_.
+Nearly all Python database modules such as `sqlite3`, `psycopg` and
+`mysql-python` conform to this interface.
+
+
+
+SQLAlchemy
+----------
+
+`SQLAlchemy <http://www.sqlalchemy.org/>`_ 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
+