From 96a60e4af574d72f14ad70fc4db5986e1ad42aa5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20v=2E=20L=C3=B6wis?= Date: Tue, 31 Dec 2002 13:11:54 +0000 Subject: [PATCH] Patch #658927: Add getctime to os.path. Document that getatime and getmtime may return floats. --- Doc/lib/libposixpath.tex | 14 ++++++++++++-- Lib/macpath.py | 5 ++++- Lib/ntpath.py | 5 ++++- Lib/os2emxpath.py | 5 ++++- Lib/posixpath.py | 5 ++++- Misc/NEWS | 2 ++ 6 files changed, 30 insertions(+), 6 deletions(-) diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex index 78256390b7c..b83eff4a87e 100644 --- a/Doc/lib/libposixpath.tex +++ b/Doc/lib/libposixpath.tex @@ -67,18 +67,28 @@ unchanged. \begin{funcdesc}{getatime}{path} Return the time of last access of \var{filename}. The return -value is integer giving the number of seconds since the epoch (see the +value is a number giving the number of seconds since the epoch (see the \refmodule{time} module). Raise \exception{os.error} if the file does not exist or is inaccessible. \versionadded{1.5.2} +\versionchanged[If \function{os.stat_float_times()} returns True, the result is a floating point number]{2.3} \end{funcdesc} \begin{funcdesc}{getmtime}{path} Return the time of last modification of \var{filename}. The return -value is integer giving the number of seconds since the epoch (see the +value is a number giving the number of seconds since the epoch (see the \refmodule{time} module). Raise \exception{os.error} if the file does not exist or is inaccessible. \versionadded{1.5.2} +\versionchanged[If \function{os.stat_float_times()} returns True, the result is a floating point number]{2.3} +\end{funcdesc} + +\begin{funcdesc}{getctime}{path} +Return the time of creation of \var{filename}. The return +value is a number giving the number of seconds since the epoch (see the +\refmodule{time} module). Raise \exception{os.error} if the file does +not exist or is inaccessible. +\versionadded{2.3} \end{funcdesc} \begin{funcdesc}{getsize}{path} diff --git a/Lib/macpath.py b/Lib/macpath.py index 734bae292ed..ba9d40b7436 100644 --- a/Lib/macpath.py +++ b/Lib/macpath.py @@ -5,7 +5,7 @@ from stat import * __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 @@ def isfile(s): 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 4e7bb885a9f..d6b69208df4 100644 --- a/Lib/ntpath.py +++ b/Lib/ntpath.py @@ -11,7 +11,7 @@ import sys __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 @@ def getatime(filename): """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 616d474c65c..0315da027fa 100644 --- a/Lib/os2emxpath.py +++ b/Lib/os2emxpath.py @@ -10,7 +10,7 @@ import stat __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 @@ def getatime(filename): """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 4a92f18cb91..8da9fdaa8c2 100644 --- a/Lib/posixpath.py +++ b/Lib/posixpath.py @@ -15,7 +15,7 @@ import stat __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 @@ def getatime(filename): """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. diff --git a/Misc/NEWS b/Misc/NEWS index a5dbd94930f..1efaf453c7b 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -463,6 +463,8 @@ Extension modules Library ------- +- os.path exposes getctime. + - unittest.py now has two additional methods called assertAlmostEqual() and failIfAlmostEqual(). They implement an approximate comparision by rounding the difference between the two arguments and comparing