From: Mike Bayer Date: Sun, 20 Sep 2009 16:40:02 +0000 (+0000) Subject: a picture X-Git-Tag: rel_0_6beta1~278 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6d4186999f780c34e310b4fa3f6c2e34e223c443;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git a picture --- diff --git a/doc/build/intro.rst b/doc/build/intro.rst index 5e3b945591..7e02074074 100644 --- a/doc/build/intro.rst +++ b/doc/build/intro.rst @@ -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 index 0000000000..5fdd20557c Binary files /dev/null and b/doc/build/sqla_arch_small.jpg differ diff --git a/doc/build/static/docs.css b/doc/build/static/docs.css index 810c51410f..dbc5bae62c 100644 --- a/doc/build/static/docs.css +++ b/doc/build/static/docs.css @@ -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;}