Mercurial > sqlpython
changeset 476:4bd3145bff1b
begin design notes
| author | cat@eee |
|---|---|
| date | Thu, 11 Mar 2010 16:11:42 -0500 |
| parents | 8937b1476c42 |
| children | 920a45f244e8 |
| files | docs/source/design.rst docs/source/index.rst |
| diffstat | 2 files changed, 25 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/source/design.rst Thu Mar 11 16:11:42 2010 -0500 @@ -0,0 +1,24 @@ +============ +Design Notes +============ + +These design notes will hopefully not be necessary for routine use +of sqlpython; they describe implementation details intended to be +transparent to the user. However, if you get involved in developing +or debugging - or if something goes wrong (which it sometimes will) - +this information may be of interest. + +Pickled metadata +---------------- + +sqlpython relies on Gerald to collect metadata, and this collection +takes some time. When a database connection is made, a Gerald +connection is initiated; to provide preliminary metadata before that +Gerald collection is complete, sqlpython looks for a picklefile +storing metadata collected during an earlier session. When the fresh +metadata collection is complete, it is stored in pickled form for the +next session. + + + +