What's new in CubicWeb 3.19?

Behaviour Changes

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

  related user login. If it matches the ``anonymous-user`` in the config the

  specific. Therefore, no session may be anonymous in a repository only setup.

Connection replaces Session

~~~~~~~~~~~~~~~~~~~~~~~~~~~

A new explicit Connection object replaces Session as the main repository entry

point. Connection holds all the necessary methods to be used server-side

etc...). One obtains a new Connection object using ``session.new_cnx()``.

Connection objects need to have an explicit begin and end. Use them as a context

manager to never miss an end::

same Transaction. However, Connection objects are not thread safe (hence at your

own risks).

``repository.internal_cnx``. Note that internal connections are now `safe` by default,

i.e. the integrity hooks are enabled.

Backward compatibility is preserved on Session.

A new API has been introduced to replace the dbapi. It is called `repoapi`.

There are three relevant functions for now:

* ``repoapi.get_repository(config)`` takes a config object and return credential

* ``repoapi.connect(repo, **credentials)`` returns a ClientConnection

  associated with the user identified by the credentials. The

  ClientConnection is associated with its own Session that is closed

  when the ClientConnection is closed. A ClientConnection is a

  Connection-like object to be used client side.

* ``repoapi.anonymous_cnx(repo)`` returns a ClientConnection associated

  with the anonymous user if describe in the Config.

instead of a ``dbapi.connection``. The ``ClientConnection`` has multiple backward

compatible methods to make it look like a ``dbapi.Cursor`` and ``dbapi.Connection``.

Some backward compatibility methods have been installed on the server side Session

to ease the transition.

The authentication stack has been altered to use the ``repoapi`` instead of

the ``dbapi``. Cubes adding new element to this stack are likely to break.

New API in tests

~~~~~~~~~~~~~~~~

All current methods and attributes used to access the repo on ``CubicWebTC`` are

deprecated. You may now use a ``RepoAccess`` object. A ``RepoAccess`` object is

``Connection``, ``ClientConnection`` and web side requests linked to this

    access = self.new_access('babar') # create a new RepoAccess for user babar

        cnx.execute(...)

        cnx.execute(...)

        cnx.execute(...)

    with access.web_request(elephant='babar') as req:

        elephant_name = req.form['elephant']

        req.execute(...)

* The ``async`` argument of ``_cw.call_service`` has been dropped. All calls are

  most async use cases.

* ``repo.stats()`` is now deprecated. The same information is available through

  a service (``_cw.call_service('repo_stats')``).

* ``repo.gc_stats()`` is now deprecated. The same information is available through

  a service (``_cw.call_service('repo_gc_stats')``).