51
51
<div class="versionheader">
52
Release: <span class="versionnum">0.7.2</span> | Release Date: July 31, 2011
52
Release: <span class="versionnum">0.7.3</span> | Release Date: October 16, 2011
54
54
<div class="clearboth"></div>
96
96
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#introduction">Introduction</a></li>
97
97
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#version-check">Version Check</a></li>
98
98
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#connecting">Connecting</a></li>
99
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#define-and-create-a-table">Define and Create a Table</a></li>
100
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#define-a-python-class-to-be-mapped">Define a Python Class to be Mapped</a></li>
101
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#setting-up-the-mapping">Setting up the Mapping</a></li>
102
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#creating-table-class-and-mapper-all-at-once-declaratively">Creating Table, Class and Mapper All at Once Declaratively</a></li>
99
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#declare-a-mapping">Declare a Mapping</a></li>
100
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#create-an-instance-of-the-mapped-class">Create an Instance of the Mapped Class</a></li>
103
101
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#creating-a-session">Creating a Session</a></li>
104
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#adding-new-objects">Adding new Objects</a></li>
102
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#adding-new-objects">Adding New Objects</a></li>
105
103
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#rolling-back">Rolling Back</a></li>
106
104
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#querying">Querying</a><ul>
107
105
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#common-filter-operators">Common Filter Operators</a></li>
113
111
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#building-a-relationship">Building a Relationship</a></li>
114
112
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#working-with-related-objects">Working with Related Objects</a></li>
115
113
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#querying-with-joins">Querying with Joins</a><ul>
116
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#using-join-to-eagerly-load-collections-attributes">Using join() to Eagerly Load Collections/Attributes</a></li>
117
114
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#using-aliases">Using Aliases</a></li>
118
115
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#using-subqueries">Using Subqueries</a></li>
119
116
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#selecting-entities-from-subqueries">Selecting Entities from Subqueries</a></li>
121
118
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#common-relationship-operators">Common Relationship Operators</a></li>
121
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#eager-loading">Eager Loading</a><ul>
122
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#subquery-load">Subquery Load</a></li>
123
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#joined-load">Joined Load</a></li>
124
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#explicit-join-eagerload">Explicit Join + Eagerload</a></li>
124
127
<li class="toctree-l2"><a class="reference internal" href="tutorial.html#deleting">Deleting</a><ul>
125
128
<li class="toctree-l3"><a class="reference internal" href="tutorial.html#configuring-delete-delete-orphan-cascade">Configuring delete/delete-orphan Cascade</a></li>
132
135
<li class="toctree-l1"><a class="reference internal" href="mapper_config.html">Mapper Configuration</a><ul>
136
<li class="toctree-l2"><a class="reference internal" href="mapper_config.html#classical-mappings">Classical Mappings</a></li>
133
137
<li class="toctree-l2"><a class="reference internal" href="mapper_config.html#customizing-column-properties">Customizing Column Properties</a><ul>
134
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#mapping-a-subset-of-table-columns">Mapping a Subset of Table Columns</a></li>
135
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#attribute-names-for-mapped-columns">Attribute Names for Mapped Columns</a></li>
138
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#naming-columns-distinctly-from-attribute-names">Naming Columns Distinctly from Attribute Names</a></li>
136
139
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#mapping-multiple-columns-to-a-single-attribute">Mapping Multiple Columns to a Single Attribute</a></li>
137
140
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#using-column-property-for-column-level-options">Using column_property for column level options</a></li>
141
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#mapping-a-subset-of-table-columns">Mapping a Subset of Table Columns</a></li>
140
144
<li class="toctree-l2"><a class="reference internal" href="mapper_config.html#deferred-column-loading">Deferred Column Loading</a><ul>
141
145
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#column-deferral-api">Column Deferral API</a></li>
144
<li class="toctree-l2"><a class="reference internal" href="mapper_config.html#sql-expressions-as-mapped-attributes">SQL Expressions as Mapped Attributes</a></li>
148
<li class="toctree-l2"><a class="reference internal" href="mapper_config.html#sql-expressions-as-mapped-attributes">SQL Expressions as Mapped Attributes</a><ul>
149
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#alternatives-to-column-property">Alternatives to column_property()</a></li>
145
152
<li class="toctree-l2"><a class="reference internal" href="mapper_config.html#changing-attribute-behavior">Changing Attribute Behavior</a><ul>
146
153
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#simple-validators">Simple Validators</a></li>
147
154
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#using-descriptors">Using Descriptors</a></li>
148
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#id1">Synonyms</a></li>
155
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#id2">Synonyms</a></li>
149
156
<li class="toctree-l3"><a class="reference internal" href="mapper_config.html#custom-comparators">Custom Comparators</a></li>
174
181
<li class="toctree-l2"><a class="reference internal" href="relationships.html#adjacency-list-relationships">Adjacency List Relationships</a><ul>
175
182
<li class="toctree-l3"><a class="reference internal" href="relationships.html#self-referential-query-strategies">Self-Referential Query Strategies</a></li>
176
<li class="toctree-l3"><a class="reference internal" href="relationships.html#configuring-eager-loading">Configuring Eager Loading</a></li>
183
<li class="toctree-l3"><a class="reference internal" href="relationships.html#configuring-self-referential-eager-loading">Configuring Self-Referential Eager Loading</a></li>
179
<li class="toctree-l2"><a class="reference internal" href="relationships.html#linking-relationships-with-backref">Linking relationships with Backref</a><ul>
186
<li class="toctree-l2"><a class="reference internal" href="relationships.html#linking-relationships-with-backref">Linking Relationships with Backref</a><ul>
180
187
<li class="toctree-l3"><a class="reference internal" href="relationships.html#backref-arguments">Backref Arguments</a></li>
181
188
<li class="toctree-l3"><a class="reference internal" href="relationships.html#one-way-backrefs">One Way Backrefs</a></li>
203
210
<li class="toctree-l2"><a class="reference internal" href="collections.html#customizing-collection-access">Customizing Collection Access</a><ul>
211
<li class="toctree-l3"><a class="reference internal" href="collections.html#dictionary-collections">Dictionary Collections</a></li>
204
212
<li class="toctree-l3"><a class="reference internal" href="collections.html#custom-collection-implementations">Custom Collection Implementations</a></li>
205
<li class="toctree-l3"><a class="reference internal" href="collections.html#annotating-custom-collections-via-decorators">Annotating Custom Collections via Decorators</a></li>
206
<li class="toctree-l3"><a class="reference internal" href="collections.html#dictionary-based-collections">Dictionary-Based Collections</a></li>
207
<li class="toctree-l3"><a class="reference internal" href="collections.html#instrumentation-and-custom-types">Instrumentation and Custom Types</a></li>
208
213
<li class="toctree-l3"><a class="reference internal" href="collections.html#collections-api">Collections API</a></li>
220
225
<li class="toctree-l2"><a class="reference internal" href="inheritance.html#single-table-inheritance">Single Table Inheritance</a></li>
221
<li class="toctree-l2"><a class="reference internal" href="inheritance.html#concrete-table-inheritance">Concrete Table Inheritance</a></li>
226
<li class="toctree-l2"><a class="reference internal" href="inheritance.html#concrete-table-inheritance">Concrete Table Inheritance</a><ul>
227
<li class="toctree-l3"><a class="reference internal" href="inheritance.html#concrete-inheritance-with-declarative">Concrete Inheritance with Declarative</a></li>
222
230
<li class="toctree-l2"><a class="reference internal" href="inheritance.html#using-relationships-with-inheritance">Using Relationships with Inheritance</a><ul>
223
231
<li class="toctree-l3"><a class="reference internal" href="inheritance.html#relationships-with-concrete-inheritance">Relationships with Concrete Inheritance</a></li>
229
237
<li class="toctree-l1"><a class="reference internal" href="session.html">Using the Session</a><ul>
230
238
<li class="toctree-l2"><a class="reference internal" href="session.html#what-does-the-session-do">What does the Session do ?</a></li>
231
239
<li class="toctree-l2"><a class="reference internal" href="session.html#getting-a-session">Getting a Session</a><ul>
232
<li class="toctree-l3"><a class="reference internal" href="session.html#adding-additional-configuration-to-an-existing-sessionmaker">Adding additional configuration to an Existing sessionmaker()</a></li>
240
<li class="toctree-l3"><a class="reference internal" href="session.html#adding-additional-configuration-to-an-existing-sessionmaker">Adding Additional Configuration to an Existing sessionmaker()</a></li>
233
241
<li class="toctree-l3"><a class="reference internal" href="session.html#creating-ad-hoc-session-objects-with-alternate-arguments">Creating Ad-Hoc Session Objects with Alternate Arguments</a></li>
236
244
<li class="toctree-l2"><a class="reference internal" href="session.html#id1">Using the Session</a><ul>
237
245
<li class="toctree-l3"><a class="reference internal" href="session.html#quickie-intro-to-object-states">Quickie Intro to Object States</a></li>
238
<li class="toctree-l3"><a class="reference internal" href="session.html#frequently-asked-questions">Frequently Asked Questions</a></li>
246
<li class="toctree-l3"><a class="reference internal" href="session.html#session-frequently-asked-questions">Session Frequently Asked Questions</a></li>
239
247
<li class="toctree-l3"><a class="reference internal" href="session.html#querying">Querying</a></li>
240
248
<li class="toctree-l3"><a class="reference internal" href="session.html#adding-new-or-existing-items">Adding New or Existing Items</a></li>
241
249
<li class="toctree-l3"><a class="reference internal" href="session.html#merging">Merging</a></li>
303
311
<li class="toctree-l1"><a class="reference internal" href="extensions/index.html">ORM Extensions</a><ul>
304
312
<li class="toctree-l2"><a class="reference internal" href="extensions/associationproxy.html">Association Proxy</a><ul>
305
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#simplifying-relationships">Simplifying Relationships</a></li>
306
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#simplifying-association-object-relationships">Simplifying Association Object Relationships</a></li>
307
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#building-complex-views">Building Complex Views</a></li>
308
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#api">API</a></li>
313
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#simplifying-scalar-collections">Simplifying Scalar Collections</a></li>
314
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#creation-of-new-values">Creation of New Values</a></li>
315
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#simplifying-association-objects">Simplifying Association Objects</a></li>
316
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#proxying-to-dictionary-based-collections">Proxying to Dictionary Based Collections</a></li>
317
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#composite-association-proxies">Composite Association Proxies</a></li>
318
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#querying-with-association-proxies">Querying with Association Proxies</a></li>
319
<li class="toctree-l3"><a class="reference internal" href="extensions/associationproxy.html#api-documentation">API Documentation</a></li>
311
322
<li class="toctree-l2"><a class="reference internal" href="extensions/declarative.html">Declarative</a><ul>
319
330
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#using-a-hybrid-approach-with-table">Using a Hybrid Approach with __table__</a></li>
320
331
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#mapper-configuration">Mapper Configuration</a></li>
321
332
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#inheritance-configuration">Inheritance Configuration</a></li>
322
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#mixin-classes">Mixin Classes</a></li>
333
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#mixin-and-custom-base-classes">Mixin and Custom Base Classes</a></li>
334
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#special-directives">Special Directives</a></li>
323
335
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#class-constructor">Class Constructor</a></li>
324
336
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#sessions">Sessions</a></li>
325
337
<li class="toctree-l3"><a class="reference internal" href="extensions/declarative.html#api-reference">API Reference</a></li>