What's new in CubicWeb 3.20

===========================

New features

------------

* virtual relations: a new ComputedRelation class can be used in

  schema.py; its `rule` attribute is an RQL snippet that defines the new

  relation.

* computed attributes: an attribute can now be defined with a `formula`

  argument (also an RQL snippet); it will be read-only, and updated

  automatically.

  Both of these features are described in `CWEP-002`_, and the updated

  "Data model" chapter of the CubicWeb book.

* cubicweb-ctl plugins can use the ``cubicweb.utils.admincnx`` function

  to get a Connection object from an instance name.

.. _CWEP-002: http://hg.logilab.org/review/cwep/file/tip/CWEP-002.rst

API Changes

-----------

* ``ucsvreader()`` and ``ucsvreader_pb()`` from the ``dataimport`` module have

  2 new keyword arguments ``delimiter`` and ``quotechar`` to replace the

  ``separator`` and ``quote`` arguments respectively. This makes the API match

  that of Python's ``csv.reader()``.  The old arguments are still supported

  though deprecated.

* the migration environment's ``remove_cube`` function is now called ``drop_cube``.

Deprecated Code Drops

----------------------

* most of 3.10 and 3.11 backward compat is gone; this includes:

  - CtxComponent.box_action() and CtxComponent.build_link()

  - cubicweb.devtools.htmlparser.XMLDemotingValidator

  - various methods and properties on Entities, replaced by cw_edited and cw_attr_cache

  - 'commit_event' method on hooks, replaced by 'postcommit_event'

  - server.hook.set_operation(), replaced by Operation.get_instance(...).add_data()

  - View.div_id(), View.div_class() and View.create_url()

  - `*VComponent` classes

  - in forms, Field.value() and Field.help() must take the form and the field itself as arguments

  - form.render() must get `w` as a named argument, and renderer.render() must take `w` as first argument

  - in breadcrumbs, the optional `recurs` argument must be a set, not False

  - cubicweb.web.views.idownloadable.{download_box,IDownloadableLineView}

  - primary views no longer have `render_entity_summary` and `summary` methods

  - WFHistoryVComponent's `cell_call` method is replaced by `render_body`

  - cubicweb.dataimport.ObjectStore.add(), replaced by create_entity

  - ManageView.{folders,display_folders}