summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLorin Hochstein <lorin@isi.edu>2011-11-02 11:34:28 -0400
committerLorin Hochstein <lorin@isi.edu>2011-11-02 11:34:28 -0400
commit923c3c520609b70e234731b401762bda2623e951 (patch)
tree9c4aadf3d4d3ed50ea5e4ac983e43cd0e17e1ffb
parentd3e0cfcc7f7bc24b4bd551f5b5c0c952f2fd2f3f (diff)
downloadnova-923c3c520609b70e234731b401762bda2623e951.tar.gz
nova-923c3c520609b70e234731b401762bda2623e951.tar.xz
nova-923c3c520609b70e234731b401762bda2623e951.zip
Added some documentation to db.api module docstring.
See https://lists.launchpad.net/openstack/msg05222.html for info about return values of db layer. Change-Id: Id7cc7c783d40a9f81ca0e592691635ee15563e0b
-rw-r--r--nova/db/api.py9
1 files changed, 9 insertions, 0 deletions
diff --git a/nova/db/api.py b/nova/db/api.py
index 7af81a1a2..a7668e82a 100644
--- a/nova/db/api.py
+++ b/nova/db/api.py
@@ -20,6 +20,15 @@
The underlying driver is loaded as a :class:`LazyPluggable`.
+Functions in this module are imported into the nova.db namespace. Call these
+functions from nova.db namespace, not the nova.db.api namespace.
+
+All functions in this module return objects that implement a dictionary-like
+interface. Currently, many of these objects are sqlalchemy objects that
+implement a dictionary interface. However, a future goal is to have all of
+these objects be simple dictionaries.
+
+
**Related Flags**
:db_backend: string to lookup in the list of LazyPluggable backends.