[Python] 04 - os & sys module

时间:2023-03-09 07:35:30
[Python] 04 - os & sys module

相当实用的一些 “操作系统API”:

Ref: https://docs.python.org/3/library/os.html

基础知识


一、程序初始化

获取参数

 提取参数 

sys.argv[idx]
len(sys.argv)

 异常检测 

如果参数有误:logging.error(...)

不能继续执行,return ERROR_NUMBER

如果文件夹存在

 删除、重建 

if os.path.exists(g_outputDirPath):   # 判断“文件存在、文件夹存在”
shutil.rmtree(g_outputDirPath)  # 同时删除了子文件夹
os.makedirs(g_outputDirPath)

 删除旧文件夹 

删除成功:logging.info(...)

删除失败:logging.error(...)

 创建新文件夹 

创建成功:logging.info(...)

创建失败:logging.error(...)

二、文件系统操作

os本身已经有了不少方法提供;还需要shutil补充一些更易用的操作。

os策略的方法

Ref: 常见函数列表【实用一些,较少】

Ref: Python3 OS 文件/目录方法

序号 方法及描述
1           

os.access(path, mode)

检验权限模式

2

os.chdir(path)

改变当前工作目录

3

os.chflags(path, flags)

设置路径的标记为数字标记。

4

os.chmod(path, mode)

更改权限

5

os.chown(path, uid, gid)

更改文件所有者

6

os.chroot(path)

改变当前进程的根目录

7

os.close(fd)

关闭文件描述符 fd

8

os.closerange(fd_low, fd_high)

关闭所有文件描述符,从 fd_low (包含) 到 fd_high (不包含), 错误会忽略

9

os.dup(fd)

复制文件描述符 fd

10

os.dup2(fd, fd2)

将一个文件描述符 fd 复制到另一个 fd2

11

os.fchdir(fd)

通过文件描述符改变当前工作目录

12

os.fchmod(fd, mode)

改变一个文件的访问权限,该文件由参数fd指定,参数mode是Unix下的文件访问权限。

13

os.fchown(fd, uid, gid)

修改一个文件的所有权,这个函数修改一个文件的用户ID和用户组ID,该文件由文件描述符fd指定。

14

os.fdatasync(fd)

强制将文件写入磁盘,该文件由文件描述符fd指定,但是不强制更新文件的状态信息。

15

os.fdopen(fd[, mode[, bufsize]])

通过文件描述符 fd 创建一个文件对象,并返回这个文件对象

16

os.fpathconf(fd, name)

返回一个打开的文件的系统配置信息。name为检索的系统配置的值,它也许是一个定义系统值的字符串,这些名字在很多标准中指定(POSIX.1, Unix 95, Unix 98, 和其它)。

17

os.fstat(fd)

返回文件描述符fd的状态,像stat()。

18

os.fstatvfs(fd)

返回包含文件描述符fd的文件的文件系统的信息,像 statvfs()

19

os.fsync(fd)

强制将文件描述符为fd的文件写入硬盘。

20

os.ftruncate(fd, length)

裁剪文件描述符fd对应的文件, 所以它最大不能超过文件大小。

21

os.getcwd()

返回当前工作目录

22

os.getcwdu()

返回一个当前工作目录的Unicode对象

23

os.isatty(fd)

如果文件描述符fd是打开的,同时与tty(-like)设备相连,则返回true, 否则False。

24

os.lchflags(path, flags)

设置路径的标记为数字标记,类似 chflags(),但是没有软链接

25

os.lchmod(path, mode)

修改连接文件权限

26

os.lchown(path, uid, gid)

更改文件所有者,类似 chown,但是不追踪链接。

27

os.link(src, dst)

创建硬链接,名为参数 dst,指向参数 src

28

os.listdir(path)

返回path指定的文件夹包含的文件或文件夹的名字的列表。

29

os.lseek(fd, pos, how)

设置文件描述符 fd当前位置为pos, how方式修改: SEEK_SET 或者 0 设置从文件开始的计算的pos; SEEK_CUR或者 1 则从当前位置计算; os.SEEK_END或者2则从文件尾部开始. 在unix,Windows中有效

30

os.lstat(path)

像stat(),但是没有软链接

31

os.major(device)

从原始的设备号中提取设备major号码 (使用stat中的st_dev或者st_rdev field)。

32

os.makedev(major, minor)

以major和minor设备号组成一个原始设备号

33

os.makedirs(path[, mode])

递归文件夹创建函数。像mkdir(), 但创建的所有intermediate-level文件夹需要包含子文件夹。

34

os.minor(device)

从原始的设备号中提取设备minor号码 (使用stat中的st_dev或者st_rdev field )。

35

os.mkdir(path[, mode])

以数字mode的mode创建一个名为path的文件夹.默认的 mode 是 0777 (八进制)。

36

os.mkfifo(path[, mode])

创建命名管道,mode 为数字,默认为 0666 (八进制)

37

os.mknod(filename[, mode=0600, device])

创建一个名为filename文件系统节点(文件,设备特别文件或者命名pipe)。

38

os.open(file, flags[, mode])

打开一个文件,并且设置需要的打开选项,mode参数是可选的

39

os.openpty()

打开一个新的伪终端对。返回 pty 和 tty的文件描述符。

40

os.pathconf(path, name)

返回相关文件的系统配置信息。

41

os.pipe()

创建一个管道. 返回一对文件描述符(r, w) 分别为读和写

42

os.popen(command[, mode[, bufsize]])

从一个 command 打开一个管道,是非堵塞的;堵塞的话,可以使用 os.system(cmd)

43

os.read(fd, n)

从文件描述符 fd 中读取最多 n 个字节,返回包含读取字节的字符串,文件描述符 fd对应文件已达到结尾, 返回一个空字符串。

44

os.readlink(path)

返回软链接所指向的文件

45

os.remove(path)

删除路径为path的文件。如果path 是一个文件夹,将抛出OSError; 查看下面的rmdir()删除一个 directory。

46

os.removedirs(path)

递归删除目录。不好使用!

47

os.rename(src, dst)

重命名文件或目录,从 src 到 dst

48

os.renames(old, new)

递归地对目录进行更名,也可以对文件进行更名。

49

os.rmdir(path)

删除path指定的空目录,如果目录非空,则抛出一个OSError异常。

50

os.stat(path)

获取path指定的路径的信息,功能等同于C API中的stat()系统调用。

51

os.stat_float_times([newvalue])
决定stat_result是否以float对象显示时间戳

52

os.statvfs(path)

获取指定路径的文件系统统计信息

53

os.symlink(src, dst)

创建一个软链接

54

os.tcgetpgrp(fd)

返回与终端fd(一个由os.open()返回的打开的文件描述符)关联的进程组

55

os.tcsetpgrp(fd, pg)

设置与终端fd(一个由os.open()返回的打开的文件描述符)关联的进程组为pg。

56

os.tempnam([dir[, prefix]])

Python3 中已删除。返回唯一的路径名用于创建临时文件。

57

os.tmpfile()

Python3 中已删除。返回一个打开的模式为(w+b)的文件对象 .这文件对象没有文件夹入口,没有文件描述符,将会自动删除。

58

os.tmpnam()

Python3 中已删除。为创建一个临时文件返回一个唯一的路径

59

os.ttyname(fd)

返回一个字符串,它表示与文件描述符fd 关联的终端设备。如果fd 没有与终端设备关联,则引发一个异常。

60

os.unlink(path)

删除文件路径

61

os.utime(path, times)

返回指定的path文件的访问和修改的时间。

62

os.walk(top[, topdown=True[, onerror=None[, followlinks=False]]])

输出在文件夹中的文件名通过在树中游走,向上或者向下。

63

os.write(fd, str)

写入字符串到文件描述符 fd中. 返回实际写入的字符串长度

shutil 的必要性

Ref: 11.10. shutil — High-level file operations

  File Folder
创建 os.mknod() os.makedirs()
打开 os.open() os.listidr()
删除 os.remove() shutil.rmtree()
拷贝 shutil.copyfile() shutil.copytree()
移动 shutil.move()

文件夹中的文件


一、路径解析

先进入 workspace

# 获取自己的路径
os.getcwd()      # 获得当前工作目录

# 到达路径
os.chdir(dirname)   # 改变工作目录到dirname

获得目录树

子目录遍历

# 01. 获取路径列表
os.listdir(dirname):列出dirname下的目录和文件 # 02. 判断类型
os.path.isdir(name):判断name是不是目录,不是目录就返回false
os.path.isfile(name):判断name这个文件是否存在,不存在返回false

# 可替代如下这个:
os.path.exists(name):判断是否存在文件或目录name

套路三步:路径存在?是文件?可读?

# 套路三步:路径存在?是文件?可读?
if path.exists(filePath) and path.isfile(filePath) and access(filePath, R_OK):
  print( "Debug: File exists and is readable.")
else:
  print( "Debug: Either file is missing or is not readable")

深层次目录遍历

利用os.walk() 处理 嵌套、深度不等文件夹下的目录树。

# reference http://*.com/a/9728478/992834

import os

def list_files(startpath):
for root, dirs, files in os.walk(startpath):
print(root)
level = root.replace(startpath, '').count(os.sep)
indent = ' ' * 4 * (level)
print('{}{}/'.format(indent, os.path.basename(root)))
subindent = ' ' * 4 * (level + 1)
for f in files:
print('{}{}'.format(subindent, f)) list_files("./")

Output:

$ python tree.py
./
/
tree.py
./dir
dir/
./dir/dir2
dir2/
file2.txt
./dir/dir2/dir4
dir4/
file3.txt
./dir/dir2/dir4/dir5
dir5/
file5.txt
file6.txt
./dir/dir3
dir3/
file1.txt

获取 file path

第一步,提取出文件全名;

第二步,"分割文件名" 和 "扩展名"。

os.path.split()          #返回一个路径的目录名和文件名
可替代:
os.path.dirname()
os.path.basename() fileName, extension = os.path.splitext('Hello.jpg')
os.path.getsize(name)      #或得文件大小,如果name是目录返回0L
# 修改文件名后的“路径恢复”
os.path.join(path,name)     #连接目录与文件名或目录

二、路径筛选

listdir(...) + 正则筛选

from os import listdir
from os.path import isfile, join import os
import re ################################################################################ g_dataDir = "data" ################################################################################ # Load all files.
dirPath = join(os.getcwd(), g_dataDir)
# !!!
filteredFiles = [f for f in listdir(dirPath) if isfile(join(dirPath, f)) and re.search(r'^[2]+',f)] # Jeff:
# 这里结合了正则表达式达到筛选的目的 ################################################################################ print("Files you want:")
print(filteredFiles)

sys模块


Ref: python之sys模块

退出处理

sys.exit(0)

exit() 看上去就是一种”异常“。

#!/usr/bin/python
import sys def exitfunc(value):
print (value)
sys.exit(0) print("hello") try:
sys.exit(90)
except SystemExit as value:
exitfunc(value) print("come?")

导入模块

sys.modules

导入模块的路径信息。

#!/usr/bin/python
import sys print(sys.modules.keys())
print("**************************************************************************")
print(sys.modules.values())
print("**************************************************************************")
print(sys.modules["os"]) 运行结果:
['copy_reg', 'sre_compile', '_sre', 'encodings', 'site', '__builtin__', 'sysconfig', '__main__', 'encodings.encodings', 'abc', 'posixpath', '_weakrefset', 'errno', 'encodings.codecs', 'sre_constants', 're', '_abcoll', 'types', '_codecs', 'encodings.__builtin__', '_warnings', 'genericpath', 'stat', 'zipimport', '_sysconfigdata', 'warnings', 'UserDict', 'encodings.ascii', 'sys', 'codecs', '_sysconfigdata_nd', 'os.path', 'sitecustomize', 'signal', 'traceback', 'linecache', 'posix', 'encodings.aliases', 'exceptions', 'sre_parse', 'os', '_weakref']
*******************************************************************************
[<module 'copy_reg' from '/usr/lib/python2.7/copy_reg.pyc'>, <module 'sre_compile' from '/usr/lib/python2.7/sre_compile.pyc'>, <module '_sre' (built-in)>, <module 'encodings' from '/usr/lib/python2.7/encodings/__init__.pyc'>, <module 'site' from '/usr/lib/python2.7/site.pyc'>, <module '__builtin__' (built-in)>, <module 'sysconfig' from '/usr/lib/python2.7/sysconfig.pyc'>, <module '__main__' from 'sys-test1.py'>, None, <module 'abc' from '/usr/lib/python2.7/abc.pyc'>, <module 'posixpath' from '/usr/lib/python2.7/posixpath.pyc'>, <module '_weakrefset' from '/usr/lib/python2.7/_weakrefset.pyc'>, <module 'errno' (built-in)>, None, <module 'sre_constants' from '/usr/lib/python2.7/sre_constants.pyc'>, <module 're' from '/usr/lib/python2.7/re.pyc'>, <module '_abcoll' from '/usr/lib/python2.7/_abcoll.pyc'>, <module 'types' from '/usr/lib/python2.7/types.pyc'>, <module '_codecs' (built-in)>, None, <module '_warnings' (built-in)>, <module 'genericpath' from '/usr/lib/python2.7/genericpath.pyc'>, <module 'stat' from '/usr/lib/python2.7/stat.pyc'>, <module 'zipimport' (built-in)>, <module '_sysconfigdata' from '/usr/lib/python2.7/_sysconfigdata.pyc'>, <module 'warnings' from '/usr/lib/python2.7/warnings.pyc'>, <module 'UserDict' from '/usr/lib/python2.7/UserDict.pyc'>, <module 'encodings.ascii' from '/usr/lib/python2.7/encodings/ascii.pyc'>, <module 'sys' (built-in)>, <module 'codecs' from '/usr/lib/python2.7/codecs.pyc'>, <module '_sysconfigdata_nd' from '/usr/lib/python2.7/plat-x86_64-linux-gnu/_sysconfigdata_nd.pyc'>, <module 'posixpath' from '/usr/lib/python2.7/posixpath.pyc'>, <module 'sitecustomize' from '/usr/lib/python2.7/sitecustomize.pyc'>, <module 'signal' (built-in)>, <module 'traceback' from '/usr/lib/python2.7/traceback.pyc'>, <module 'linecache' from '/usr/lib/python2.7/linecache.pyc'>, <module 'posix' (built-in)>, <module 'encodings.aliases' from '/usr/lib/python2.7/encodings/aliases.pyc'>, <module 'exceptions' (built-in)>, <module 'sre_parse' from '/usr/lib/python2.7/sre_parse.pyc'>, <module 'os' from '/usr/lib/python2.7/os.pyc'>, <module '_weakref' (built-in)>]
*******************************************************************************
<module 'os' from '/usr/lib/python2.7/os.pyc'>

标准输入, 输出, 出错

标准输入

#!/usr/bin/python
import sys
#print('Hi, %s!' %input('Please enter your name: ')) python3.*版本用input
print('Hi, %s!' %raw_input('Please enter your name: ')) #python2.*版本用raw_input
运行结果:
Please enter your name: er
Hi, er! --------------------------------------------------------------------------------
等同于:
#!/usr/bin/python
import sys
print('Please enter your name:')
name=sys.stdin.readline()[:-1]
print('Hi, %s!' %name)

标准输出

print('Hello World!\n')

--------------------------------------------
等同于:
#!/usr/bin/python
import sys
sys.stdout.write('output resule is good!\n')

其他实验

#!/usr/bin/python
import sys for i in (sys.stdin, sys.stdout, sys.stderr):
print(i) --------------------------------------------------
执行结果:
python sys-test1.py
<open file '<stdin>', mode 'r' at 0x7fa4e630f0c0>
<open file '<stdout>', mode 'w' at 0x7fa4e630f150>
<open file '<stderr>', mode 'w' at 0x7fa4e630f1e0>

End.