New submission from iMath <redstone-c...@163.com>:

The current behavior of shutil.make_archive caused many issues , the problem is 
mainly on the extracted archive directory hierarchy. These are the proofs:
https://stackoverflow.com/questions/51914467/directory-hierarchy-issue-when-using-shutil-make-archive

https://stackoverflow.com/questions/32640053/compressing-directory-using-shutil-make-archive-while-preserving-directory-str

https://stackoverflow.com/questions/41624800/shutil-make-archive-issue-dont-want-directories-included-in-zip-file

https://stackoverflow.com/questions/50156657/unexpected-file-using-shutil-make-archive-to-compress-file
For example , if I want to create a zip archive of the pip package (path 
specified by pip.__path__[0])), and need a directory named pip to hold the  
files and folders which originally reside in the pip package when unpacking the 
archive, then I need give root_dirparameter of shutil.make_archive the parent 
directory of the pippackage path (root_dir=Path(pip.__path__[0]).parent), and 
then the base_dir parameter the final path component of the pip package 
path(base_dir=Path(pip.__path__[0]).name) , so it is os.path.join(root_dir, 
base_dir) that specified the directory to archive , so weird !!!
I suggest to change shutil.make_archive(base_name, format[, root_dir[, 
base_dir]]) to shutil.make_archive(base_name, format[, archived_dir[, 
archive_prfix]]) where archived_dirdenotes the path to be archived and 
archive_prfix denotes the common prefix of all files and directories in the 
archive (it is just a path component and we shouldn’t assume the existence of 
it on the file system).

If the current behavior of shutil.make_archive won’t be changed , I’d suggest 
improve its doc, because  so many people couldn’t grasp the use of 
shutil.make_archive even consulting the doc , these are the proofs:
https://stackoverflow.com/questions/45245079/python-how-to-use-shutil-make-archive
https://stackoverflow.com/questions/30049201/how-to-compress-a-file-with-shutil-make-archive-in-python

----------
messages: 323829
nosy: redstone-cold
priority: normal
severity: normal
status: open
title: improve  shutil.make_archive

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue34450>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to