annotate docs/source/design.rst @ 482:8cf08822207b

beginning move to Gerald 0.4
author catherine.devlin@gmail.com
date Thu, 05 Aug 2010 07:06:48 -0400
parents 4bd3145bff1b
children
rev   line source
476
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
1 ============
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
2 Design Notes
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
3 ============
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
4
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
5 These design notes will hopefully not be necessary for routine use
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
6 of sqlpython; they describe implementation details intended to be
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
7 transparent to the user. However, if you get involved in developing
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
8 or debugging - or if something goes wrong (which it sometimes will) -
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
9 this information may be of interest.
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
10
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
11 Pickled metadata
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
12 ----------------
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
13
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
14 sqlpython relies on Gerald to collect metadata, and this collection
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
15 takes some time. When a database connection is made, a Gerald
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
16 connection is initiated; to provide preliminary metadata before that
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
17 Gerald collection is complete, sqlpython looks for a picklefile
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
18 storing metadata collected during an earlier session. When the fresh
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
19 metadata collection is complete, it is stored in pickled form for the
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
20 next session.
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
21
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
22
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
23
4bd3145bff1b begin design notes
cat@eee
parents:
diff changeset
24