Функция chown() модуля shutil в Python

Изменить права доступа к файлу или каталогу

Синтаксис:

import shutil

shutil.chown(path, user=None, group=None, *, dir_fd=None, follow_symlinks=True)

Параметры:

• path - путь к файлу/каталогу (поддерживает указание пути относительно дескриптора каталога),
• user=None - пользователь,
• group=None - группа.
• dir_fd=None - дескриптор каталога (добавлен в Python 3.13),
• follow_symlinks=None - следовать ли символическим ссылкам (добавлен в Python 3.13).

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

• Нет.

Описание:

Функция chown() модуля shutil меняет владельца пользователя и/или группы по указанному пути.

Пользователь может быть системным именем пользователя или идентификатором пользователя. То же самое относится и к группе. Требуется хотя бы один аргумент.

Смотрите также базовую функцию os.chown().

Вызывает событие аудита shutil.chown с аргументами path, user, group.

Доступность: Unix.

Изменено в Python 3.13: добавлены параметры dir_fd и follow_symlinks.

Пример использования shutil.chown()

>>> import shutil, os
>>> os.mkdir('test_dir')
# пользователь с id 1000 и группа 'games' должны существовать
#  а учетная запись должна иметь право на изменение прав  
# доступа, иначе будет ошибка 'PermissionError'
>>> shutil.chown('test_dir', user=1000, group='games')