Jul 23, 2025 · Jul 13, 2025
diff --git a/Lib/shutil.py b/Lib/shutil.py
    """Create a (possibly compressed) tar file from all the files under
    'base_dir'.

    'compress' must be "gzip" (the default), "bzip2", "xz", or None.
    'compress' must be "gzip" (the default), "bzip2", "xz","zst",or None.

    'owner' and 'group' can be used to define an owner and a group for the
    archive that is being built. If not provided, the current owner and group
    will be used.

    The output tar file will be named 'base_name' +  ".tar", possibly plus
    the appropriate compression extension (".gz", ".bz2", or ".xz").
    the appropriate compression extension (".gz", ".bz2",".xz",or ".zst").

    Returns the output filename.
    """

    'base_name' is the name of the file to create, minus any format-specific
    extension; 'format' is the archive format: one of "zip", "tar", "gztar",
    "bztar", "zstdtar", or "xztar".  Or any other registered format.
    "bztar", "xztar", or "zstdtar".  Or any other registered format.

    'root_dir' is a directory that will be the root directory of the
    archive; ie. we typically chdir into 'root_dir' before creating the
        zip.close()

 def _unpack_tarfile(filename, extract_dir, *, filter=None):
    """Unpack tar/tar.gz/tar.bz2/tar.xz `filename` to `extract_dir`
    """Unpack tar/tar.gz/tar.bz2/tar.xz/tar.zst `filename` to `extract_dir`
    """
    import tarfile  # late import for breaking circular dependency
    try:
    is unpacked. If not provided, the current working directory is used.

    `format` is the archive format: one of "zip", "tar", "gztar", "bztar",
    or "xztar".  Or any other registered format.  If not provided,
 "xztar",or "zstdtar".  Or any other registered format.  If not provided,
    unpack_archive will use the filename extension and see if an unpacker
    was registered for that extension.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -994,14 +994,14 @@ def _make_tarball(base_name, base_dir, compress="gzip", verbose=0, dry_run=0,
		"""Create a (possibly compressed) tar file from all the files under
		'base_dir'.

		'compress' must be "gzip" (the default), "bzip2", "xz", or None.
		'compress' must be "gzip" (the default), "bzip2", "xz","zst",or None.

		'owner' and 'group' can be used to define an owner and a group for the
		archive that is being built. If not provided, the current owner and group
		will be used.

		The output tar file will be named 'base_name' + ".tar", possibly plus
		the appropriate compression extension (".gz", ".bz2", or ".xz").
		the appropriate compression extension (".gz", ".bz2",".xz",or ".zst").

		Returns the output filename.
		"""
Expand DownExpand Up		@@ -1187,7 +1187,7 @@ def make_archive(base_name, format, root_dir=None, base_dir=None, verbose=0,

		'base_name' is the name of the file to create, minus any format-specific
		extension; 'format' is the archive format: one of "zip", "tar", "gztar",
		"bztar", "zstdtar", or "xztar". Or any other registered format.
		"bztar", "xztar", or "zstdtar". Or any other registered format.

		'root_dir' is a directory that will be the root directory of the
		archive; ie. we typically chdir into 'root_dir' before creating the
Expand DownExpand Up		@@ -1337,7 +1337,7 @@ def _unpack_zipfile(filename, extract_dir):
		zip.close()

		def _unpack_tarfile(filename, extract_dir, *, filter=None):
		"""Unpack tar/tar.gz/tar.bz2/tar.xz `filename` to `extract_dir`
		"""Unpack tar/tar.gz/tar.bz2/tar.xz/tar.zst `filename` to `extract_dir`
		"""
		import tarfile # late import for breaking circular dependency
		try:
Expand DownExpand Up		@@ -1392,7 +1392,7 @@ def unpack_archive(filename, extract_dir=None, format=None, *, filter=None):
		is unpacked. If not provided, the current working directory is used.

		`format` is the archive format: one of "zip", "tar", "gztar", "bztar",
		or "xztar". Or any other registered format. If not provided,
		"xztar",or "zstdtar". Or any other registered format. If not provided,
		unpack_archive will use the filename extension and see if an unpacker
		was registered for that extension.

Expand Down