os -- 操作系统交互

os – 操作系统交互

# -*- coding: utf-8 -*-
# @Author  : 空心(QQ: 2448545222)
# @Time    : 2022/11/9
# @File    : os-操作系统交互接口.py
# @IDE: PyCharm

'''
此文件中的 类和函数 均可看作是 os模块里面的对应注释

安装: 内置模块, 无需安装

导入: import os
'''

文件和目录操作

def makedirs(path: str, mode: int = 0o777, exist_ok: bool = False):
    r'''
    递归创建目录

    比如创建 D:\\a\b\c\d\e\f, 其中不存在的目录都会被创建

    :param path: 要创建的目录路径 (相对 or 绝对)
    :param mode: (可选) 新创建目录的模式; 默认就行 我也不知道有什么其他的数字可以换
    :param exist_ok: (可选) True(如果创建目录失败,则pass) or False(默认; 如果创建目录失败,则报错.)
                    失败的情况例: 目录已存在, 没有权限等
    :return:
    '''

---

def listdir(path: str) -> list:
    '''
    获取 目录下 所有目录和文件 (不会递归获取)

    :param path: 目录路径 (相对 or 绝对); (如不存在则报错)
    :return: 所有目录和文件
    '''

---

def walk(path: str):
    '''
    获取 目录下 所有 目录和文件 (递归获取)

    生成器内部首先会 遍历path 然后依次遍历其中所有的子孙..目录
    每次next(生成器)会返回:
        ('目录的绝对路径', ['所包含的目录名',..], ['所包含的文件名',..])

    示例: 获取 某目录下所有 .xx结尾文件的 绝对路径
        for path, dir_list, file_name_list in os.walk('路径'):
            for file_name in file_name_list:
                if file_name.split('.')[-1] == '后缀名':
                    print(os.path.join(path, file_name))

    :param path: 目录路径; 如不存在或传入文件路径 也会返回 生成器, 但是里面是空的
    :return: 生成器
    '''

---

def remove(path: str):
    '''
    删除 文件; 只能删除文件;

    :param path: 文件路径 (相对 or 绝对); 如果没有或者传入目录路径会报错
    :return: None
    '''