PyCon 2019 in Cleveland, Ohio

Friday 11:30 a.m.–noon in Grand Ballroom C

API Evolution the Right Way

A. Jesse Jiryu Davis


If you maintain a library, how can you innovate without breaking the projects that depend on it? Follow semantic versioning, add APIs conservatively, add parameters compatibly, use DeprecationWarnings and publish a deprecation policy, guide your users on how to upgrade, and make wise choices about when to break backwards compatibility.