[Cubicweb] deprecation policy

Pierre-Yves David pierre-yves.david at logilab.fr
Wed Jul 25 11:04:01 CEST 2012


On Tue, Jul 24, 2012 at 05:31:14PM +0200, Aurélien Campéas wrote:
> Dear list,
> 
> I have seen the latest API change in 3.16: one adds a cw_set method
> which unifies set_attributes and set_relations. Also the former
> methods
> get deprecated.
> 
> In an ideal world, I'd:
> * fix my cube's code to kill the deprecation warnings asap
> * use a proper configuration management tool and be happy
> 
> In my current world, I have
> 
> * either to endure swaths of deprecation warnings (for such a
>   basic & widely used API) whenever I continue to develop with
>   this version of cubicweb, because I do not want to immediately
>   commit to it (esp. go in production with it),
> 
> * or to adapt the code & from this render my cube incompatible with
>   former cubicweb versions
> 
> These situations are problematic imo. Maybe I give too much
> importance to these warnings. They tend to pollute quite a bit
> the console however and the repetition of each warning gets
> tiresome quickly.
> 
> That happened also recently with e.g cw 3.15, where cubicweb.selectors
> became cubicweb.predicates. Other than that there are some
> important & big changes in 3.15 but _this renaming alone_ created a
> lot of visual noise.
> 
> Maybe I'm just asking for an option to hide them ?
> Or that we do not immediately deprecate old stuff ?
> Or that we grow good enough configuration management tools ?
> Unsure ...
> 
> Regards,
> Aurélien.
> 
> ps: this is a followup to http://www.cubicweb.org/ticket/2445042

We may use PendingDeprecationWarning for a few version.

http://docs.python.org/library/exceptions.html#exceptions.PendingDeprecationWarning


-- 
Pierre-Yves David

http://www.logilab.fr/

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.cubicweb.org/pipermail/cubicweb/attachments/20120725/33b38dce/attachment-0212.sig>


More information about the Cubicweb mailing list