From d3ff10e035890c5a7ac86d57d85fd322113fb39a Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Sun, 12 Feb 2012 18:30:42 -0500 Subject: [PATCH] - add OrderingList class and other functions to sphinx documentation [ticket:2391] --- doc/build/orm/extensions/orderinglist.rst | 9 +++++++++ lib/sqlalchemy/ext/orderinglist.py | 7 +++---- 2 files changed, 12 insertions(+), 4 deletions(-) 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 -- 2.47.2