Backport warning to shutil.unpack_archive docs

python · May 16, 2023 · f755ecd · f755ecd
1 parent 3e2c2f9
commit f755ecd
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
@@ -665,6 +665,13 @@ provided.  They rely on the :mod:`zipfile` and :mod:`tarfile` modules.
 
    .. audit-event:: shutil.unpack_archive filename,extract_dir,format shutil.unpack_archive
 
+   .. warning::
+
+      Never extract archives from untrusted sources without prior inspection.
+      It is possible that files are created outside of the path specified in
+      the *extract_dir* argument, e.g. members that have absolute filenames
+      starting with "/" or filenames with two dots "..".
+
    .. versionchanged:: 3.7
       Accepts a :term:`path-like object` for *filename* and *extract_dir*.