Содержание страницы
IDLE¶
Исходный код: Lib/idlelib/
IDLE – это интегрированная среда разработки и обучения Python.
IDLE имеет следующие возможности:
написан на 100% чистом Python с использованием GUI-тулкита
tkinterкроссплатформенность: в основном одинаково работает на Windows, Unix и macOS
окно оболочки Python (интерактивный интерпретатор) с цветовой подсветкой вводимого кода, вывода и сообщений об ошибках
многооконный текстовый редактор с множественной отменой, подсветкой синтаксиса Python, умными отступами, подсказками вызова, автозавершением и другими функциями
поиск в любом окне, замена в окнах редактора и поиск по нескольким файлам (grep)
отладчик с постоянными точками останова, пошаговым выполнением и просмотром глобального и локального пространства имён
настройки, обозреватели и другие диалоговые окна
Запуск и выполнение кода¶Startup and Code Execution
При запуске с опцией -s IDLE выполняет файл, на который ссылаются переменные среды IDLESTARTUP или PYTHONSTARTUP. IDLE сначала проверяет IDLESTARTUP; если IDLESTARTUP присутствует, запускается указанный файл. Если IDLESTARTUP отсутствует, IDLE проверяет PYTHONSTARTUP. Файлы, на которые ссылаются эти переменные среды, удобно использовать для хранения функций, часто используемых из Shell IDLE, или для выполнения операторов импорта общих модулей.
Кроме того, Tk также загружает файл запуска, если он существует. Обратите внимание, что Tk-файл загружается безусловно. Этот дополнительный файл – .Idle.py, он ищется в домашнем каталоге пользователя. Операторы в этом файле будут выполняться в пространстве имён Tk, поэтому этот файл не подходит для импорта функций, используемых из Python Shell IDLE.
Использование командной строки¶Command line usage
idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ...
-c command run command in the shell window
-d enable debugger and open shell window
-e open editor window
-h print help message with legal combinations and exit
-i open shell window
-r file run file in shell window
-s run $IDLESTARTUP or $PYTHONSTARTUP first, in shell window
-t title set title of shell window
- run stdin in shell (- must be last option before args)
Если есть аргументы:
Если используется
-,-cилиr, все аргументы помещаются вsys.argv[1:...], аsys.argv[0]устанавливается в'','-c'или'-r'. Окно редактора не открывается, даже если это выбрано по умолчанию в диалоге Options.В противном случае аргументы являются файлами, открытыми для редактирования, и
sys.argvотражает аргументы, переданные самому IDLE.
Сбой при запуске¶Startup failure
IDLE использует сокет для взаимодействия между процессом графического интерфейса IDLE и процессом выполнения пользовательского кода. Соединение должно устанавливаться при каждом запуске или перезапуске оболочки. (Последнее обозначается разделительной линией с надписью «RESTART»). Если пользовательский процесс не может подключиться к процессу GUI, обычно отображается диалоговое окно Tk с сообщением «cannot connect», которое направляет пользователя сюда. Затем процесс завершается.
Одна из конкретных причин сбоя соединения в Unix-системах – неверно настроенные правила маскарадинга в сетевых настройках системы. При запуске IDLE из терминала будет видно сообщение, начинающееся с ** Invalid host:. Допустимое значение – 127.0.0.1 (idlelib.rpc.LOCALHOST). Диагностику можно провести с помощью tcpconnect -irv 127.0.0.1 6543 в одном окне терминала и tcplisten <same args> в другом.
Частая причина сбоя – файл пользователя с тем же именем, что и модуль стандартной библиотеки, например random.py и tkinter.py. Когда такой файл находится в той же директории, что и файл, который должен быть запущен, IDLE не может импортировать файл из стандартной библиотеки. Текущее решение – переименовать пользовательский файл.
Хотя и реже, чем в прошлом, антивирус или межсетевой экран могут блокировать соединение. Если программу нельзя научить разрешать соединение, её необходимо отключить для работы IDLE. Разрешать это внутреннее соединение безопасно, поскольку никакие данные не видны на внешних портах. Аналогичная проблема – неверная настройка сети, блокирующая соединения.
Проблемы с установкой Python иногда мешают работе IDLE: несколько версий могут конфликтовать, или для одной установки могут потребоваться права администратора. Если конфликт не устранён, или невозможно или нежелательно запускать от имени администратора, проще всего полностью удалить Python и начать заново.
Процесс-зомби pythonw.exe может быть проблемой. В Windows используйте диспетчер задач, чтобы проверить его и остановить, если он есть. Иногда перезапуск, инициированный сбоем программы или прерыванием с клавиатуры (Ctrl+C), может не привести к подключению. Закрытие окна ошибки или использование команды «Перезапустить оболочку» в меню «Оболочка» может исправить временную проблему.
При первом запуске IDLE пытается прочитать пользовательские файлы конфигурации в ~/.idlerc/ (~ – домашний каталог пользователя). Если возникает проблема, должно отображаться сообщение об ошибке. Не считая случайных сбоев диска, этого можно избежать, никогда не редактируя файлы вручную. Вместо этого используйте диалог настройки в меню Options. Если в пользовательском файле конфигурации уже есть ошибка, лучшее решение – удалить его и начать заново с помощью диалога настроек.
Если IDLE завершается без сообщения и не был запущен из консоли, попробуйте запустить его из консоли или терминала (python -m idlelib) и посмотрите, появится ли сообщение об ошибке.
В Unix-системах с tcl/tk старше 8.6.11 (см. About IDLE) некоторые символы определённых шрифтов могут вызывать сбой tk с сообщением в терминал. Это может произойти как при запуске IDLE для редактирования файла с таким символом, так и при последующем вводе такого символа. Если обновить tcl/tk невозможно, перенастройте IDLE на использование более подходящего шрифта.
Выполнение пользовательского кода¶Running user code
За редкими исключениями, результат выполнения кода Python в IDLE должен быть таким же, как при выполнении того же кода стандартным способом – напрямую с помощью Python в текстовой системной консоли или окне терминала. Однако различия в интерфейсе и работе иногда влияют на видимые результаты. Например, sys.modules начинается с большим количеством записей, а threading.active_count() возвращает 2 вместо 1.
По умолчанию IDLE выполняет пользовательский код в отдельном процессе ОС, а не в процессе пользовательского интерфейса, который управляет оболочкой и редактором. В процессе выполнения он заменяет sys.stdin, sys.stdout и sys.stderr объектами, которые получают ввод из окна оболочки и отправляют вывод в него. Исходные значения, хранящиеся в sys.__stdin__, sys.__stdout__ и sys.__stderr__, не изменяются, но могут быть None.
Отправка вывода print из одного процесса в виджет текста в другом процессе медленнее, чем печать в системный терминал в том же процессе. Это особенно заметно при выводе нескольких аргументов, так как строка для каждого аргумента, каждый разделитель и символ новой строки отправляются отдельно. Для разработки это обычно не проблема, но если нужно печатать быстрее в IDLE, отформатируйте и объедините всё, что хотите вывести вместе, а затем напечатайте одну строку. Строки форматирования и str.join() могут помочь объединить поля и строки.
Стандартные замены потоков IDLE не наследуются подпроцессами, созданными в процессе выполнения, будь то напрямую пользовательским кодом или модулями, такими как multiprocessing. Если такой подпроцесс использует input из sys.stdin или print или write в sys.stdout или sys.stderr, IDLE следует запускать в окне командной строки. (В Windows используйте python или py вместо pythonw или pyw.) Вторичный подпроцесс будет затем привязан к этому окну для ввода и вывода.
Если sys сбрасывается пользовательским кодом, например, с помощью importlib.reload(sys), изменения IDLE теряются, и ввод с клавиатуры и вывод на экран будут работать неправильно.
Когда Shell находится в фокусе, он управляет клавиатурой и экраном. Обычно это незаметно, но функции, которые напрямую обращаются к клавиатуре и экрану, работать не будут. К ним относятся системно-зависимые функции, определяющие, была ли нажата клавиша, и если да, то какая.
Код IDLE, выполняющийся в процессе выполнения, добавляет в стек вызовов фреймы, которых бы там не было. IDLE оборачивает sys.getrecursionlimit и sys.setrecursionlimit, чтобы уменьшить влияние дополнительных фреймов стека.
Когда пользовательский код вызывает SystemExit напрямую или через sys.exit, IDLE возвращается к приглашению Shell, а не завершается.
Пользовательский вывод в Shell¶User output in Shell
Когда программа выводит текст, результат определяется соответствующим устройством вывода. Когда IDLE выполняет пользовательский код, sys.stdout и sys.stderr подключены к области отображения Shell IDLE. Некоторые его функции унаследованы от базового виджета Tk Text. Другие являются программными дополнениями. Там, где это важно, Shell спроектирован для разработки, а не для эксплуатации в промышленной среде.
Например, Shell никогда не отбрасывает вывод. Программа, которая отправляет неограниченный вывод в Shell, в конечном итоге заполнит память, что приведет к ошибке памяти. Напротив, некоторые системные текстовые окна сохраняют только последние n строк вывода. Например, консоль Windows сохраняет настраиваемые пользователем от 1 до 9999 строк, по умолчанию 300.
Виджет Tk Text, а следовательно и Shell IDLE, отображает символы (кодовые точки) в подмножестве BMP (Basic Multilingual Plane) Unicode. Какие символы отображаются правильным глифом, а какие замещающим прямоугольником, зависит от операционной системы и установленных шрифтов. Символы табуляции заставляют следующий текст начинаться после следующей позиции табуляции. (Они встречаются каждые 8 «символов»). Символы новой строки заставляют следующий текст отображаться на новой строке. Другие управляющие символы игнорируются или отображаются как пробел, прямоугольник или что-то ещё, в зависимости от операционной системы и шрифта. (Перемещение текстового курсора через такой вывод с помощью клавиш со стрелками может проявлять неожиданное поведение в виде пропусков.)
>>> s = 'a\tb\a<\x02><\r>\bc\nd' # Введите 22 символа.
>>> len(s)
14
>>> s # Отобразить repr(s)
'a\tb\x07<\x02><\r>\x08c\nd'
>>> print(s, end='') # Отобразить s как есть.
# Result varies by OS and font. Try it.
Функция repr используется для интерактивного вывода значений выражений. Она возвращает изменённую версию входной строки, в которой управляющие коды, некоторые кодовые точки BMP и все не-BMP кодовые точки заменяются escape-последовательностями. Как показано выше, это позволяет определить символы в строке независимо от того, как они отображаются.
Обычный вывод и вывод ошибок, как правило, отделены (на отдельных строках) от ввода кода и друг от друга. Они получают разные цвета подсветки.
Для трассировок SyntaxError обычная пометка ‘^’ в месте обнаружения ошибки заменяется выделением текста цветом ошибки. Когда код, запущенный из файла, вызывает другие исключения, можно щелкнуть правой кнопкой мыши по строке трассировки, чтобы перейти к соответствующей строке в редакторе IDLE. Файл будет открыт при необходимости.
В Shell есть специальная возможность сжимать строки вывода до метки «Сжатый текст». Это делается автоматически для вывода, превышающего N строк (по умолчанию N = 50). N можно изменить в разделе PyShell на вкладке General диалога Settings. Вывод с меньшим количеством строк можно сжать, щелкнув по нему правой кнопкой мыши. Это может быть полезно для строк, достаточно длинных, чтобы замедлить прокрутку.
Сжатый вывод разворачивается на месте двойным щелчком по метке. Его также можно отправить в буфер обмена или отдельное окно просмотра, щелкнув правой кнопкой мыши по метке.
Разработка tkinter-приложений¶Developing tkinter applications
IDLE намеренно отличается от стандартного Python, чтобы облегчить разработку tkinter-программ. Введите import tkinter as tk;
root = tk.Tk() в стандартном Python – ничего не появится. Введите то же самое в IDLE – появится tk-окно. В стандартном Python нужно также ввести root.update(), чтобы увидеть окно. IDLE делает то же самое в фоне, примерно 20 раз в секунду, то есть каждые 50 миллисекунд. Затем введите b = tk.Button(root, text='button'); b.pack(). Опять же, в стандартном Python ничего визуально не меняется, пока не ввести root.update().
Большинство tkinter-программ запускают root.mainloop(), который обычно не возвращает управление, пока tk-приложение не будет уничтожено. Если программа запускается с помощью python -i или из редактора IDLE, приглашение >>> shell не появляется, пока mainloop() не вернётся, после чего уже не с чем взаимодействовать.
При запуске tkinter-программы из редактора IDLE можно закомментировать вызов mainloop. Тогда сразу появляется приглашение shell, и можно взаимодействовать с работающим приложением. Нужно только не забыть снова включить вызов mainloop при запуске в стандартном Python.
Запуск без подпроцесса¶Running without a subprocess
По умолчанию IDLE выполняет пользовательский код в отдельном подпроцессе через сокет, использующий внутренний интерфейс loopback. Это соединение не видно извне, и никакие данные не отправляются и не принимаются из интернета. Если программное обеспечение брандмауэра всё же жалуется, можно игнорировать это.
Если попытка установить сокетное соединение не удаётся, IDLE уведомит вас. Такие сбои иногда носят временный характер, но если они постоянны, проблема может заключаться либо в блокировке соединения брандмауэром, либо в неправильной конфигурации конкретной системы. Пока проблема не решена, можно запускать IDLE с ключом командной строки -n.
Если IDLE запущен с ключом командной строки -n, он будет работать в одном процессе и не будет создавать подпроцесс, запускающий RPC-сервер выполнения Python. Это может быть полезно, если Python не может создать подпроцесс или сокетный интерфейс RPC на вашей платформе. Однако в этом режиме пользовательский код не изолирован от самого IDLE. Кроме того, среда не перезапускается при выборе Run/Run Module (F5). Если ваш код был изменён, необходимо выполнить reload() для затронутых модулей и повторно импортировать любые конкретные элементы (например, from foo import baz), чтобы изменения вступили в силу. По этим причинам предпочтительнее запускать IDLE с подпроцессом по умолчанию, если это возможно.
Устарело с версии 3.4.
Справка и настройки¶Help and Preferences
Источники справки¶Help sources
Пункт меню «IDLE Help» отображает форматированную HTML-версию главы об IDLE из справочника по библиотеке. Результат, в окне только для чтения на tkinter, близок к тому, что видно в веб-браузере. Пролистывайте текст с помощью колесика мыши, полосы прокрутки или удерживая клавиши вверх/вниз. Или нажмите кнопку TOC (Table of Contents) и выберите заголовок раздела в открывшемся окне.
Пункт меню «Python Docs» открывает обширные источники справки, включая руководства, доступные по адресу docs.python.org/x.y, где ‘x.y’ – текущая версия Python. Если в вашей системе есть локальная копия документации (это может быть опцией установки), будет открыта она.
Выбранные URL-адреса можно добавлять или удалять из меню справки в любое время с помощью вкладки General диалога Configure IDLE.
Настройка параметров¶Setting preferences
Настройки шрифта, подсветки, клавиш и общие настройки можно изменить через Configure IDLE в меню Option. Нестандартные пользовательские настройки сохраняются в каталоге .idlerc в домашнем каталоге пользователя. Проблемы, вызванные некорректными конфигурационными файлами пользователя, решаются редактированием или удалением одного или нескольких файлов в .idlerc.
На вкладке Font смотрите образец текста для оценки влияния гарнитуры и размера шрифта на разные символы разных языков. Отредактируйте образец, чтобы добавить другие символы, представляющие личный интерес. Используйте образец для выбора моноширинных шрифтов. Если отдельные символы отображаются с проблемами в Shell или редакторе, добавьте их в начало образца и попробуйте изменить сначала размер, а затем шрифт.
На вкладке «Подсветка и клавиши» выберите встроенную или пользовательскую цветовую схему и набор клавиш. Чтобы использовать более новую встроенную цветовую схему или набор клавиш в старых версиях IDLE, сохраните её как новую пользовательскую цветовую схему или набор клавиш, и она будет доступна в старых версиях IDLE.
IDLE на macOS¶IDLE on macOS
В настройках системы: Dock, можно установить «Prefer tabs when opening documents» в значение «Always». Эта настройка несовместима с графической библиотекой tk/tkinter, используемой в IDLE, и нарушает работу некоторых функций IDLE.
Расширения¶Extensions
IDLE содержит механизм расширений. Настройки расширений можно изменить на вкладке «Extensions» диалога настроек. Обратитесь к началу файла config-extensions.def в каталоге idlelib для получения дополнительной информации. Единственное текущее расширение по умолчанию – zzdummy, пример, также используемый для тестирования.
idlelib¶
Исходный код: Lib/idlelib
Пакет Lib/idlelib реализует приложение IDLE. Остальная часть этой страницы описывает, как использовать IDLE.
Файлы в idlelib описаны в idlelib/README.txt. Откройте его в idlelib или выберите «Help» ⇒ «About IDLE» в меню IDLE. Этот файл также сопоставляет пункты меню IDLE с кодом, реализующим эти пункты. За исключением файлов, перечисленных в разделе «Startup», код idlelib является «частным» в том смысле, что изменения функциональности могут быть перенесены обратно (см. PEP 434).