]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
a picture
authorMike Bayer <mike_mp@zzzcomputing.com>
Sun, 20 Sep 2009 16:40:02 +0000 (16:40 +0000)
committerMike Bayer <mike_mp@zzzcomputing.com>
Sun, 20 Sep 2009 16:40:02 +0000 (16:40 +0000)
doc/build/intro.rst
doc/build/sqla_arch_small.jpg [new file with mode: 0644]
doc/build/static/docs.css

index 5e3b945591b420ded7cfaf14f8c74cea66718709..7e020740744c98c952ebc23d76c92a4049ed4a1e 100644 (file)
@@ -8,22 +8,11 @@ Overview
 ========
 
 
-The SQLAlchemy SQL Toolkit and Object Relational Mapper is a comprehensive set of tools for working with databases and Python.  It has several distinct areas of functionality which can be used individually or combined together.  Its major API components, all public-facing, are illustrated below::
-
-               +-----------------------------------------------------------+
-               |             Object Relational Mapper (ORM)                |
-               +-----------------------------------------------------------+
-               +---------+ +------------------------------------+ +--------+
-               |         | |       SQL Expression Language      | |        |
-               |         | +------------------------------------+ |        |
-               |         +-----------------------+ +--------------+        |
-               |        Dialect/Execution        | |    Schema Management  |
-               +---------------------------------+ +-----------------------+
-               +----------------------+ +----------------------------------+
-               |  Connection Pooling  | |              Types               |
-               +----------------------+ +----------------------------------+
-
-Above, the two most significant front-facing portions of SQLAlchemy are the **Object Relational Mapper** and the **SQL Expression Language**.  These are two separate toolkits, one building off the other.  SQL Expressions can be used independently of the ORM.  When using the ORM, the SQL Expression language is used to establish object-relational configurations as well as in querying.
+The SQLAlchemy SQL Toolkit and Object Relational Mapper is a comprehensive set of tools for working with databases and Python.  It has several distinct areas of functionality which can be used individually or combined together.  Its major components are illustrated below.  The arrows represent the general dependencies of components:
+
+.. image:: sqla_arch_small.jpg
+
+Above, the two most significant front-facing portions of SQLAlchemy are the **Object Relational Mapper** and the **SQL Expression Language**.  SQL Expressions can be used independently of the ORM.  When using the ORM, the SQL Expression language remains part of the public facing API as it is used within object-relational configurations and queries.
 
 Tutorials
 =========
diff --git a/doc/build/sqla_arch_small.jpg b/doc/build/sqla_arch_small.jpg
new file mode 100644 (file)
index 0000000..5fdd205
Binary files /dev/null and b/doc/build/sqla_arch_small.jpg differ
index 810c51410fdfc95454509a9aaa548fdf035536e6..dbc5bae62c616c6ac4ebe1e85710c8584a3d1c4a 100644 (file)
@@ -19,6 +19,11 @@ p {
        margin-bottom:10px;
 }
 
+img {
+    display:block;
+    margin: 0 auto;
+}
+
 a {font-weight:normal; text-decoration:underline;}
 a:link {color:#0000FF;}
 a:visited {color:#0000FF;}