справочник по Python. мм isbn 9785932861578 9 785932 861578
 Скачать 4.21 Mb.
|
|
467 Модуль msvcrt М одуль msvcrt предоставляет доступ к множеству интересных функций из библиотеки времени выполнения Microsoft Visual C. Этот модуль доступен только в Windows. getch() Считывает нажатую клавишу и возвращает соответствующий символ. Этот вызов блокируется в ожидании нажатия клавиши. Если нажата специальная функциональная клавиша, функция возвращает ‘\000’ или ‘\xe0’ , а следующий ее вызов возвращает код клавиши. Эта функция не вы- водит эхо-символы в консоль и не может использоваться для чтения ком- бинации Ctrl+C getwch() То же, что и getch(), за исключением того, что возвращает символ Юнико- да. getche() То же, что и getch(), за исключением того, что выводит эхо-символ (если он печатаемый). getwche() То же, что и getche(), за исключением того, что возвращает символ Юни- за исключением того, что возвращает символ Юни- исключением того, что возвращает символ Юни- исключением того, что возвращает символ Юни- того, что возвращает символ Юни- того, что возвращает символ Юни- , что возвращает символ Юни- что возвращает символ Юни- возвращает символ Юни- возвращает символ Юни- символ Юни- символ Юни- Юни- Юни- кода. get_osfhandle(fd) Возвращает числовой идентификатор для дескриптора файла fd. Возбуж- дает исключение IOError, если fd не соответствует известному дескриптору файла. heapmin() Принуждает внутреннего диспетчера памяти Python вернуть неиспользуе- Python вернуть неиспользуе- вернуть неиспользуе- мые блоки операционной системе. Работает только в Windows NT и в слу- Windows NT и в слу- NT и в слу- NT и в слу- и в слу- чае ошибки возбуждает исключение IOError. kbhit() Возвращает True, если во входном буфере клавиатуры присутствуют до- ступные для чтения данные. locking(fd, mode, nbytes) Блокирует часть файла, соответствующего дескриптору fd, созданному средствами библиотеки времени выполнения языка C. В аргументе nbytes передается протяженность блокируемой области в байтах, начиная от те- кущей позиции в файле. Аргумент mode может принимать одно из следую- щих целочисленных значений: Значение Описание 0 Разблокирует область файла (LK_UNLCK) 1 Блокирует область файла (LK_LOCK) 468 Глава 19. Службы операционной системы Значение Описание 2 Б локирует область файла. Устанавливает неблокирующий режим (LK_NBLCK) 3 Блокирует область файла для записи (LK_RLCK) 4 Блокирует область файла для записи. Устанавливает неблокирую- щий режим (LK_NBRLCK) Попытка удерживать блокировку больше 10 секунд приведет к исключе- нию IOError. open_osfhandle(handle, flags) Создает дескриптор файла средствами библиотеки времени выполнения языка C из числового идентификатора handle. В аргументе flags передается битная маска, составленная из значений os.O_APPEND, os.O_RDONLY и os.O_TEXT, объединенных битовой операцией ИЛИ. Возвращает целочисленный фай- ловый дескриптор, который можно передать функции os.fdopen() для соз- дания объекта файла. putch(char) Выводит символ char в консоль без буферизации. putwch(char) То же, что и putch(), за исключением того, что в аргументе char передается символ Юникода. setmode(fd, flags) Устанавливает режим преобразования символов завершения строки для де- скриптора файла fd. Аргумент flags может принимать значения os.O_TEXT – для текстового режима и os.O_BINARY – для двоичного режима. ungetch(char) «Возвращает» символ обратно в буфер консоли. Этот символ будет первым символом, доступным функциям getch() и getche(). ungetwch(char) То же, что и ungetch(), за исключением того, что в аргументе char передается символ Юникода. Примечание Существует большое разнообразие расширений для платформы Win32, обеспе- Win32, обеспе- 32, обеспе- чивающих доступ к библиотеке Microsoft Foundation Classes, компонентам COM, визуальным элементам графического интерфейса пользователя и так далее. Эти темы выходят далеко за рамки данной книги, однако подробное описание многих из них можно найти в книге Марка Хаммонда (Mark Hammond) и Энди Робинсона (Andy Robinson) «Python Programming on Win32» (O’Reilly & Associates, 2000). Кро- Andy Robinson) «Python Programming on Win32» (O’Reilly & Associates, 2000). Кро- Robinson) «Python Programming on Win32» (O’Reilly & Associates, 2000). Кро- Robinson) «Python Programming on Win32» (O’Reilly & Associates, 2000). Кро- ) «Python Programming on Win32» (O’Reilly & Associates, 2000). Кро- Python Programming on Win32» (O’Reilly & Associates, 2000). Кро- Programming on Win32» (O’Reilly & Associates, 2000). Кро- Programming on Win32» (O’Reilly & Associates, 2000). Кро- on Win32» (O’Reilly & Associates, 2000). Кро- on Win32» (O’Reilly & Associates, 2000). Кро- Win32» (O’Reilly & Associates, 2000). Кро- Win32» (O’Reilly & Associates, 2000). Кро- 32» (O’Reilly & Associates, 2000). Кро- O’Reilly & Associates, 2000). Кро- ’Reilly & Associates, 2000). Кро- Reilly & Associates, 2000). Кро- & Associates, 2000). Кро- Associates, 2000). Кро- , 2000). Кро- ме того, на сайте http://www.python.org можно найти обширный список сторонних модулей для использования на платформе Windows. (продолжение) Модуль optparse 469 См. также Описание модуля winreg (стр. 511). Модуль optparse М одуль optparse обеспечивает высокоуровневую поддержку обработки параметров командной строки в стиле UNIX, которые передаются в пере- UNIX, которые передаются в пере- , которые передаются в пере- менной sys.argv. Простой пример использования этого модуля приводится в главе 9. Использование модуля optparse в основном сводится к использо- ванию класса OptionParser. OptionParser([**args]) Создает и возвращает новый анализатор параметров командной строки – экземпляр класса OptionParser. Может принимать самые разные именован- ные аргументы, определяющие настройки анализатора. Эти именованные аргументы описаны в следующем списке: Именованный аргумент Описание add_help_option Указывает, поддерживается ли специальный параметр вывода справки (--help и -h). По умолчанию получает значение True. conflict_handler Определяет порядок обработки конфликтующих параметров командной строки. Может принимать значение ‘error’ (по умолчанию) или ‘resolve’. Если указано значение ‘error’, при добавлении в анализатор конфликтующих строк параметров возбуждается исключение optparse.OptionConflictError. Если указано значение ‘resolve’, конфликты разрешаются так, что параметр, добавленный позднее, имеет более высокий приоритет. При этом ранее добавленные параметры также могут оставаться доступными, если они были добавлены под несколькими именами, из которых хотя бы для одного не об- наруживается конфликтов. description Строка с описанием, которая отображается при выводе справ- ки. Эта строка автоматически форматируется так, чтобы уме- ститься по ширине экрана. formatter Экземпляр класса optparse.HelpFormatter, используемый для форматирования текста при выводе справки. Может иметь значение optparse.IndentedHelpFormatter (по умолчанию) или optparse.TitledHelpFormatter option_class Класс на языке Python, который используется для хранения информации о каждом параметре командной строки. По умол- чанию используется класс optparse.Option. option_list Список параметров, используемый для заполнения анализато- ра. По умолчанию этот список пуст, а добавление параметров осуществляется с помощью метода add_option(). В противном случае этот список должен содержать объекты типа Option. 470 Глава 19. Службы операционной системы Именованный аргумент Описание prog Имя программы, которое будет использоваться вместо ‘%prog’ в тексте справки. usage Строка со справочной информацией об использовании при- ложения, которая выводится в ответ на использование пара- метра --help или при встрече недопустимого параметра. По умолчанию используется строка ‘%prog [options]’, где элемент ‘%prog’ замещается либо значением, возвращаемым функцией os.path.basename(sys.argv[0]) , либо значением именованного аргумента prog (если было указано). Чтобы подавить вывод сообщения об использовании приложения, можно передать значение optparse.SUPPRESS_USAGE version Строка с номером версии, которая выводится в ответ на ис- пользование параметра --version. По умолчанию получает зна- чение None, а параметр --version не добавляется в анализатор. Когда в этом аргументе указывается иное значение, параметр --version добавляется автоматически. В строке может при- сутствовать специальный элемент ‘%prog’ , который будет за- мещен именем программы. Когда не требуется выполнять нестандартную настройку обработки пара- метров командной строки, экземпляр класса OptionParser обычно создается вызовом функции без аргументов. Например: p = optparse.OptionParser() Экземпляр p класса OptionParser поддерживает следующие методы: p.add_option(name1, ..., nameN [, **parms]) Добавляет новый параметр в объект p. Аргументы name1, name2 и так далее представляют различные имена параметров. Например, можно указывать короткие и длинные имена параметров, такие как ‘-f’ и ‘—file’. Вслед за именами параметров могут следовать необязательные именованные аргу- менты, которые определяют порядок обработки параметров при их встрече в командной строке. Эти именованные аргументы описаны в следующем списке: Именованный аргумент Описание action Действие, выполняемое при анализе параметра. Допустимыми являются следующие значения: ‘store’ – требуется прочитать и сохранить аргумент параметра. Это значение используется по умолчанию, если явно не было указано никакого другого. ‘store_const’ – параметр не имеет аргументов, но когда он встречается, требуется сохранить значение константы, указан- ное в именованном аргументе const (продолжение) Модуль optparse 471 Именованный аргумент Описание ‘store_true’ – действует так же, как и ‘store_const’, но при встре- че параметра сохраняет логическое значение True ‘store_false’ – действует так же, как и ‘store_true’, но при встре- че параметра сохраняет логическое значение False. ‘append’ – параметр имеет аргумент, который должен быть до- бавлен в конец списка, когда он встречается. Применяется, когда в командной строке используется несколько одинаковых параметров, с целью обеспечить возможность передачи не- скольких значений. ‘count’ – параметр не имеет аргументов, но когда он встречает- ся, требуется сохранить значение счетчика. Значение счетчика увеличивается на 1 всякий раз, когда встречается один и тот же параметр. ‘callback’ – при встрече параметра требуется вызвать функ- цию обратного вызова, указанную в именованном аргументе callback ‘help’ – при встрече параметра требуется вывести справочное сообщение. Это необходимо, только если требуется обеспечить вывод справочной информации с помощью другого параметра, отличного от стандартных -h и --help ‘version’ – при встрече параметра требуется вывести номер вер- сии, переданный функции OptionParser(). Это необходимо, толь- ко если требуется обеспечить вывод номера версии с помощью другого параметра, отличного от стандартных -v и --version. callback Определяет функцию обратного вызова, которая должна вы- зываться при встрече параметра. В качестве функции можно использовать любой вызываемый объект Python, который вы- зывается как callback(option, opt_str, value, parser, *args, **kwargs). В аргументе option передается экземпляр класса optparse.Option , в аргументе opt_str – строка с параметром из ко- мандной строки, который вызвал обращение к функции, в ар- гументе value – значение параметра (если имеется), в аргументе parser – действующий экземпляр класса OptionParser, в аргумен- те args – позиционные аргументы, переданные в именованном аргументе callback_args, и в аргументе kwargs – именованные ар- гументы, переданные в именованном аргументеcallback_kwargs . callback_args Необязательный позиционный аргумент, который должен пере- даваться функции, указанной в аргументе callback. callback_kwargs Необязательный именованный аргумент, который должен пере- даваться функции, указанной в аргументе callback. choices Список строк, которые определяют все возможные значения параметра. Используется, только когда параметр может при- нимать ограниченный набор значений аргумента (например, [‘small’, ‘medium’, ‘large’] ). 472 Глава 19. Службы операционной системы Именованный аргумент Описание const Значение константы, которое сохраняется действием ‘store_ const’ default Устанавливает значение параметра по умолчанию, если он от- сутствует в командной строке. По умолчанию используется значение None. dest Определяет имя атрибута, который будет использоваться для сохранения значения параметра командной строки. Обычно ис- пользуется имя, соответствующее имени самого параметра. help Пояснительный текст для данного параметра. Если не указан, при выводе справки параметр будет перечислен без дополни- тельного описания. Для сокрытия параметра можно исполь- зовать значение optparse.SUPPRESS_HELP. В этом тексте может присутствовать специальный элемент ‘%default’, который будет замещен значением аргумента default. metavar Определяет имя аргумента параметра, которое будет использо- ваться при выводе справочного текста. nargs Определяет количество аргументов параметра для действий, которые предполагают наличие аргументов. По умолчанию принимает значение 1. Если это число больше 1, аргументы па- раметра будут собраны в кортеж, который затем можно будет использовать при обработке. type Определяет тип параметра. Допустимыми являются следую- тип параметра. Допустимыми являются следую- тип параметра. Допустимыми являются следую- параметра. Допустимыми являются следую- параметра. Допустимыми являются следую- . Допустимыми являются следую- Допустимыми являются следую- являются следую- являются следую- следую- следую- щие типы: ‘string’ (по умолчанию), ‘int’, ‘long’, ‘choice’, ‘float’ и ‘complex’. p.disable_interspersed_args() Запрещает смешивание простых параметров с позиционными аргумента- ми. Например, если ‘-x’ и ‘-y’ являются простыми параметрами, не имею- щими аргументов, эти параметры должны указываться перед любыми ар- гументами (например: ‘prog -x -y arg1 arg2 arg3’). p.enable_interspersed_args() Разрешает смешивание простых параметров с позиционными аргумента- ми. Например, если ‘-x’ и ‘-y’ являются простыми параметрами, не имею- щими аргументов, они могут смешиваться с позиционными аргументами, например: ‘prog -x arg1 arg2 -y arg3’. Это поведение по умолчанию. p.parse_args([arglist]) Анализирует параметры командной строки и возвращает кортеж (options, args) , где options – это объект, содержащий все параметры, а args – список всех оставшихся позиционных аргументов. Объект options хранит все дан- ные параметров в атрибутах с именами, соответствующими именам пара- метров. Например, информация о параметре ‘--output’ будет храниться в атрибуте options.output. Если параметр не был указан в командной стро- (продолжение) Модуль optparse 473 ке, его значением будет None. Имя атрибута может быть определено с помо- щью именованного аргумента dest в вызове метода add_option(), описанного выше. По умолчанию аргументы извлекаются из sys.argv[1:]. Однако в не- обязательном аргументе arglist можно определить другой источник аргу- ментов командной строки. p.set_defaults(dest=value, ... dest=value) Устанавливает значения по умолчанию для указанных параметров. Ме- тоду просто нужно передать именованные аргументы, определяющие па- раметры, для которых устанавливаются значения по умолчанию. Имена аргументов должны совпадать с именами, указанными в аргументе dest метода add_option(), описанного выше. p.set_usage(usage) Изменяет строку с текстом, описывающим порядок использования прило- жения, который выводится при использовании параметра --help. Пример # foo.py import optparse p = optparse.OptionParser() ёё # Простой параметр без аргументов p.add_option(“-t”, action=”store_true”, dest=”tracing”) ёё # Параметр, принимающий строковый аргумент p.add_option(“-o”, “--outfile”, action=”store”, type=”string”, dest=”outfile”) ёё # Параметр, принимающий целочисленный аргумент p.add_option(“-d”, “--debuglevel”, action=”store”, type=”int”, dest=”debug”) ёё # Параметр с небольшим числом допустимых значений аргумента p.add_option(“--speed”, action=”store”, type=”choice”, dest=”speed”, choices=[“slow”,”fast”,”ludicrous”]) ёё # Параметр, принимающий несколько аргументов p.add_option(“--coord”, action=”store”, type=”int”, dest=”coord”, nargs=2) ёё # Группа параметров, значения которых сохраняются в одном и том же атрибуте p.add_option(“--novice”, action=”store_const”, const=”novice”, dest=”mode”) p.add_option(“--guru”, action=”store_const”, const=”guru”, dest=”mode”) ёё # Установить значения по умолчанию для различных параметров p.set_defaults(tracing=False, debug=0, speed=”fast”, coord=(0,0), mode=”novice”) ёё # Проанализировать аргументы opt, args = p.parse_args() ёё # Вывести значения параметров print “tracing :”, opt.tracing |