File tree Expand file tree Collapse file tree 1 file changed +10
-0
lines changed Expand file tree Collapse file tree 1 file changed +10
-0
lines changed Original file line number Diff line number Diff line change @@ -50,6 +50,16 @@ reserve the right of speeding up the deprecation cycle and shortening deprecatio
50
50
Note that these are exceptional circumstances and that the project will
51
51
carefully attempt to find alternatives before resorting to unscheduled removals.
52
52
53
+ .. important ::
54
+ In the context of ``setuptools ``, the introduction of :py:mod: `warnings `
55
+ (including deprecation warnings) is not considered a breaking change *per se *.
56
+ Instead it is considered a backwards compatible *communication action * that
57
+ precedes an upcoming breaking change. This is becauset code
58
+ containing warnings typically does not fail and can successfully terminate
59
+ execution, unless users explicitly opt into transforming those warnings
60
+ into errors (e.g., via Python's :external+python:ref: `-W option or
61
+ PYTHONWARNINGS environment variable <using-on-warnings>`).
62
+
53
63
54
64
What to do when deprecation periods are undefined?
55
65
--------------------------------------------------
You can’t perform that action at this time.
0 commit comments