python模块之os.path

os.path.abspath(path)

返回path的绝对路径名

>>> os.path.abspath(".")
'C:\Users\admin\Desktop\PycharmProjects\python_demo'

os.path.basename(path)

返回文件名，等同于调用os.path.split(path)返回值的第二个元素。

>>> os.path.basename("/usr/bin/")
''
>>> os.path.basename("/usr/bin")
'bin'

python的basename和Unix shell的basename指令是有区别的：

[root@localhost ~]# basename "/usr/bin"
bin
[root@localhost ~]# basename "/usr/bin/"
bin

os.path.commonpath(paths)

返回序列参数paths中最长的公共子路径。如果paths为空，或者同时包含绝对路径和相对路径，抛出ValueError异常。 与os.path.commonprefix(list)不同，此函数的返回值一定是一个有效路径。

>>> os.path.commonpath(["/home/admin", "/home/admin/.ssh"])
'/home/admin'
>>> os.path.commonpath(["/home/admin1", "/home/admin2"])
'/home'

os.path.commonprefix(list)

返回list中所有路径的最大长度的公共路径前缀，如果list为空返回空字符串。其返回值可能是一个无效路径。

>>> os.path.commonprefix([".", "/root"])
''
>>> os.path.commonprefix(["/home/admin1", "/home/admin2"])
'/home/admin'

os.path.dirname(path)

返回目录名，等同于调用os.path.split(path)返回值的第一个元素。

>>> os.path.dirname("/usr/bin/")
'/usr/bin'
>>> os.path.dirname("/usr/bin")
'/usr'

os.path.exists(path)

判断path是否存在。如果path是一个已存在的路径或一个打开的文件描述符(int)，返回True。 在某些平台，即使path真实存在，但如果没有针对path执行os.stat()的权限，仍有可能返回False。 如果path是一个受到破坏的软链接(原始文件/文件夹被删除)，返回False。

os.path.lexists(path)

判断path是否存在。如果path是一个已存在的路径，返回True。 如果path是一个受到破坏的软链接(原始文件/文件夹被删除)，返回True。

os.path.expanduser(path)

返回把path中包含的"~"和"~user"转换成用户目录后的路径。

Unix平台： 对于path中的~，如果设置了环境变量HOME，使用HOME的值替换；否则使用当前用户的用户主目录替换； 对于path中的~user，直接使用user的用户主目录替换

>>> os.path.expanduser("~/local/mysql")
'/root/local/mysql'
>>> os.path.expanduser("~admin/local/mysql")
'/home/admin/local/mysql'

Windows平台： 对于path中的~，使用环境变量HOME或USERPROFILE的值，或HOMEPATH和HOMEDRIVE的值的组合替换； 对于path中的~user，将替换"~"的路径的最后一个目录组件剥离，使用user替换

# 查看环境变量
(python) D:>echo %HOME%
%HOME%

(python) D:>echo %USERPROFILE%
C:Usersadmin

(python) D:>echo %HOMEPATH%
Usersadmin

(python) D:>echo %HOMEDRIVE%
C:

>>> os.path.expanduser("~\local")
'C:\Users\admin\local'

# 将C:\Users\admin中的admin替换为anyuser
>>> os.path.expanduser("~anyuser\local")
'C:\Users\anyuser\local'

如果扩展失败或path未以"~"为前缀，不做改动直接返回。

os.path.expandvars(path)

扩展path中的环境变量并返回。path中$NAME和${NAME}格式的子串将被对应的环境变量替换(不同平台存在是否区分大小写的问题)。格式错误或变量不存在，将直接返回。 在windows中还包括%NAME%的形式。

os.path.getatime(path)

最后访问时间。返回值是自epoch时间算起的浮点值，单位为秒。如果path不存在或无法访问将抛出异常。

>>> getatime("/root/demo.txt")
1545345643.4549878

os.path.getmtime(path)

最后修改时间。返回值是自epoch时间算起的浮点值，单位为秒。如果path不存在或无法访问将抛出异常。

os.path.getctime(path)

在Unix系统，表示最近一次修改元数据的时间；在Windows系统，表示创建时间。返回值是自epoch时间算起的浮点值，单位为秒。如果path不存在或无法访问将抛出异常。

os.path.getsize(path)

以字节为单位返回路径大小。如果path不存在或无法访问将抛出异常。 如果path指向一个文件夹，返回值不代表该文件夹真实占用的大小。

os.path.isabs(path)

判断是否为绝对路径。

os.path.isfile(path)

判断是否为文件。符号链接判定为True，受到破坏判定为False

[root@localhost ~]# ll
总用量 0
lrwxrwxrwx. 1 root root  8 12月 21 07:32 demo.link -> demo.txt
-rw-r--r--. 1 root root  0 12月 21 07:31 demo.txt
lrwxrwxrwx. 1 root root 10 12月 21 07:32 sample.link -> sample.txt  # 原文件被删除导致软链接受到破坏

>>> isfile("/root/demo.link")
True
>>> isfile("/root/sample.link")
False

os.path.isdir(path)

判断是否为文件夹。符号链接判定为True，受到破坏判定为False

os.path.islink(path)

判断是否为符号链接，即使是受到破坏的符号链接，也会返回True。 如果Python运行环境不支持符号链接，返回False。

os.path.ismount(path)

判断是否为挂载点。

[root@localhost ~]# df -h
文件系统                 容量  已用  可用 已用% 挂载点
/dev/mapper/centos-root   18G  1.7G   16G   10% /
devtmpfs                 480M     0  480M    0% /dev
tmpfs                    492M     0  492M    0% /dev/shm
tmpfs                    492M  7.4M  485M    2% /run
tmpfs                    492M     0  492M    0% /sys/fs/cgroup
/dev/sda1                497M  157M  340M   32% /boot
tmpfs                     99M     0   99M    0% /run/user/0

>>> ismount("/dev")
True

对于Windows系统，磁盘符根目录及UNC路径的共享目录总是挂载点：

>>> ismount("c:/")
True
>>> ismount("//DESKTOP-BV17H6X/Users/")
True

os.path.join(path, *paths)

路径拼接。 将path与paths中的非空路径组件使用系统分隔符拼接。如果最后一个组件是空字符串，返回值将以分隔符结尾：

>>> join("/root", "a", "b", "", "c")
'/root/a/b/c'

>>> join("/root", "a", "b", "c", "")
'/root/a/b/c/'

如果paths中任意一个组件是绝对路径，将直接以该组件开始进行拼接：

>>> join("/root", "a", "/b", "c")
'/b/c'

在Windows中，如果paths中出现不含磁盘符的绝对路径，不会重置磁盘符：

>>> join("c:/root", "/foo")
'c:/foo'

如果paths中出现含磁盘符的，直接从该路径开始进行拼接：

>>> join("c:/root", "e:/root", "/foo")
'e:/foo'

每个磁盘符有一个当前工作目录，下例表示相对于该磁盘当前工作目录的路径foo(e:foo而非e:\foo)：

>>> os.path.abspath(join("e:", "foo"))
'E:\git_project\foo'

os.path.normcase(path)

规范路径名大小写。在Unix和Mac OS X系统，直接返回path；在大小写不敏感的系统(如Windows)，会将path转换为小写字母。此外Windows还会将/转换为\。

os.path.normpath(path)

规范路径名中的多余分隔符以及上级引用，如A//B, A/B/, A/./B and A/foo/../B将全部转换为A/B。Windows系统还会将/转换为\。

os.path.realpath(path)

将包含符号链接的path转换为真实路径名称。

os.path.relpath(path, start=os.curdir)

返回相对于当前工作目录或指定的start目录的相对路径。

os.path.samefile(path1, path2)

判断path1和path2是否指向同一个文件或目录，取决于设备号和i-node。如果调用os.stat()失败将抛出异常。

os.path.sameopenfile(fp1, fp2)

判断文件描述符fp1和fp2是否指向同一个文件或目录。

os.path.samestat(stat1, stat2)

判断状态元组stat1和stat2是否指向同一个文件或目录，参数可能是os.fstat()、os.lstat或os.stat()的返回值。

os.path.split(path)

将path拆分为(head, tail)的元组形式。 tail部分总是不包含斜杠，如果path以斜杠结尾，tail将为空字符串；尾部的斜杠也会从head中去除，除非path是根路径：

>>> split("/home/admin/.ssh/")
('/home/admin/.ssh', '')

>>> split("/")
('/', '')

如果path不包含斜杠，head部分将为空字符串：

>>> split("home")
('', 'home')

如果path为空字符串，head和tail都将为空：

>>> split("")
('', '')

os.path.splitdrive(path)

将path拆分为(drive, tail)的元组形式。 在不使用磁盘符的系统，drive总是为空字符串；在Windows系统，会将path分割为UNC共享点/磁盘驱动，及其相对路径。

# 包含磁盘符的路径
>>> splitdrive("c:/dir")
('c:', '/dir')

# UNC路径，分割后的drive包含主机名和共享点(到第四个分隔符但不包括第四个)
>>> splitdrive("//servername/sharename/directory/filename")
('//servername/sharename', '/directory/filename')

os.path.splitext(path)

将path拆分为(root, ext)的元组形式。 ext为空字符串或者以.打头且只包含1个.的字符串：

>>> splitext("/home/admin/.ssh/")
('/home/admin/.ssh/', '')

>>> splitext("/home/admin/.ssh/id_rsa.ppk")
('/home/admin/.ssh/id_rsa', '.ppk')

# 如果path以'.'打头，ext将为空字符串
>>> splitext('.cshrc')
('.cshrc', '')

os.path.supports_unicode_filenames

判断是否能使用任意Unicode字符串作为文件名（在文件系统强加的限制内）