21.5. filecmp - сравнение файлов и каталогов 287

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

report()

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

report partial closure()

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

report full closure()

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

left list

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

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

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

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

right only

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

common dirs

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

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

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

same files

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

diff files

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

funny files

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

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

Модуль доступен в операционных системах 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 они используются для реализации описанных выше функций):

subdirs

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

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

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

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

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

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

Popen3(cmd [, capturestderr [, bufsize]]) (UNIX)

Конструирует и возвращает объект, представляющий дочерний процесс. Если задан и является истиной аргумент capturestderr, возвращаемый объект будет перехватывать стандартный поток ошибок дочернего процесса. Аргумент bufsize указывает размер буфера потоков.

Popen4(cmd [, bufsize]) (UNIX)

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

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

poll()

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

wait()

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

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

tochild

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

childerr

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

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