summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorXiang Zhang <angwerzx@126.com>2017-01-22 05:04:17 (GMT)
committerXiang Zhang <angwerzx@126.com>2017-01-22 05:04:17 (GMT)
commit4459e009ed36331a976d605270bc0a81d091aa75 (patch)
treebf6e2bfbafba50d5b2801b6d630ad0d38b263177
parenta203360836df8110b6e0e4b8a8ed551fa2f0df06 (diff)
parentd7d87ca9b0495f1dd04863fbb93226c0e0f7af5f (diff)
downloadcpython-4459e009ed36331a976d605270bc0a81d091aa75.zip
cpython-4459e009ed36331a976d605270bc0a81d091aa75.tar.gz
cpython-4459e009ed36331a976d605270bc0a81d091aa75.tar.bz2
Issue #29092: Sync os.stat's doc and docstring on path type.
-rw-r--r--Doc/library/os.rst2
-rw-r--r--Modules/clinic/posixmodule.c.h5
-rw-r--r--Modules/posixmodule.c5
3 files changed, 7 insertions, 5 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 988cb7c..37fa2a2 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2213,7 +2213,7 @@ features:
Get the status of a file or a file descriptor. Perform the equivalent of a
:c:func:`stat` system call on the given path. *path* may be specified as
- either a string -- directly or indirectly through the :class:`PathLike`
+ either a string or bytes -- directly or indirectly through the :class:`PathLike`
interface -- or as an open file descriptor. Return a :class:`stat_result`
object.
diff --git a/Modules/clinic/posixmodule.c.h b/Modules/clinic/posixmodule.c.h
index f63a3be..0d3ce6e 100644
--- a/Modules/clinic/posixmodule.c.h
+++ b/Modules/clinic/posixmodule.c.h
@@ -9,7 +9,8 @@ PyDoc_STRVAR(os_stat__doc__,
"Perform a stat system call on the given path.\n"
"\n"
" path\n"
-" Path to be examined; can be string, bytes, or open-file-descriptor int.\n"
+" Path to be examined; can be string, bytes, path-like object or\n"
+" open-file-descriptor int.\n"
" dir_fd\n"
" If not None, it should be a file descriptor open to a directory,\n"
" and path should be a relative string; path will then be relative to\n"
@@ -6149,4 +6150,4 @@ exit:
#ifndef OS_GETRANDOM_METHODDEF
#define OS_GETRANDOM_METHODDEF
#endif /* !defined(OS_GETRANDOM_METHODDEF) */
-/*[clinic end generated code: output=50cfb7ebc44efb67 input=a9049054013a1b77]*/
+/*[clinic end generated code: output=455def991740915a input=a9049054013a1b77]*/
diff --git a/Modules/posixmodule.c b/Modules/posixmodule.c
index 33ee70d..dc3fb94 100644
--- a/Modules/posixmodule.c
+++ b/Modules/posixmodule.c
@@ -2386,7 +2386,8 @@ class sched_param_converter(CConverter):
os.stat
path : path_t(allow_fd=True)
- Path to be examined; can be string, bytes, or open-file-descriptor int.
+ Path to be examined; can be string, bytes, path-like object or
+ open-file-descriptor int.
*
@@ -2413,7 +2414,7 @@ It's an error to use dir_fd or follow_symlinks when specifying path as
static PyObject *
os_stat_impl(PyObject *module, path_t *path, int dir_fd, int follow_symlinks)
-/*[clinic end generated code: output=7d4976e6f18a59c5 input=099d356c306fa24a]*/
+/*[clinic end generated code: output=7d4976e6f18a59c5 input=270bd64e7bb3c8f7]*/
{
return posix_do_stat("stat", path, dir_fd, follow_symlinks);
}