Модуль os обеспечивает портативный способ использования функциональных возможностей, зависящих от операционной системы.
open(), os.path или pathlib, fileinput,tempfile,shutil.Примечания о доступности функций модуля os:
os.stat(path) возвращает статистическую информацию о пути в том же формате, который произошел от интерфейса POSIX.os, но их использование является угрозой переносимости ПО между системами.Заметка. Все функции в этом модуле поднимают исключение OSError или их подклассы в случае недопустимых или недоступных имен и путей к файлам или других аргументов, которые имеют правильный тип, но не принимаются операционной системой.
os.error:Исключение os.error это псевдоним для встроенного исключения OSError.
os.name:os.name это имя импортируемого модуля, зависящего от операционной системы. В настоящее время зарегистрированы следующие имена: 'posix', 'nt', 'java'.
Смотрите также sys.platform имеет более тонкую детализацию, os.uname() дает системно-зависимую информацию о версии системы. Модуль platform содержит подробные проверки идентичности системы.
В Python имена файлов, аргументы командной строки и переменные окружения представлены с использованием строкового типа. В некоторых системах, перед передачей их операционной системе необходимо декодирование строк в байты и обратно. Python использует кодировку файловой системы для выполнения этого преобразования (смотрите sys.getfilesystemencoding()).
В некоторых системах преобразование с использованием кодировки файловой системы может завершиться ошибкой. В этом случае Python использует обработчик ошибок кодирования surrogateescape. Это означает, что некодируемые байты заменяются символом Unicode U + DCxx при декодировании, и они снова преобразуются в исходный байт при кодировании.
Кодировка файловой системы должна гарантировать успешное декодирование всех байтов ниже 128. Если кодировка файловой системы не обеспечивает эту гарантию, функции API могут вызывать ошибки UnicodeErrors.
Управление переменными средами environment из кода Python. Переменные среды обычно используются для значений конфигурации, таких как пути поиска, расположение файлов и т.д.
Функция os.fsencode() кодирует имя файла filename в виде пути. Функция os.fsencode() декодирует имя файла filename в виде пути.
Функции для различных манипуляций с uid, gid и pid процесса. Чаще всего они используются авторами демонов или специальных системных программ, которым необходимо изменять уровень разрешений, а не запускаться от имени пользователя root.
Файловый дескриптор имеет "наследуемый" флаг, который указывает, может ли файловый дескриптор наследоваться дочерними процессами. Начиная с Python-3.4, файловые дескрипторы, созданные Python, по умолчанию не наследуются.
Создание файлового объекта средствами модуля os. Чтение, запись и закрытие файлового дескриптора, изменение прав доступа к нему. Получение статистики файлового дескриптора.
Функция listdir() модуля os возвращает список, содержащий имена файлов и директорий в каталоге, заданном путем path. Список приведен в произвольном порядке и не содержит специальных обозначений
Функция walk() модуля os генерирует имена файлов в дереве каталогов, обходя дерево сверху вниз или снизу вверх. Для каждого каталога в дереве с корнем в вершине каталога top, включая саму вершину top, она выдает тройной кортеж (dirpath, dirnames, filenames).
Функция scandir() модуля os возвращает итератор объектов os.DirEntry, соответствующих записям в каталоге, заданном путем path. Записи приводятся в произвольном порядке, а специальные символы '.' и '..' не включены.
Объект DirEntry() модуля os получается в результате работы функции os.scandir(). Методы объекта DirEntry() предоставляют пути к файлу и другие атрибуты файлов, расположенных в сканируемом каталоге.
Функция stat() модуля os получает статистическую информацию файла или дескриптора файла. Выполняет эквивалент системного вызова stat(). Функция stat() может поддерживать указание дескриптора файла и не следовать символическим ссылкам.
Объект stat_result модуля os имеет атрибуты, которые примерно соответствуют членам структуры системного вызова stat.
Функция `lstat()` модуля `os` выполняет эквивалент системного вызова `lstat() для данного пути. Похож на `os.stat()`, но не следует по символическим ссылкам.
Функция `access()` проверяет доступ к пути `path` для реальных `uid`/`gid`. Эту процедуру можно использовать в среде `suid`/`sgid` для проверки, имеет ли вызывающий пользователь указанный доступ к пути `path`
Функция `chdir()` модуля `os` изменяет текущий рабочий каталог.
Функция chmod() модуля os изменяет режим доступа к файлу или директории, указанного в path
Функция `chown()` изменяет владельца и идентификатор группы пути на числовые значения `uid` и `gid`
Функция `chroot()` модуля `os` изменяет корневой каталог текущего процесса на путь файловой системы `path`.
Функция `getcwd()` вернет строку, а функция `getcwdb()` вернет строку байтов представляющую текущий рабочий каталог.
Функция `link()` модуля `os` создает жесткую ссылку, указывающую на `src` с именем `dst`.
Функция `mkdir()` модуля `os` создает каталог с именем `path` с режимом доступа к нему `mode`. Режим `mode` устанавливается последними 3 цифрами восьмеричного представления режима.
Функция `makedirs()` модуля `os` рекурсивно создает все промежуточные каталоги, если они не существуют. Функция работает подобно `os.mkdir()`, но создает все каталоги промежуточного уровня
Функция `symlink()` модуля `os` создает символическую ссылку, указывающую на `src` с именем `dst`.
Функция `readlink()` модуля `os` вернет строку, представляющую путь, на который указывает символическая ссылка.
Функция remove() модуля os удаляет путь path к файлу. Если путь является каталогом, возникает исключение IsADirectoryError. Функция os.remove() семантически идентична os.unlink().
Функция removedirs() модуля os удаляет каталоги рекурсивно. Если конечный каталог успешно удален, os.removedirs() пытается последовательно удалить каждый родительский каталог, указанный в пути, до появления ошибки. Появления ошибки обычно означает, что родительский каталог не пуст.
Функция rename() модуля os переименовывает файл или каталог с именем src в dst. Если имя dst существует, операция, в ряде случаев, завершится с подклассом исключения OSError.
Функция `renames()` модуля `os` рекурсивно переименовывает пустые директории или переименовывает конечный файл.
Функция `replace()` модуля `os` переименовывает файл или пустой каталог с исходным именем `src` в `dst`.
Функция `rmdir()` модуля `os` удаляет путь к каталогу `path`. Если директория `path` не существует или не является пустым каталогом, то возникает исключение.
Функция strerror() модуля os возвращает сообщение об ошибке, соответствующее коду ошибки, которая появляется при сбое в коде приложения.
Функция `supports_dir_fd` модуля `os` возвращает объект `set`, указывающий, какие функции в модуле os принимают дескриптор открытого файла для своего параметра `dir_fd`.
Функция supports_effective_ids модуля os возвращает множество set, указывающее, разрешает ли функция os.access() указывать True для своего параметр аffective_ids на локальной платформе.
Функция `supports_fd` модуля `os` возвращает объект `set`, указывающий, какие функции в модуле os позволяют указывать параметр пути в качестве дескриптора открытого файла на локальной платформе.
Функция `os.supports_follow_symlinks()` возвращает множество `set`, которое указывает какие функции в модуле `os` принимают `False` для их параметра `follow_symlinks` на локальной платформе.
Функция truncate() модуля os обрезает файл, соответствующий пути path, так, чтобы он имел длину не более length байтов.
Функция `utime()` модуля `os` устанавливает/изменяет время доступа к файлу и время изменения файла, указанного в `path`.
Примером использования расширенных атрибутов OS Linux является реализация списков контроля доступа POSIX ACL.
Функция `abort()` модуля `os` генерирует сигнала `SIGABRT` для текущего процесса.
Все эти функции выполняют новую программу, заменяя текущий процесс. Они ничего не возвращают. В Unix новый исполняемый файл загружается в текущий процесс и будет иметь тот же идентификатор процесса, что и вызывающая программа. Ошибки будут сообщаться как исключения `OSError`.
Функция popen() модуля os откроет канал для чтения или записи стандартного ввода-вывода запущенной команды cmd.
Функция system() модуля os выполяет команду command в подоболочке (subshell). Это реализуется путем вызова стандартной функции языка Си system() и имеет те же ограничения.
Функция _exit() модуля os осуществляет выход из процесса со статусом n, без вызова обработчиков очистки, сброса буферов stdio и т. д.
Функция fork() модуля os форкает дочерний процесс. Возвращает 0 в дочернем элементе и идентификатор дочернего процесса в родительском элементе.
Функция `kill()` модуля `os` послает сигнал `sig` на процессу `pid`.
Функции os.spawn*() запускают программу, расположенную по указанному пути в файловой системе в новом процессе.
Функция `umask()` модуля `os` устанавливает текущий `umask` пользователя в числовое значение `mask` и возвращает предыдущий `umask`.
Функция os.uname() возвращает информацию, идентифицирующую текущую операционную систему. Возвращаемое значение - это объект с пятью атрибутами
Функция os.wait() возвращает идентификатор процесса и код завершения, упакованный в 16-битовое значение. Младший байт представляет номер сигнала, прекратившего выполнение процесса, а старший - код состояния, возвращенный процессом по его завершении.
Функция waitpid() модуля os в Unix: ждет завершения дочернего процесса, заданного идентификатором процесса pid, и возвращает кортеж, содержащий его идентификатор процесса и индикацию состояния выхода, закодированную как для os.wait().
Следующие функции принимают в качестве параметра status код состояния процесса, возвращаемый os.system(), os.wait() или os.waitpid(). Они могут быть использованы для определения диспозиции процесса.
Значения используемые для поддержки операций с путями.
Генерация случайных байтов операционной системой.
Функция startfile() модуля os запускает файл в Windows с помощью связанного с ним приложения на основе расширения.
Функция times() модуля os возвращает текущее время глобального процесса.
В этом разделе представлены функции определения количества ядер сервера и уровня загрузки системы (load average).
Функция waitstatus_to_exitcode() модуля os преобразует статус ожидания в код выхода.
Новое в Python 3.12. Функция os.listdrives() модуля os возвращает список, содержащий имена дисков в системе Windows.
Новое в версии Python 3.12. Функция os.listmounts() модуля os возвращает список, содержащий точки монтирования тома volume в системе Windows.
Новое в Python 3.12. Функция os.listvolumes() модуля os возвращает список, содержащий тома в системе Windows.