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

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

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