[Sqlalchemy-commits] [5904] sqlalchemy/trunk/doc/build/reference/ext/serializer.rst: Corrected dup
Brought to you by:
zzzeek
Menu
▾
▴
[Sqlalchemy-commits] [5904] sqlalchemy/trunk/doc/build/reference/ext/serializer.rst: Corrected duplication of serializer docs.
|
From: <co...@sq...> - 2009-04-09 22:57:24
|
<!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><meta http-equiv="content-type" content="text/html; charset=utf-8" /><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, #header, #footer { 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; } #header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; } #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>[5904] sqlalchemy/trunk/doc/build/reference/ext/serializer.rst: Corrected duplication of serializer docs.</title> </head> <body> <div id="msg"> <dl> <dt>Revision</dt> <dd>5904</dd> <dt>Author</dt> <dd>empty</dd> <dt>Date</dt> <dd>2009-04-09 18:57:16 -0400 (Thu, 09 Apr 2009)</dd> </dl> <h3>Log Message</h3> <pre>Corrected duplication of serializer docs. Fixes #1375.</pre> <h3>Modified Paths</h3> <ul> <li><a href="#sqlalchemytrunkdocbuildreferenceextserializerrst">sqlalchemy/trunk/doc/build/reference/ext/serializer.rst</a></li> </ul> </div> <div id="patch"> <h3>Diff</h3> <a id="sqlalchemytrunkdocbuildreferenceextserializerrst"></a> <div class="modfile"><h4>Modified: sqlalchemy/trunk/doc/build/reference/ext/serializer.rst (5903 => 5904)</h4> <pre class="diff"><span> <span class="info">--- sqlalchemy/trunk/doc/build/reference/ext/serializer.rst 2009-04-09 21:47:49 UTC (rev 5903) +++ sqlalchemy/trunk/doc/build/reference/ext/serializer.rst 2009-04-09 22:57:16 UTC (rev 5904) </span><span class="lines">@@ -3,42 +3,6 @@ </span><span class="cx"> </span><span class="cx"> :author: Mike Bayer </span><span class="cx"> </span><del>-Serializer/Deserializer objects for usage with SQLAlchemy structures. - -Any SQLAlchemy structure, including Tables, Columns, expressions, mappers, -Query objects etc. can be serialized in a minimally-sized format, -and deserialized when given a Metadata and optional ScopedSession object -to use as context on the way out. - -Usage is nearly the same as that of the standard Python pickle module: - -.. sourcecode:: python+sql - - from sqlalchemy.ext.serializer import loads, dumps - metadata = MetaData(bind=some_engine) - Session = scoped_session(sessionmaker()) - - # ... define mappers - - query = Session.query(MyClass).filter(MyClass.somedata=='foo').order_by(MyClass.sortkey) - - # pickle the query - serialized = dumps(query) - - # unpickle. Pass in metadata + scoped_session - query2 = loads(serialized, metadata, Session) - - print query2.all() - -Similar restrictions as when using raw pickle apply; mapped classes must be -themselves be pickleable, meaning they are importable from a module-level -namespace. - -Note that instances of user-defined classes do not require this extension -in order to be pickled; these contain no references to engines, sessions -or expression constructs in the typical case and can be serialized directly. -This module is specifically for ORM and expression constructs. - </del><span class="cx"> .. automodule:: sqlalchemy.ext.serializer </span><span class="cx"> :members: </span><span class="cx"> :undoc-members: </span></span></pre> </div> </div> </body> </html> |