IDLE
Исходный код: Lib/idlelib/
IDLE — это интегрированная среда разработки и обучения Python.
IDLE обладает следующими возможностями:
- кроссплатформенность: работает практически одинаково на Windows, Unix и macOS
- окно оболочки Python (интерактивный интерпретатор) с цветовым выделением кода ввода, вывода и сообщений об ошибках
- многооконный текстовый редактор с многократной отмоткой назад, цветовым выделением Python, интеллектуальным отступом, подсказками функций, автозаполнением и другими возможностями
- поиск в любом окне, замена в окнах редактора и поиск в нескольких файлах (grep)
- отладчик с постоянными точками останова, пошаговым выполнением и просмотром глобальных и локальных пространств имён
- настройка, обозреватели и другие диалоговые окна
Запуск и выполнение кода
При запуске с опцией -s, IDLE выполнит файл, указанный переменными среды IDLESTARTUP или PYTHONSTARTUP. IDLE сначала проверяет наличие IDLESTARTUP; если IDLESTARTUP присутствует, то указанный файл будет запущен. Если IDLESTARTUP отсутствует, IDLE проверяет наличие PYTHONSTARTUP. Файлы, на которые ссылаются эти переменные среды, удобно использовать для хранения часто используемых функций из оболочки IDLE или для выполнения инструкций импорта для импорта общих модулей.
Кроме того, Tk также загружает файл запуска, если он присутствует. Обратите внимание, что файл Tk загружается безусловно. Этот дополнительный файл называется .Idle.py и ищется в домашнем каталоге пользователя. Инструкции в этом файле будут выполняться в пространстве имён Tk, поэтому этот файл не подходит для импорта функций, которые будут использоваться из оболочки Python IDLE.
Использование в командной строке
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'. Окно редактора не будет открыто, даже если это установлено по умолчанию в диалоге параметров. - В противном случае, аргументы будут открыты для редактирования, а
sys.argvотразит аргументы, переданные в сам IDLE.
Ошибка запуска
IDLE использует сокет для связи между процессом графического интерфейса IDLE и процессом выполнения кода пользователя. Подключение должно быть установлено всякий раз, когда оболочка запускается или перезапускается. (Последнее обозначается разделительной линией, которая говорит «RESTART»). Если процесс пользователя не может подключиться к процессу графического интерфейса, обычно отображается окно с ошибкой Tk с сообщением «не удается подключиться», которое направляет пользователя сюда. После этого процесс завершается.
Одна конкретная ошибка подключения в системах 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 не сможет импортировать файл stdlib. Текущее решение – переименовать файл пользователя.
Хотя это менее распространено, чем раньше, антивирусная программа или брандмауэр могут блокировать соединение. Если программе нельзя объяснить, как разрешить подключение, то её нужно выключить, чтобы IDLE работало. Безопасно разрешать это внутреннее соединение, так как данные не видны на внешних портах. Аналогичная проблема – неправильная настройка сети, блокирующая соединения.
Иногда проблемы с установкой Python останавливают IDLE: несколько версий могут конфликтовать, или одной установке может потребоваться доступ администратора. Если вы устраните конфликт или не можете или не хотите запускать как администратор, проще всего полностью удалить Python и начать заново.
Процесс «зомби» pythonw.exe может быть проблемой. В Windows используйте диспетчер задач, чтобы проверить его и остановить, если он есть. Иногда перезапуск, вызванный сбоем программы или прерыванием клавиатурой (control-C), может не удаться установить соединение. Закрытие окна с ошибкой или использование пункта «Перезапустить оболочку» в меню «Оболочка» может исправить временную проблему.
При первом запуске IDLE пытается прочитать файлы конфигурации пользователя в ~/.idlerc/ (~ это домашний каталог). Если возникнет проблема, должно быть отображено сообщение об ошибке. Помимо случайных сбоев диска, этого можно избежать, если никогда не редактировать эти файлы вручную. Вместо этого используйте диалог конфигурации в диалоговом окне «Параметры». Если в файле конфигурации пользователя есть ошибка, лучшим решением может быть его удаление и повторное начало с помощью диалога настроек.
Если IDLE завершится без сообщения, и он не был запущен из консоли, попробуйте запустить его из консоли или терминала (python -m idlelib) и посмотрите, вызовет ли это сообщение об ошибке.
В системах на основе Unix с tcl/tk, более старыми чем 8.6.11 (см. About IDLE), определённые символы определённых шрифтов могут привести к ошибке tk с сообщением в терминал. Это может произойти как при запуске IDLE для редактирования файла с таким символом, так и позже при вводе такого символа. Если вы не можете обновить tcl/tk, переконфигурируйте IDLE, чтобы использовать более подходящий шрифт.
Выполнение пользовательского кода
За редкими исключениями, результат выполнения кода Python с помощью IDLE должен быть таким же, как при выполнении того же кода стандартным способом — непосредственно с помощью Python в текстовом консольном или терминальном окне системы. Однако различные интерфейс и операция иногда влияют на видимые результаты. Например, sys.modules начинается с большего количества записей, а threading.active_count() возвращает 2 вместо 1.
По умолчанию IDLE выполняет пользовательский код в отдельном процессе ОС, а не в процессе пользовательского интерфейса, который выполняет оболочку и редактор. В процессе выполнения он заменяет sys.stdin, sys.stdout, и sys.stderr объектами, которые получают входные данные из окна оболочки и отправляют выходные данные в окно оболочки. Исходные значения, сохраненные в sys.__stdin__, sys.__stdout__, и sys.__stderr__, не изменяются, но могут быть None.
Отправка выходных данных печати из одного процесса в текстовый виджет другого процесса медленнее, чем печать в системный терминал в том же процессе. Это наиболее заметно при печати нескольких аргументов, поскольку строка для каждого аргумента, каждый разделитель, новая строка отправляются отдельно. Для разработки это обычно не проблема, но если вам нужно печатать быстрее в 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 теряются, и ввод с клавиатуры и вывод на экран не будут работать правильно.
Когда у оболочки фокус, она управляет клавиатурой и экраном. Это обычно прозрачно, но функции, которые напрямую обращаются к клавиатуре и экрану, не будут работать. К ним относятся функции, специфичные для системы, которые определяют, нажата ли клавиша и если да, то какая.
Код IDLE, выполняющийся в процессе выполнения, добавляет фреймы в стек вызовов, которых не было бы в противном случае. IDLE оборачивает sys.getrecursionlimit и sys.setrecursionlimit для уменьшения эффекта дополнительных фреймов стека.
Когда пользовательский код вызывает SystemExit напрямую или вызывая sys.exit, IDLE возвращается к приглашению оболочки, а не завершается.
Вывод пользователя в оболочке
Когда программа выводит текст, результат определяется соответствующим устройством вывода. Когда IDLE выполняет пользовательский код, sys.stdout и sys.stderr подключены к области отображения оболочки IDLE. Некоторые её функции унаследованы от базового виджета Tk Text. Другие — это программно добавленные функции. Там, где это важно, оболочка предназначена для разработки, а не для производственных запусков.
Например, оболочка никогда не удаляет вывод. Программа, которая отправляет неограниченный вывод в оболочку, в конечном итоге заполнит память, что приведёт к ошибке памяти. В отличие от этого, некоторые текстовые окна системы хранят только последние n строк вывода. Например, консоль Windows хранит настраиваемое пользователем количество строк от 1 до 9999, по умолчанию — 300.
Виджет Tk Text, а значит и оболочка IDLE, отображает символы (кодовые точки) в подмножестве BMP (Basic Multilingual Plane) Unicode. Какие символы отображаются с правильным глифом, а какие — с замещающим блоком, зависит от операционной системы и установленных шрифтов. Символы табуляции заставляют следующий текст начинаться после следующей позиции табуляции. (Они появляются каждые 8 «символов»). Символы новой строки заставляют последующий текст появляться на новой строке. Другие управляющие символы игнорируются или отображаются как пробел, квадрат или что-то ещё, в зависимости от операционной системы и шрифта. (Перемещение курсора текста по такому выводу с помощью клавиш со стрелками может вызвать некоторое удивительное поведение пробелов.)
>>> s = 'a\tb\a<\x02><\r>\bc\nd' # Enter 22 chars. >>> len(s) 14 >>> s # Display repr(s) 'a\tb\x07<\x02><\r>\x08c\nd' >>> print(s, end='') # Display s as is. # Result varies by OS and font. Try it.
Функция repr используется для интерактивного отображения значений выражений. Она возвращает изменённую версию входной строки, в которой управляющие коды, некоторые кодовые точки BMP и все кодовые точки не-BMP заменены на escape-коды. Как показано выше, это позволяет идентифицировать символы в строке независимо от того, как они отображаются.
Нормальный и ошибочный вывод обычно сохраняются отдельно (на отдельных строках) от входного кода и друг от друга. Для них используются разные цвета выделения.
Для отслеживания SyntaxError подчёркивание обычным способом «^», указывающее место обнаружения ошибки, заменяется на выделение текста цветом ошибки. Когда код, запущенный из файла, вызывает другие исключения, можно щелкнуть правой кнопкой мыши по строке отладки, чтобы перейти к соответствующей строке в редакторе IDLE. Файл будет открыт при необходимости.
Оболочка имеет специальную возможность для сжатия строк вывода до метки «Сжатый текст». Это делается автоматически для вывода более N строк (N = 50 по умолчанию). N можно изменить в разделе PyShell на странице «Общие» диалога настроек. Вывод с меньшим количеством строк можно сжать, щелкнув правой кнопкой мыши по выводу. Это может быть полезно для достаточно длинных строк, чтобы замедлить прокрутку.
Сжатый вывод можно развернуть на месте, дважды щелкнув по метке. Его также можно скопировать в буфер обмена или в отдельное окно просмотра, щелкнув правой кнопкой мыши по метке.
Разработка приложений tkinter
IDLE преднамеренно отличается от стандартного Python, чтобы облегчить разработку программ tkinter. В стандартном Python ввод import tkinter as tk;
root = tk.Tk() ничего не отображает. В 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, приглашение командной оболочки >>> не появляется, пока mainloop() не вернётся, и в этот момент с программой невозможно взаимодействовать.
При запуске программы tkinter из редактора IDLE можно прокомментировать вызов mainloop. В этом случае приглашение командной оболочки появляется сразу, и можно взаимодействовать с приложением в режиме реального времени. Просто нужно помнить о необходимости повторного включения вызова mainloop при запуске в стандартном Python.
Запуск без подпроцесса
По умолчанию IDLE выполняет код пользователя в отдельном подпроцессе через сокет, который использует внутренний интерфейс петли обратной связи. Эта связь не видна извне и никакие данные не отправляются на интернет и не принимаются от него. Если программное обеспечение брандмауэра всё равно жалуется, вы можете его проигнорировать.
Если попытка установить сокетное соединение терпит неудачу, Idle уведомит вас об этом. Такие сбои иногда временны, но если они повторяются, проблема может заключаться либо в том, что брандмауэр блокирует соединение, либо в неправильной настройке системы. Пока проблема не будет исправлена, можно запустить Idle с флагом командной строки -n.
Если IDLE запускается с флагом командной строки -n, он выполняется в одном процессе и не создаёт подпроцесс, который выполняет сервер выполнения Python RPC. Это может быть полезно, если Python не может создать подпроцесс или интерфейс сокета RPC на вашей платформе. Однако в этом режиме код пользователя не изолирован от самого IDLE. Также среда не перезапускается при выборе «Запуск/Запустить модуль» (F5). Если ваш код был изменён, необходимо перезагрузить() затронутые модули и повторно импортировать все необходимые элементы (например, from foo import baz), чтобы изменения вступили в силу. По этим причинам предпочтительнее запускать IDLE с помощью стандартного подпроцесса, если это возможно.
Устарело начиная с версии 3.4.
Справка и настройки
Источники справки
Пункт меню «Справка IDLE» отображает отформатированную версию html главы IDLE в Справке по библиотеке. Результат, в текстовом окне tkinter только для чтения, близок к тому, что вы видите в веб-браузере. Перемещайтесь по тексту с помощью колеса мыши, полосы прокрутки или удерживания клавиш со стрелками вверх и вниз. Или нажмите кнопку TOC (Содержание) и выберите заголовок раздела в открытом окне.
Пункт меню «Документация Python» открывает обширные источники справки, включая учебные пособия, доступные по адресу docs.python.org/x.y, где «x.y» — текущая версия Python. Если на вашей системе есть автономная копия документации (это может быть опция установки), она откроется вместо неё.
Выбранные URL-адреса можно добавлять или удалять из меню справки в любое время с помощью вкладки «Общие» диалогового окна «Настройка IDLE».
Настройка параметров
Настройки шрифта, подсветки, клавиш и общие настройки можно изменить в диалоговом окне «Настройка IDLE» в меню «Параметры». Нестандартные пользовательские настройки сохраняются в каталоге .idlerc в домашнем каталоге пользователя. Проблемы, вызванные неправильными файлами конфигурации пользователя, решаются путём редактирования или удаления одного или нескольких файлов в .idlerc.
На вкладке «Шрифт» ознакомьтесь с примером текста, чтобы увидеть эффект набора шрифта и размера на нескольких символах на разных языках. Откорректируйте пример, чтобы добавить другие символы, представляющие личный интерес. Используйте пример для выбора моноширинных шрифтов. Если у конкретных символов возникают проблемы в оболочке или редакторе, добавьте их в начало примера и попробуйте сначала изменить размер, а затем шрифт.
На вкладке «Подсветка и клавиши» выберите встроенную или пользовательскую цветовую схему и набор клавиш. Чтобы использовать более новую встроенную цветовую схему или набор клавиш с более старыми версиями IDLE, сохраните их как новую пользовательскую схему или набор клавиш, и они будут доступны и для более старых версий IDLE.
IDLE в macOS
В настройках системы: Панель задач можно установить «Предпочитать вкладки при открытии документов» в «Всегда». Эта настройка несовместима с фреймворком GUI tk/tkinter, используемым IDLE, и нарушает некоторые функции IDLE.
Расширения
IDLE содержит механизм расширений. Настройки расширений можно изменить на вкладке «Расширения» диалогового окна настроек. Дополнительную информацию см. в начале файла config-extensions.def в каталоге idlelib. Единственное текущее стандартное расширение — zzdummy, также используемое для тестирования.
idlelib
Исходный код: Lib/idlelib
Пакет Lib/idlelib реализует приложение IDLE. Смотрите остальную часть этой страницы, чтобы узнать, как использовать IDLE.
Файлы в idlelib описаны в idlelib/README.txt. Доступ к нему можно получить в idlelib или нажав «Справка» => «О IDLE» в меню IDLE. Этот файл также сопоставляет пункты меню IDLE с кодом, реализующим этот пункт. За исключением файлов, указанных в разделе «Запуск», код idlelib является «частным» в том смысле, что изменения функций могут быть перенесены назад (см. PEP 434).
© 2001–2024 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.12/library/idle.html
