Install in seconds
Install this skill
Copy the command and run it in your terminal. You can review the source before installing.
terminal
git clone https://github.com/CoderWanFeng/python-office

Works with Git. The repository opens in your current directory.

🔍
AutomationPython

Get Files

by CoderWanFeng

Search for files in a directory path returning a list of file paths, with options to filter by name, suffix, subdirectory, and depth level. Use when you need to programmatically list or find specific files.

1.3K stars297 forksAdded 2026/07/20
officepippypipythonweixin

Documentation

README

get_files Skill

搜索当前路径下所有指定类型的文件,并以列表形式返回

功能描述

在指定路径下搜索文件,支持按文件名、后缀、子目录等条件过滤,返回文件路径列表。

所属分类

office/skills/file/get_files/

调用方式

from office.skills.file import get_files

files = get_files(
    path='./data',
    name='report',
    suffix='.txt',
    sub=False,
    level=0
)

参数说明

参数 类型 必填 默认值 说明
path str - 路径
name str '' 文件名
suffix str None 文件后缀
sub bool False 是否搜索子目录
level int 0 搜索层级

返回值

list:文件路径列表

使用示例

from office.skills.file import get_files
# 获取所有 .txt 文件
txt_files = get_files(path='./docs', suffix='.txt', sub=True)
# 获取所有名为 report 的文件
reports = get_files(path='./data', name='report', sub=True)

原始函数

office.api.file.get_files