os

Этот модуль обеспечивает переносимый способ использования функций, зависящих от операционной системы. Если вы просто хотите прочитать или записать файл, см. open( ), если вы хотите манипулировать путями, см. модуль os.path, а если вы хотите прочитать все строки во всех файлах в командной строке, см. модуль fileinput . Для создания временных файлов и каталогов см. модуль tempfile, а для высокоуровневой обработки файлов и каталогов см. модуль shutil.

Примечание о доступности функций:

• Дизайн всех встроенных модулей Python, зависящих от операционной системы, таков, что, пока доступна одна и та же функциональность, он использует один и тот же интерфейс; например, функция os.stat (path) возвращает статистическую информацию о пути в том же формате (который, как оказалось, возник из интерфейса POSIX).

• Расширения, характерные для конкретной операционной системы, также доступны через модуль os, но их использование, конечно, угрожает переносимости.

• Все функции, принимающие путь или имена файлов, принимают как байтовые, так и строковые объекты и приводят к объекту того же типа, если возвращается путь или имя файла.

• В VxWorks os.fork, os.execv и os.spawn*p* не поддерживаются.

Все функции в этом модуле вызывают ошибку OSError (или ее подклассы) в случае недопустимых или недоступных имен файлов и путей или других аргументов, которые имеют правильный тип, но не принимаются операционной системой.

• os.error exception

• os.name ()

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

не заполнено...

Параметры процесса

Эти функции и элементы данных предоставляют информацию и работают с текущим процессом и пользователем.

• os.ctermid ()

• os.environ - словарь переменных окружения

• os.environb

• os.chdir () - функция описана ниже

• os.fchdir ()

• os.getcwd () - функция описана ниже

• os.fsencode ()

• os.fsdecode ()

• os.fspath ()

• os.PathLike class

• os.getenv () - возвращает значение ключа переменной среды

• os.getenvb ()

• не заполнено...

• os.getpid () - возвращает текущий идентификатор процесса

• os.getppid () - возвращает идентификатор родительского процесса

• не заполнено...

• os.putenv () - задает значение ключа для переменной среды

• не заполнено...

• os.uname ()

• os.unsetenv ()

Создание файлового объекта

Эти функции создают новые файловые объекты. (см. также os.open () для открытия файловых дескрипторов.)

• os.fdopen () - возвращает файловый объект, связанный с файловым дескриптором

Операции с файловым дескрипторами

Эти функции работают с потоками ввода-вывода, на которые ссылаются файловые дескрипторы.

Дескрипторы файлов - это небольшие целые числа, соответствующие файлу, который был открыт текущим процессом. Например, стандартный ввод - это дескриптор файла 0, стандартный вывод - 1, а стандартная ошибка - 2. Далее файлам, открытым процессом, будут присвоены 3, 4, 5 и т. д. Название «файловый дескриптор» немного обманчиво; на платформах Unix на сокеты и каналы также ссылаются файловые дескрипторы.

При необходимости метод fileno () может использоваться для получения дескриптора файла, связанного с файловым объектом. Обратите внимание, что использование файлового дескриптора напрямую приведет к обходу методов файлового объекта, игнорируя такие аспекты, как внутренняя буферизация данных.

• os.close () - закрывает файловый дескриптор

• os.closerange ()

• os._copy_file_range ()

• os.device_encoding ()

• os.dup ()

• os.dup2 () - копирует один файловый дескриптор в другой

• не заполнено...

• os.fstat ()

• os.fstatvfs ()

• os.fsync ()

• не заполнено...

• os.isatty () - открыт ли файловый дескриптор и подключен к tty?

• os.lockf ()

• os.F_LOCK

• os.F_TLOCK

• os.F_ULOCK

• os.F_TEST

• os.lseek () - устанавливает текущую позицию файлового дескриптора

• os.SEEK_SET - параметр функции os.lseek ()

• os.SEEK_CUR - параметр функции os.lseek ()

• os.SEEK_END - параметр функции os.lseek ()

• os.open () - открывает файл

• os.openpty ()

• не заполнено...

• os.pipe () - создает канал и возвращает пару файловых дескрипторов

• не заполнено...

• os.read () - читает байты из файлового дескриптора

• не заполнено...

• os.write () - записывает байтовую строку в файловый дескриптор

• os.writev ()

Файлы и директории

На некоторых платформах Unix многие из этих функций поддерживают одну или несколько из следующих возможностей:

• указание дескриптора файла: Обычно аргумент пути path, предоставляемый функциям в модуле os, должен быть строкой, определяющей путь к файлу. Однако некоторые функции теперь альтернативно принимают дескриптор открытого файла в качестве аргумента path. Затем функция будет работать с файлом, на который ссылается дескриптор. (Для систем POSIX Python вызовет вариант функции с префиксом f (например, вызовет fchdir вместо chdir).) Вы можете проверить, можно ли указать path как файловый дескриптор для конкретной функции на вашей платформе, используя os.supports_fd. Если эта функция недоступна, ее использование вызовет NotImplementedError. Если функция также поддерживает аргументы dir_fd или follow_symlinks, указывать один из них при указании пути в качестве дескриптора файла является ошибкой.

• пути относительно дескрипторов каталогов: если dir_fd не равно None, это должен быть дескриптор файла, ссылающийся на каталог, а путь для работы должен быть относительным; тогда путь будет относиться к этому каталогу. Если путь абсолютный, dir_fd игнорируется. (Для систем POSIX Python вызовет вариант функции с суффиксом at и, возможно, с префиксом f (например, вызов faccessat вместо access). Вы можете проверить, поддерживается ли dir_fd для конкретной функции на вашей платформе, используя os.supports_dir_fd. Если он недоступен, его использование вызовет NotImplementedError.

• не следовать символическим ссылкам: если follow_symlinks имеет значение False, а последний элемент пути для работы является символической ссылкой, функция будет работать с самой символической ссылкой, а не с файлом, на который указывает ссылка. (Для систем POSIX Python вызовет l... вариант функции.). Вы можете проверить, поддерживается ли follow_symlinks для конкретной функции на вашей платформе, используя os.supports_follow_symlinks. Если он недоступен, его использование вызовет NotImplementedError.

Описание функций для использования с файлами и директориями:

• os.access ()

• не заполнено...

• os.chdir () - изменяет текущую рабочую директорию на заданную

• os.chflags ()

• os.chmod () - изменяет режим доступа к файлу

• os.chown () - изменяет идентификатор владельца/группы файла

• os.chroot ()

• os.fchdir ()

• os.getcwd () - возвращает текущий рабочий каталог

• os.getcwdb ()

• os.lchflags ()

• os.lchmod ()

• os.lchown ()

• os.link ()

• os.listdir () - возвращает список, содержащий имена записей в каталоге

• os.lstat ()

• os.mkdir ()

• os.makedirs ()

• os.mkfifo () - создает именованный канал в заданном режиме

• не заполнено...

• os.remove () - удаляет файл или каталог по заданному пути (синоним unlink () )

• os.removedirs ()

• os.rename () - переименовывает файл или каталог

• os.renames ()

• os.replace ()

• os.rmdir ()

• os.scandir ()

• os.DirEntry class

• os.stat () - получает статистическую информацию о файле

• os.stat_result class - объект, атрибуты которого примерно соответствуют членам stat

• os.statvfs ()

• os.supports_dir_fd

• os.supports_effective_ids

• os.supports_fd

• os.supports_follow_symlinks

• не заполнено...

• os.unlink () - удаляет файл или каталог по заданному пути (синоним remove () )

• os.utime ()

• os.walk () - возвращает список файлов/подкаталогов рекурсивного обхода каталога

• os.fwalk ()

• os.memfd_create ()

• не заполнено...

Управление процессами

Эти функции могут использоваться для создания процессов и управления ими.

Различные функции exec* принимают список аргументов для новой программы, загруженной в процесс. В каждом случае первый из этих аргументов передается новой программе как ее собственное имя, а не как аргумент, который пользователь мог ввести в командной строке. Для программиста на C это argv[0], переданный в main () программы. Например, os.execv ('/bin/echo', ['foo', 'bar']) будет печатать только bar на стандартном выводе; foo будет казаться проигнорированным.

• os.abort ()

• os.add_dll_directory ()

• os.execl () - запускает новый процесс, заменяя текущий

• os.execle () - запускает новый процесс, заменяя текущий

• os.execlp () - запускает новый процесс, заменяя текущий

• os.execlpe () - запускает новый процесс, заменяя текущий

• os.execv () - запускает новый процесс, заменяя текущий

• os.execve () - запускает новый процесс, заменяя текущий

• os.execvp () - запускает новый процесс, заменяя текущий

• os.execvpe () - запускает новый процесс, заменяя текущий

• os._exit () - выходит из процесса с переданным статусом

• os.fork () - ответвляет дочерние процессы

• os.forkpty ()

• os.kill () - отправляет сигнал процессу, определенному идентификатором

• os.killpg ()

• os.nice ()

• os.plock ()

• os.popen () - открывает канал команды исполнения оболочки shell

• не заполнено...

• os.startfile () - запускает файл с помощью связанного с ним приложения

• os.system () - исполняет команду (строку) в новой оболочке shell

• не заполнено...

• os.waitpid () - дождаться завершения процесса, заданного идентификатором

• не заполнено...

• os.WNOHANG - немедленный возврат из waitpid(), если процесс недоступен

• не заполнено...

Интерфейс планировщика

Разные службы операционной системы

• os.confstr ()

• не заполнено...

• os.sysconf_names

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

• os.curdir - строка, используемая операционной системой для ссылки на текущий каталог

• os.pardir - строка, используемая операционной системой для ссылки на родительский каталог

• os.sep - символ, используемый операционной системой для разделения компонентов пути

• os.altsep

• os.extsep

• os.pathsep - символ разделения компонентов пути поиска в переменной окружения ОС

• os.defpath

• os.linesep - строка, используемая для разделения (завершения) строк на текущей платформе

• os.devnull

• не заполнено...

Случайные числа