[Sqlalchemy-commits] [1157] sqlalchemy/trunk/doc/build/content/tutorial.txt: edits...
Brought to you by:
zzzeek
Menu
▾
▴
[Sqlalchemy-commits] [1157] sqlalchemy/trunk/doc/build/content/tutorial.txt: edits...
|
From: <co...@sq...> - 2006-03-17 06:20:34
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head><style type="text/css"><!-- #msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; } #msg dt { float: left; width: 6em; font-weight: bold; } #msg dt:after { content:':';} #msg dl, #msg dt, #msg ul, #msg li { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; } #msg dl a { font-weight: bold} #msg dl a:link { color:#fc3; } #msg dl a:active { color:#ff0; } #msg dl a:visited { color:#cc6; } h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; } #msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; } #msg ul, pre { overflow: auto; } #patch { width: 100%; } #patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;} #patch .propset h4, #patch .binary h4 {margin:0;} #patch pre {padding:0;line-height:1.2em;margin:0;} #patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;} #patch .propset .diff, #patch .binary .diff {padding:10px 0;} #patch span {display:block;padding:0 10px;} #patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;} #patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;} #patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;} #patch .lines, .info {color:#888;background:#fff;} --></style> <title>[1157] sqlalchemy/trunk/doc/build/content/tutorial.txt: edits...</title> </head> <body> <div id="msg"> <dl> <dt>Revision</dt> <dd>1157</dd> <dt>Author</dt> <dd>zzzeek</dd> <dt>Date</dt> <dd>2006-03-17 00:20:24 -0600 (Fri, 17 Mar 2006)</dd> </dl> <h3>Log Message</h3> <pre>edits...</pre> <h3>Modified Paths</h3> <ul> <li><a href="#sqlalchemytrunkdocbuildcontenttutorialtxt">sqlalchemy/trunk/doc/build/content/tutorial.txt</a></li> </ul> </div> <div id="patch"> <h3>Diff</h3> <a id="sqlalchemytrunkdocbuildcontenttutorialtxt"></a> <div class="modfile"><h4>Modified: sqlalchemy/trunk/doc/build/content/tutorial.txt (1156 => 1157)</h4> <pre class="diff"><span> <span class="info">--- sqlalchemy/trunk/doc/build/content/tutorial.txt 2006-03-17 06:11:34 UTC (rev 1156) +++ sqlalchemy/trunk/doc/build/content/tutorial.txt 2006-03-17 06:20:24 UTC (rev 1157) </span><span class="lines">@@ -1,6 +1,6 @@ </span><span class="cx"> Tutorial </span><span class="cx"> ======== </span><del>-This tutorial is a "quick start" guide to SQLAlchemy. You may wish to skip it and dive into the [main manual][manual] which is more reference-oriented. </del><ins>+This tutorial provides a relatively simple walking tour through the basic concepts of SQLAlchemy. You may wish to skip it and dive into the [main manual][manual] which is more reference-oriented. </ins><span class="cx"> </span><span class="cx"> [manual]: rel:howtoread </span><span class="cx"> </span><span class="lines">@@ -19,9 +19,9 @@ </span><span class="cx"> [install setuptools]: http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions </span><span class="cx"> [cheese]: http://cheeseshop.python.org/pypi </span><span class="cx"> </span><del>-### Installing A Database Manager {@name=dbms} </del><ins>+### Installing a Database API {@name=dbms} </ins><span class="cx"> </span><del>- SQLAlchemy is designed to operate with a [DBAPI][DBAPI] implementation built for a particular database, and includes support for the most popular databases. If you have one of the [supported database managers][supported dbms], you can proceed to the following section. Otherwise [SQLite][] is an easy to use database to get started with, requiring very little configuration. </del><ins>+SQLAlchemy is designed to operate with a [DBAPI][DBAPI] implementation built for a particular database, and includes support for the most popular databases. If you have one of the [supported DBAPI implementations][supported dbms], you can proceed to the following section. Otherwise [SQLite][] is an easy-to-use database to get started with, which works with plain files or in-memory databases. </ins><span class="cx"> </span><span class="cx"> [DBAPI]: http://www.python.org/doc/peps/pep-0249/ </span><span class="cx"> </span><span class="lines">@@ -42,12 +42,12 @@ </span><span class="cx"> </span><span class="cx"> ### Connecting to the Database </span><span class="cx"> </span><del>-First, you need to connect to the database you want to work with: </del><ins>+The first thing needed is a handle to the desired database, represented by a `SQLEngine` object. This object handles the business of managing connections and dealing with the specifics of a particular database. Below, we will make a SQLite connection to a file-based database called "tutorial.db". </ins><span class="cx"> </span><span class="cx"> >>> from sqlalchemy import * </span><span class="cx"> >>> db = create_engine('sqlite://filename=tutorial.db') </span><span class="cx"> </span><del>-Documentation on creating engines is available in [dbengine](rel:dbengine). </del><ins>+For full information on creating database engines, including those for SQLite and others, see [dbengine](rel:dbengine). </ins><span class="cx"> </span><span class="cx"> ### Creating a Table {@name=table} </span><span class="cx"> </span></span></pre> </div> </div> </body> </html> |
