1 API changes in cubicweb 3.14

     2 ----------------------------

     3 

     4 * `Entity.fetch_order` and `Entity.fetch_unrelated_order` class methods have been

     5   replaced by `Entity.cw_fetch_order` and `Entity.cw_fetch_unrelated_order` with

     6   a different prototype:

     7 

     8   - instead of taking (attr, var) as two string argument, they now take (select,

     9     attr, var) where select is the rql syntax tree beinx constructed and var the

    10     variable *node*.

    11 

    12   - instead of returning some string to be inserted in the ORDERBY clause, it has

    13     to modify the syntax tree

    14 

    15   Backward compat is kept with proper warning, BESIDE cases below:

    16 

    17   - custom order method return **something else the a variable name with or

    18     without the sorting order** (e.g. cases where you sort on the value of a

    19     registered procedure as it was done in the tracker for instance). In such

    20     case, an error is logged telling that this sorting is ignored until API

    21     upgrade.

    22 

    23   - client code use direct access to one of those methods on an entity (no code

    24     known to do that)

    25