Skip to content

Commit 56768d6

Browse files
authored
PEP 784: Updates to timeline and RFC reference (#4352)
* Add link to RFC 8478 * Add updated timeline verbiage * Fix DeprecationWarnings
1 parent ded32dd commit 56768d6

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

peps/pep-0784.rst

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,8 @@ significantly faster than LZMA.
4444
Zstandard has seen `widespread adoption`_ in many different areas of computing.
4545
The numerous hardware implementations demonstrate long-term commitment to
4646
Zstandard and an expectation that Zstandard will stay the *de facto* choice for
47-
compression for years to come. Zstandard compression is also implemented in
47+
compression for years to come. This is further evidenced by Zstandard's IETF
48+
standardization in :rfc:`8478`. Zstandard compression is also implemented in
4849
both the ZFS_ and Btrfs_ filesystems.
4950

5051
Zstandard's highly efficient compression has supplanted other modern
@@ -231,11 +232,13 @@ Existing modules will emit a ``DeprecationWarning`` in the Python
231232
release following the last Python without the ``compression`` module leaving
232233
support. For example, if the ``compression`` namespace is introduced in 3.14,
233234
then the ``DeprecationWarnings`` would be emitted in 3.19, the next release
234-
after 3.13 reaches end of life. Following the standard deprecation timeline
235-
specified in :pep:`387`, in Python 3.24 the existing modules will be removed
236-
and code must use the ``compression`` sub-modules. The documentation for these
237-
modules will be updated to discuss the planned deprecation and removal
238-
timelines.
235+
after 3.13 reaches end of life. These warnings would begin five years after the
236+
introduction of ``compression`` namespace. In accordance with :pep:`387`, in
237+
Python 3.24, five years after the ``DeprecationWarnings`` are added and ten
238+
years after the new ``compression`` namespace is introduced, the existing
239+
modules will be removed and code must use the ``compression`` sub-modules. The
240+
documentation for these modules will be updated to discuss the planned
241+
deprecation and removal timelines.
239242

240243

241244
Backwards Compatibility

0 commit comments

Comments
 (0)