From: Mike Bayer Date: Sun, 12 Feb 2012 23:30:42 +0000 (-0500) Subject: - add OrderingList class and other functions to sphinx documentation X-Git-Tag: rel_0_7_6~55 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d3ff10e035890c5a7ac86d57d85fd322113fb39a;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git - add OrderingList class and other functions to sphinx documentation [ticket:2391] --- diff --git a/doc/build/orm/extensions/orderinglist.rst b/doc/build/orm/extensions/orderinglist.rst index 940989ea10..19599a5782 100644 --- a/doc/build/orm/extensions/orderinglist.rst +++ b/doc/build/orm/extensions/orderinglist.rst @@ -7,3 +7,12 @@ API Reference ------------- .. autofunction:: ordering_list + +.. autofunction:: count_from_0 + +.. autofunction:: count_from_1 + +.. autofunction:: count_from_n_factory + +.. autoclass:: OrderingList + :members: diff --git a/lib/sqlalchemy/ext/orderinglist.py b/lib/sqlalchemy/ext/orderinglist.py index 9847861b0d..38957250b8 100644 --- a/lib/sqlalchemy/ext/orderinglist.py +++ b/lib/sqlalchemy/ext/orderinglist.py @@ -184,12 +184,11 @@ class OrderingList(list): This implementation relies on the list starting in the proper order, so be **sure** to put an ``order_by`` on your relationship. - ordering_attr + :param ordering_attr: Name of the attribute that stores the object's order in the relationship. - ordering_func - Optional. A function that maps the position in the Python list to a + :param ordering_func: Optional. A function that maps the position in the Python list to a value to store in the ``ordering_attr``. Values returned are usually (but need not be!) integers. @@ -202,7 +201,7 @@ class OrderingList(list): like stepped numbering, alphabetical and Fibonacci numbering, see the unit tests. - reorder_on_append + :param reorder_on_append: Default False. When appending an object with an existing (non-None) ordering value, that value will be left untouched unless ``reorder_on_append`` is true. This is an optimization to avoid a