And that's great news, after several months of development (things started moving
in the beginning of august 2009...), it should be available on our Debian repositories
and ftp site in the next few hours.
So, we can say this release contains a (too) large set of improvements and
refactorings. I'll talk about the most important ones here.
First of all, the namespace cleanup... 3.6 is a step towards cleaning the entity
classes (hence more generally appobject), which are used for a lot of
things, making it impossible to tell for sure what could be used or not as an
attribute or relation name. We decided to declare identifiers starting with \_cw or cw\_
reserved for the core classes. A lot of methods have been deprecated to cleanup the
base appobject class namespace. The remaining methods on entity classes will
be removed in future version, by the introduction of an ORM for database related
methods, and by the (most probable) introduction of ZCA adapters for other aspects.
The most notable renaming are:
- .req -> ._cw
- .rset -> .cw_rset
- .row -> .cw_row
- .col -> .cw_col
This is probably what you'll see first when upgrading to 3.6: a huge stack of deprecation warnings on your screen :)
Hooks are now regular appobjects, with selectors (don't forget to reuse
Hook.__select__, remember that !). They should simply implement __call__
with no argument (well, only self) and will get info previously passed as
argument as instance attributes, according to the matching event.
EnvBasedTC, ControllerTC, WebTest, RepoBasedTC are all gone. Simply use
CubicWebTC, with an unified API similar to what you use in cubicweb-ctl shell and in usual development.
You can now specify a custom storage for attributes of entities stored in the
system source. This mechanism is used to provide a way to store Bytes attributes
(such as File.data for instance) as files on the file-system instead of BLOBs in
the database. You can configure which attributes should use this storage for your instance and then everything is transparent.
In your schema definition file:
- "symetric" should be correctly spelled "symmetric" :)
- "permissions" was renamed to "__permissions__"
Also, permissions for relations are now supported per definition, not per type, at the cost of a visible impact when writing/reading the schema.
We worked hard to keep backward compatibility, but you shouldn't upgrade to 3.6 without checking that everything is fine... Check notably:
- forms, if you're using custom forms by overriding internal methods
- import for date functions from cubicweb.utils (they moved to logilab.common.date)
CubicWeb 3.6 comes with a set of 37 cubes "3.6"-ready to avoid too much warnings!
Enjoy!