[ Россум, Дрейк, Откидач ] Язык программирования Python

dirname(path)

Возвращает имя каталога в пути path. Это первый элемент пары split(path).

exists(path)

Возвращает 1, если путь с именем path (файл или каталог) существует, иначе возвращает 0.

expanduser(path)

Возвращает аргумент с компонентом вида ‘~’ или ‘~user’, замененным домашним каталогом пользователя. ‘~’ заменяется значением переменной окружения HOME, поиск имени домашнего каталога для пользователя user производится с помощью модуля pwd. Если замена по каким-либо причинам не может быть произведена или путь не начинается с символа ‘~’, возвращает path без изменений.

expandvars(path)

Возвращает аргумент с компонентами вида ‘$name’ и ‘${name}’, замененными значением переменной окружения name. Некорректные имена и имена, ссылающиеся на неопределенные переменные, оставляются в строке path без изменений. При использовании ОС Macintosh всегда возвращает path без изменений.

getatime(path)

Возвращает время (число секунд с начала эпохи, см. описание модуля time) последнего доступа к файлу (каталогу) path. Генерирует исключение IOError, если файл не существует или не доступен.

getmtime(path)

Возвращает время (число секунд с начала эпохи, см. описание модуля time) последнего внесения изменений в файл (каталог) path. Генерирует исключение IOError, если файл не существует или не доступен.

getsize(path)

Возвращает размер в байтах файла (каталога) path. Генерирует исключение IOError, если файл не существует или не доступен.

isabs(path)

Возвращает 1, если путь path является абсолютным.

isfile(path)

Возвращает 1, если путь path указывает на существующий обычный файл, иначе возвращает 0. Эта функция следует символическим ссылкам, то есть функции islink() и isfile() могут обе возвращать истину для одного и того же пути.

isdir(path)

Возвращает 1, если путь path указывает на существующий каталог, иначе возвращает 0. Эта функция следует символическим ссылкам, то есть функции islink() и isdir() могут обе возвращать истину для одного и того же пути.

islink(path)

Возвращает 1, если путь path является символической ссылкой, иначе возвращает 0. Всегда возвращает 0, если символические ссылки не поддерживаются.

ismount(path)

Возвращает 1, если путь path является точкой монтирования, то есть каталог path и родительский для него каталог находятся на разных устройствах (разделах) или ссылаются на один и тот же узел (i-node) одного устройства.

join(path1 [, path2 ...])

Объединяет компоненты пути. Если какой-либо компонент является абсолютным путем, все предыдущие компоненты отбрасываются и объединение продолжается. Возвращаемое значение является объединением всех непустых строк path1, path2 и т. д., в качестве разделителя используется os.sep. Если последний аргумент является пустой строкой, результат заканчивается символом os.sep.

normcase(path)

Возвращает path с нормализованным регистром букв. На платформах UNIX возвращает аргумент без изменений. Для файловых систем, нечувствительных к регистру букв, преобразует все буквы к нижнему регистру. Под Windows также заменяет символы косой черты (os.altsep) на символы обратной косой черты (os.sep).

normpath(path)

Возвращает нормализованное имя пути path. Эта функция сворачивает излишние разделители и ссылки на текущий и родительский каталоги, то есть имена путей ’A//B’, ’A/./B’ и ’A/foo/../B’ преобразуются к ’A/B’. Под Windows также заменяет символы косой черты (os.altsep) на символы обратной косой черты (os.sep). Функция normpath() не нормализует регистр букв — для этих целей используйте функцию normcase().

Возвращает 1, если файловые объекты file1 и file2 ссылаются на один и тот же файл (файловые объекты могут представлять разные файловые дескрипторы), иначе возвращает 0.

samestat(stat1, stat2) (UNIX, Macintosh) Возвращает 1, если кортежи stat1 и stat2 (результат, возвращаемый функциями fstat(), lstat() и stat()) ссылаются на один и тот же файл.

split(path)

Разбивает имя пути path на пару строк ‘(head, tail)’, где tail — последний компонент пути и head — остальная часть пути. tail никогда не содержит символа os.sep: если путь path заканчивается этим символом, tail будет пустой строкой. Завершающие символы os.sep в head отбрасываются, за исключением случаев, когда path ссылается на корневой каталог. В любом случае ‘join(head, tail)’ дает путь, эквивалентный path.

splitdrive(path)

Разбивает имя пути path на пару строк ‘(drive, tail)’, где drive — спецификатор логического диска или пустая строка и head — остальная часть пути. В системах, которые не используют спецификаторы логических дисков drive всегда является пустой строкой. В любом случае выражение ‘drive + tail == path’ всегда верно.

splitext(path)

Разбивает имя пути path на пару строк ‘(root, ext)’ так, чтобы выполнялось условие ‘root + ext == path’ и строка ext была пустой или начиналась с точки и содержала не более одной точки.

walk(path, visit, arg)

Вызывает ‘visit(arg, dirname, names)’ для каждого каталога в дереве, начиная с path (включая каталог path). Аргумент dirname указывает имя каталога, для которого вызывается функция visit, а names является списком файлов и каталогов в каталоге dirname (os.listdir(dirname), то есть используется путь относительно каталога dirname). Функция visit может вносить изменения в names и, тем самым, оказывать влияние на то, какие каталоги будут посещаться далее по дереву, то есть чтобы избежать посещения каких-либо частей дерева каталогов.

21.3stat — интерпретация os.stat()

Этот модуль определяет константы и функции, необходимые для интерпретации элементов кортежа ‘(st_mode, st_ino, st_dev, st_nlink, st_uid, st_gid,

st_size, st_atime, st_mtime, st_ctime ...)’, возвращаемого функциями

os.stat(), os.lstat() и os.fstat().

S_ISDIR(st_mode)

Истина, если аргумент st_mode получен для каталога.

S_ISCHR(st_mode)

Истина, если аргумент st_mode получен для специального файла, представляющего устройство посимвольного ввода/вывода.

S_ISBLK(st_mode)

Истина, если аргумент st_mode получен для специального файла, представляющего блочное устройство.

S_ISREG(st_mode)

Истина, если аргумент st_mode получен для обычного файла.

S_ISFIFO(st_mode)

Истина, если аргумент st_mode получен для именованного канала (FIFO).

S_ISLNK(st_mode)

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

S_ISSOCK(st_mode)

Истина, если аргумент st_mode получен для канала сетевого соединения (socket).

S_IMODE(st_mode)

Возвращает часть состояния, которую можно установить с помощью функции os.chmod() — доступ, sticky bit, set-group-id и set-user-id.

S_IFMT(st_mode)

Возвращает часть состояния, описывающую тип файла (используется функциями S_IS*(), описанными выше).

Обычно гораздо удобнее воспользоваться функциями os.path.is*() (см. описание модуля os.path) для определения типа файла. Описанные в этом разделе функции полезны в тех случаях, когда необходимо выполнить несколько проверок для одного и того же файла, и Вы хотите избежать накладных расходов на вызов системной функции stat() для каждой проверки.

Следующие переменные являются символическими индексами для кортежа, возвращаемого функциями os.stat(), os.fstat() и os.lstat().

ST_MODE

Режим защиты файла.

ST_INO

Внутренний номер файла (i-node).

ST_DEV

Номер устройства, на котором файл расположен.

ST_NLINK

Количество (жестких) ссылок на файл.

ST_UID

Идентификатор пользователя-владельца.

ST_GID

Идентификатор группы-владельца.

ST_SIZE

Размер файла в байтах.

ST_ATIME

Время последнего доступа.

ST_MTIME

Время последнего внесения изменений.

ST_CTIME

Время последнего изменения статуса.

Приведем простой пример:

import os, sys from stat import *

def visit(arg, dir, names): for name in names:

fullname = os.path.join(dir, name) mode = os.stat(fullname)[ST_MODE] if S_ISDIR(mode):

print ’лБФБМПЗ’, fullname elif S_ISREG(mode):

print ’пВЩЮОЩК ЖБКМ’, fullname else:

print ’жБКМ ОЕЙЪЧЕУФОПЗП ФЙРБ’, fullname

if __name__ == ’__main__’: os.path.walk(sys.argv[1], visit, None)

21.4statvfs — интерпретация os.statvfs()

Каждая из констант, определенных в этом модуле является индексом элемента кортежа, возвращаемого функцией os.statvfs(), содержащего определенную информацию. Использование этих констант позволяет избежать необходимости помнить “магические индексы”.

F_BSIZE

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

F_FRSIZE

Основной размер блоков для данной файловой системы.

F_BLOCKS

Общее число блоков.

F_BFREE

Число свободных блоков.

F_BAVAIL

Число свободных блоков, доступных рядовому пользователю.

F_FILES

Общее число файловых узлов (то есть максимальное возможное число файлов).

Экземпляры класса dircmp имеют следующие методы и атрибуты данных:

report()

Выводит на стандартный поток вывода (sys.stdout) подробный отчет о сравнении каталогов.

report_partial_closure()

Выводит на стандартный поток вывода (sys.stdout) подробный отчет о сравнении каталогов и одного уровня вложенных каталогов.

report_full_closure()

Выводит на стандартный поток вывода (sys.stdout) подробный отчет о сравнении каталогов и рекурсивно всех вложенных каталогов.

left_list

Список имен файлов и каталогов в dir1, не указанных в аргументе ignore.

right_list

Список имен файлов и каталогов в dir2, не указанных в аргументе ignore.

common

Список имен файлов и каталогов, которые присутствуют как в dir1, так и в dir2.

left_only

Список имен файлов и каталогов, которые присутствуют только в dir1.

right_only

Список имен файлов и каталогов, которые присутствуют только в dir2.

common_dirs

Список имен каталогов, которые присутствуют как в dir1, так и в dir2.

common_files

Список имен файлов, которые присутствуют как в dir1, так и в dir2.

common_funny

Список имен, найденных в обоих каталогах, но имеющих разный тип или дающих ошибку при вызове функции os.stat().

same_files

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

diff_files

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

funny_files

Список файлов, присутствующих в обоих каталогах, которые по каким-либо причинам не удается сравнить (например, к ним нет доступа).

subdirs

Словарь, отображающий имена каталогов из списка common_dirs в экземпляры класса dircmp для этих каталогов.

Заметим, что значения атрибутов вычисляются по мере необходимости, а не сразу при конструировании объекта. Это позволяет избежать излишних расходов при запросе значений только тех атрибутов, которые можно быстро вычислить. Однажды вычисленное значение сохраняется и используется при дальнейших запросах.

21.6popen2 — доступ к потокам ввода/вывода дочерних процессов

Модуль доступен в операционных системах UNIX и Windows (начиная с версии 2.0).

Модуль popen2 позволяет порождать подпроцессы и иметь доступ к их стандартным потокам ввода, вывода и ошибок. Во всех случаях команда выполняется в стандартном для данной платформы интерпретаторе команд (устанавливается переменной окружения SHELL в UNIX и COMSPEC в Windows). Заметим, что, начиная с версии 2.0, функциональность этого модуля доступна через одноименные функции модуля os, имеющие аналогичный интерфейс, но возвращающие кортеж с другим порядком следования элементов.

Основной интерфейс модуля представлен тремя функциями. Для всех функций аргумент bufsize определяет размер буфера каналов и mode (начиная с версии 2.0) — режим, в котором будут открыты каналы (’t’ — текстовый, используется по умолчанию, или ’b’ — двоичный).

popen2(cmd [, bufsize [, mode]])

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

popen3(cmd [, bufsize [, mode]])

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

popen4(cmd [, bufsize [, mode]])

Выполняет команду cmd в качестве дочернего процесса и возвращает кортеж из двух файловых объектов: соответствующий его объединенному потоку вывода и ошибок и стандартному потоку ввода. Функция доступна, начиная с версии 2.0.

Кроме того, модуль определяет следующие классы (на платформе UNIX они используются для реализации описанных выше функций):

Этот класс аналогичен классу Popen3, но всегда направляет стандартные потоки вывода и ошибок дочернего процесса в один файловый объект.

Экземпляры классов Popen3 и Popen4 имеют следующие методы и атрибуты данных:

poll()

Возвращает -1, если выполнение дочернего процесса еще не закончилось, в противном случае возвращает код завершения.

wait()

Ждет окончания выполнения дочернего процесса и возвращает код завершения.

fromchild

Файловый объект, представляющий стандартный поток вывода дочернего процесса. Для экземпляров класса Popen4 этот объект представляет объединение стандартных потоков вывода и ошибок дочернего процесса.

tochild

Файловый объект, представляющий стандартный поток ввода дочернего процесса.

childerr

Файловый объект, представляющий стандартный поток ошибок дочернего процесса, если аргумент capturestderr конструктора являлся истиной, иначе None. Для экземпляров класса Popen4 всегда равен None.

pid

Идентификатор дочернего процесса.

21.7time — определение и обработка времени

Модуль time предоставляет различные функции для работы со временем. Этот модуль всегда доступен, но не все функции определены для всех платформ.

Немного о терминологии и принятых соглашениях.

Отсчет времени начинается с начала эпохи, 0 часов 1 января определенного года. Для платформ UNIX это 1970 год. Чтобы определить начало эпохи для Вашей платформы, взгляните на gmtime(0).

Функции в этом модуле не могут работать с временем до начала эпохи и после некоторого момента в будущем. Последняя точка определяется библиотекой языка C, лежащей в основе реализации. Для платформы UNIX это обычно 2038 год.

Реализация библиотек Python зависит от библиотеки языка C для данной платформы, которая обычно не имеет проблем с 2000 годом, так как время представляется числом секунд, прошедших с начала эпохи. Функции, работающие с представлением времени в виде кортежа, как правило, требуют все четыре цифры года. Для совместимости с предыдущими версиями допускается использование двух цифр, если переменная accept2dyear не равна нулю. По умолчанию эта переменная равна 1, однако, если переменная окружения PYTHONY2K установлена и равна непустой строке, accept2dyear инициализируется нулем. Таким образом, Вы можете запретить использование только двух цифр, установив переменную окружения PYTHONY2K равной непустой строке.

Если представление года двумя цифрами воспринимается, оно преобразуется в соответствии со стандартами POSIX и X/Open: значения 69–99 преобразуются к 1969–1999 и 0–68 к 2000–2068. Значения 100–1899 в любом случае запрещены.

UTC — Universal Coordinated Time, универсальное синхронизированное время, известное также как GMT (Greenwich Mean Time, среднее время по Гринвичу).

DST — Daylight Saving Time, летнее время — корректировка часового пояса (обычно) на один час в течение части года. Правила перехода на летнее время определяются местными законами и могут меняться от года к году. Библиотека языка C имеет таблицу с локальными правилами и является в этом отношении единственным верным источником.

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

С другой стороны, точность функций time() и sleep() выше, чем точность одноименных функций библиотеки C на платформе UNIX: время в них выражается вещественным числом, функция time() наиболее точное время (используя функцию gettimeofday() языка C, если она доступна), функция sleep() воспринимает время с ненулевой дробной частью (используя функцию select() языка C, если она доступна).

Представление времени в виде кортежа, возвращаемое функциями gmtime(), localtime() и strptime() и воспринимаемое функциями asctime(), mktime() и strftime(), содержит 9 целочисленных элементов: