TLDR Dev · OPINIONS & ADVICE

DEPRECATIONS VIA WARNINGS DON'T WORK FOR PYTHON LIBRARIES

sethmlarson.dev2 min read

Summary from the TLDR Dev newsletter

urllib3 v2.6.0 contained removals for several APIs that have been known to be problematic since 2019 and have been deprecated since 2022. The deprecations were marked in the documentation and changelog, but the team still received feedback that the removal was unexpected and was breaking dependent libraries. This incident makes it clear that DeprecationWarning in its current state doesn't work for deprecating APIs, at least for Python libraries.