Patch #658927: Add getctime to os.path.
Document that getatime and getmtime may return floats.
diff --git a/Lib/macpath.py b/Lib/macpath.py
index 734bae2..ba9d40b 100644
--- a/Lib/macpath.py
+++ b/Lib/macpath.py
@@ -5,7 +5,7 @@
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile",
+ "getatime","getctime", "islink","exists","isdir","isfile",
"walk","expanduser","expandvars","normpath","abspath",
"supports_unicode_filenames"]
@@ -129,6 +129,9 @@
return False
return S_ISREG(st.st_mode)
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
def exists(s):
"""Return True if the pathname refers to an existing file or directory."""
diff --git a/Lib/ntpath.py b/Lib/ntpath.py
index 4e7bb88..d6b6920 100644
--- a/Lib/ntpath.py
+++ b/Lib/ntpath.py
@@ -11,7 +11,7 @@
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile","ismount",
+ "getatime","getctime", "islink","exists","isdir","isfile","ismount",
"walk","expanduser","expandvars","normpath","abspath","splitunc",
"supports_unicode_filenames"]
@@ -220,6 +220,9 @@
"""Return the last access time of a file, reported by os.stat()"""
return os.stat(filename).st_atime
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
# Is a path a symbolic link?
# This will always return false on systems where posix.lstat doesn't exist.
diff --git a/Lib/os2emxpath.py b/Lib/os2emxpath.py
index 616d474..0315da0 100644
--- a/Lib/os2emxpath.py
+++ b/Lib/os2emxpath.py
@@ -10,7 +10,7 @@
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile","ismount",
+ "getatime","getctime", "islink","exists","isdir","isfile","ismount",
"walk","expanduser","expandvars","normpath","abspath","splitunc",
"supports_unicode_filenames"]
@@ -186,6 +186,9 @@
"""Return the last access time of a file, reported by os.stat()"""
return os.stat(filename).st_atime
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
# Is a path a symbolic link?
# This will always return false on systems where posix.lstat doesn't exist.
diff --git a/Lib/posixpath.py b/Lib/posixpath.py
index 4a92f18..8da9fda 100644
--- a/Lib/posixpath.py
+++ b/Lib/posixpath.py
@@ -15,7 +15,7 @@
__all__ = ["normcase","isabs","join","splitdrive","split","splitext",
"basename","dirname","commonprefix","getsize","getmtime",
- "getatime","islink","exists","isdir","isfile","ismount",
+ "getatime","getctime","islink","exists","isdir","isfile","ismount",
"walk","expanduser","expandvars","normpath","abspath",
"samefile","sameopenfile","samestat","supports_unicode_filenames"]
@@ -137,6 +137,9 @@
"""Return the last access time of a file, reported by os.stat()."""
return os.stat(filename).st_atime
+def getctime(filename):
+ """Return the creation time of a file, reported by os.stat()."""
+ return os.stat(filename).st_ctime
# Is a path a symbolic link?
# This will always return false on systems where os.lstat doesn't exist.