classification
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
process
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 (https://docs.python.org/3/library/shutil.html), 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 https://github.com/python/cpython/pull/1367]
History
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