[New-bugs-announce] [issue30235] Validate shutil supports path-like objects, update docs accordingly

[Brett Cannon]

New submission from Brett Cannon:

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]

----------
components: Library (Lib)
messages: 292788
nosy: brett.cannon
priority: normal
severity: normal
stage: test needed
status: open
title: Validate shutil supports path-like objects, update docs accordingly
type: behavior
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue30235>
_______________________________________