Функция listdir() модуля os в Python

Получить список файлов в директории/каталоге

Синтаксис:

import os

os.listdir(path='.')

Параметры:

• path - путь в виде строки или дескриптор каталога.

Возвращаемое значение:

• список имен файлов в каталоге.

Описание:

Функция listdir() модуля os возвращает список, содержащий имена файлов и директорий в каталоге, заданном путем path. Список будет в произвольном порядке и не содержит специальных обозначений '.' и '..', даже если они присутствуют в каталоге.

Аргумент path принимает объекты, реализующих интерфейс os.PathLike. Если путь path имеет байтовый тип, переданный прямо или косвенно через интерфейс os.PathLike, возвращаемые имена файлов также будут байтовыми типами, во всех остальных случаях они будут иметь строковой тип.

Эта функция также поддерживает указание файлового дескриптора, дескриптор должен ссылаться на каталог path.

Вызывает событие аудита os.listdir с аргументом path.

Примеры получения списка имен файлов и директорий в каталоге.

import os

path = '.'

rez = sorted(os.listdir(path))
for n, item in enumerate(rez):
    print(n+1, item) 

# 1 docs-python-replace.py
# 2 reg-exp.py
# 3 script.py
# 4 sys.float_info.py
# 5 test-gid-uid.py
# 6 test_settracel.py
# 7 tt.py
# 8 venv

Что бы получить полный путь к файлам каталога нужно просто объединить передаваемый аргумент path с каждым значением из списка внутри цикла for ... in, например item = os.path.join(path, item)

Смотрите так же:

• os.scandir() - информация о всех файлах/каталогах, включая их имена,
• os.walk() - рекурсивный обход каталога как в глубину, так и из глубины,
• glob.glob() - рекурсивный (в глубину) поиск файлов по шаблону,
• pathlib.Path.glob() - рекурсивный (в глубину) отбор файлов из каталога по шаблону.