File tree Expand file tree Collapse file tree 2 files changed +8
-6
lines changed
Expand file tree Collapse file tree 2 files changed +8
-6
lines changed Original file line number Diff line number Diff line change @@ -51,15 +51,16 @@ class AutoPopulate:
5151 @property
5252 def key_source (self ):
5353 """
54- :return: the relation whose primary key values are passed, sequentially, to the
55- .make method when .populate() is called.
56- The default value is the join of the tables references by the primary key.
57- Users may override to change the granularity or the scope of populate() calls.
54+ :return: the query expression that yields primary key values to be passed,
55+ sequentially, to the ``make`` method when populate() is called.
56+ The default value is the join of the parent tables references from the primary key.
57+ Subclasses may override they key_source to change the scope or the granularity
58+ of the make calls.
5859 """
5960 def _rename_attributes (table , props ):
6061 return (table .proj (
6162 ** {attr : ref for attr , ref in props ['attr_map' ].items () if attr != ref })
62- if props ['aliased' ] else table )
63+ if props ['aliased' ] else table . proj () )
6364
6465 if self ._key_source is None :
6566 parents = self .target .parents (primary = True , as_objects = True , foreign_key_info = True )
Original file line number Diff line number Diff line change @@ -55,7 +55,8 @@ class Table(QueryExpression):
5555 _table_name = None # must be defined in subclass
5656 _log_ = None # placeholder for the Log table object
5757
58- # These properties must be set by the schema decorator (schemas.py) at class level or by FreeTable at instance level
58+ # These properties must be set by the schema decorator (schemas.py) at class level
59+ # or by FreeTable at instance level
5960 database = None
6061 declaration_context = None
6162
You can’t perform that action at this time.
0 commit comments