Title: Validate shutil supports path-like objects, update docs accordingly
Type: behavior Stage: patch review
Components: Library (Lib) Versions: Python 3.7, Python 3.6
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: brett.cannon, giampaolo.rodola
Priority: normal Keywords: patch

Created on 2017-05-02 17:12 by brett.cannon, last changed 2018-06-12 09:37 by giampaolo.rodola.

Pull Requests
URL Status Linked Edit
PR 1367 Jelle Zijlstra, 2017-05-02 17:14
PR 6009 closed rougeth, 2018-03-06 19:57
Messages (1)
msg292788 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2017-05-02 17:12
If you look at the docs for shutil (, you will notice all over it says things like "path names given as strings". The question is whether that statement is true in the face of path-like objects? If it is true then the corresponding function in shutil should be updated to accept path-like objects. If it's false then the docs for the function should be updated.

This is a meta-issue to track working on the overall module (IOW separate PRs to fix things piecemeal is fine). Looks like the following functions need checking/updating:

- copyfile
- copymode
- copystat
- copy
- copy2
- copytree
- rmtree
- move
- disk_usage
- chown
- make_archive

[ unpack_archive is covered by]
Date User Action Args
2018-06-12 09:37:54giampaolo.rodolasetnosy: + giampaolo.rodola
2018-03-06 19:57:08rougethsetkeywords: + patch
stage: test needed -> patch review
pull_requests: + pull_request5774
2017-05-02 17:14:36Jelle Zijlstrasetpull_requests: + pull_request1501
2017-05-02 17:14:06brett.cannonsetversions: + Python 3.6
2017-05-02 17:12:39brett.cannoncreate