Add a comment explaining why shutil.move doesn't allow bytes/Pathlike…

…[bytes] args (#6832)
python · Jan 8, 2022 · 0e5a00b · 0e5a00b
1 parent 28a5e6b
commit 0e5a00b
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/stdlib/shutil.pyi b/stdlib/shutil.pyi
@@ -48,6 +48,9 @@ def rmtree(path: StrOrBytesPath, ignore_errors: bool = ..., onerror: Callable[[A
 
 _CopyFn = Union[Callable[[str, str], None], Callable[[StrPath, StrPath], None]]
 
+# N.B. shutil.move appears to take bytes arguments, however,
+# this does not work when dst is (or is within) an existing directory.
+# (#6832)
 if sys.version_info >= (3, 9):
     def move(src: StrPath, dst: StrPath, copy_function: _CopyFn = ...) -> _PathReturn: ...