veniasilente/veekun_pokedex
1
0
Fork 0
mirror of https://github.com/veekun/pokedex.git synced 2024-08-20 18:16:34 +00:00
Code Issues Projects Releases Wiki Activity

Note eagerloaded columns in the docs.

Browse source
This commit is contained in:
Andrew Ekstedt 2013-06-13 15:49:25 -07:00
parent 22bf78be41
commit f766f1c00f
1 changed files with 24 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

35
pokedex/doc/tabledoc.py
View file

@ -27,13 +27,21 @@ from pokedex.db import tables, markdown
# Make sure all the backrefs are in place # Make sure all the backrefs are in place
configure_mappers() configure_mappers()
column_to_cls = {} column_to_cls = {}
for cls in tables.mapped_classes: for cls in tables.mapped_classes:
for column in cls.__table__.c: for column in cls.__table__.c:
column_to_cls[column] = cls column_to_cls[column] = cls
def isrelationship(prop):
return isinstance(prop, InstrumentedAttribute) and isinstance(prop.property, RelationshipProperty)
def human_join(seq):
if len(seq) == 0:
return u'none'
elif len(seq) <= 2:
return u' and '.join(seq)
else:
return u', '.join(seq[:-1]) + u', and ' + seq[-1]
def column_type_str(column): def column_type_str(column):
"""Extract the type name from a SQLA column """Extract the type name from a SQLA column
@ -147,14 +155,21 @@ def generate_common(cls, remaining_attrs):
remaining_attrs.remove(c.name) remaining_attrs.remove(c.name)
if common_col_headers: if common_col_headers:
if len(common_col_headers) > 1:
common_col_headers[-1] = 'and ' + common_col_headers[-1]
if len(common_col_headers) > 2:
separator = u', '
else:
separator = u' '
yield u'Has' yield u'Has'
yield separator.join(common_col_headers) + '.' yield human_join(common_col_headers) + '.'
yield u''
def generate_eagerloads(cls, remaining_attrs):
eagerloads = []
for attr_name in remaining_attrs:
prop = getattr(cls, attr_name)
if isrelationship(prop) and prop.property.lazy == 'joined':
eagerloads.append('**' + attr_name + '**')
if eagerloads:
eagerloads.sort()
yield u'Eagerloads:'
yield human_join(eagerloads) + '.'
yield u'' yield u''
@with_header(u'Columns') @with_header(u'Columns')
@ -191,9 +206,6 @@ def generate_strings(cls, remaining_attrs):
@with_header(u'Relationships') @with_header(u'Relationships')
def generate_relationships(cls, remaining_attrs): def generate_relationships(cls, remaining_attrs):
def isrelationship(prop):
return isinstance(prop, InstrumentedAttribute) and isinstance(prop.property, RelationshipProperty)
for attr_name in sorted(remaining_attrs): for attr_name in sorted(remaining_attrs):
prop = getattr(cls, attr_name) prop = getattr(cls, attr_name)
if not isrelationship(prop): if not isrelationship(prop):
@ -301,6 +313,7 @@ class DexTable(PyClasslike):
generated_content.extend(generate_table_header(cls, remaining_attrs)) generated_content.extend(generate_table_header(cls, remaining_attrs))
generated_content.extend(generate_common(cls, remaining_attrs)) generated_content.extend(generate_common(cls, remaining_attrs))
generated_content.extend(generate_eagerloads(cls, remaining_attrs))
generated_content.extend(generate_columns(cls, remaining_attrs)) generated_content.extend(generate_columns(cls, remaining_attrs))
generated_content.extend(generate_strings(cls, remaining_attrs)) generated_content.extend(generate_strings(cls, remaining_attrs))
generated_content.extend(generate_relationships(cls, remaining_attrs)) generated_content.extend(generate_relationships(cls, remaining_attrs))