IDLE

IDLE — это интегрированная среда разработки и обучения Python.

IDLE обладает следующими функциями:

разработан на 100% чистом Python, используя tkinter инструментарий графического интерфейса
кроссплатформенный: работает практически одинаково на Windows, Unix и Mac OS X
окно Python-консоли (интерактивный интерпретатор) с цветовой подсветкой ввода кода, вывода и сообщений об ошибках
многооконный текстовый редактор с многократным отменением действий, подсветкой синтаксиса Python, интеллектуальным отступом, подсказками вызова, автодополнением и другими функциями
поиск в любом окне, замена в окнах редактора и поиск по множеству файлов (grep)
отладчик с сохраняемыми точками останова, пошаговым выполнением и просмотром глобальных и локальных пространств имён
настройки, браузеры и другие диалоговые окна

1. Меню

IDLE имеет два основных типа окон: окно консоли и окно редактора. Можно иметь несколько окон редактора одновременно. Окна вывода, такие как используемые для функций «Редактировать» / «Найти во всех файлах», являются подтипом окна редактора. В настоящее время они имеют то же верхнее меню, что и окна редактора, но другое стандартное название и контекстное меню.

Меню IDLE динамически изменяется в зависимости от того, какое окно выбрано в данный момент. Каждое документированное ниже меню указывает, к какому типу окна оно относится.

Новый файл: Создать новое окно для редактирования файлов.
Открыть…: Открыть существующий файл с помощью диалогового окна «Открыть».
Недавние файлы: Открыть список недавних файлов. Щёлкните по нужному файлу, чтобы его открыть.
Открыть модуль…: Открыть существующий модуль (ищет в sys.path).

Браузер классов: Показать функции, классы и методы в текущем файле редактора в виде древовидной структуры. В консоли сначала откройте модуль.
Браузер путей: Показать каталоги, модули, функции, классы и методы в sys.path в виде древовидной структуры.
Сохранить: Сохранить текущее окно в связанный файл, если он есть. Окна, которые были изменены с момента открытия или последнего сохранения, имеют * перед и после заголовка окна. Если связанного файла нет, выполните «Сохранить как».
Сохранить как…: Сохранить текущее окно с помощью диалогового окна «Сохранить как». Сохранённый файл станет новым связанным файлом для окна.
Сохранить копию как…: Сохранить текущее окно в другой файл, не изменяя связанный файл.
Печать окна: Распечатать текущее окно на стандартном принтере.
Закрыть: Закрыть текущее окно (спросить о сохранении, если оно не сохранено).
Выход: Закрыть все окна и выйти из IDLE (спросить о сохранении несохранённых окон).

Отменить: Отменить последнее изменение в текущем окне. Максимальное количество отменённых изменений — 1000.
Повторить: Повторить последнее отменённое изменение в текущем окне.
Вырезать: Скопировать выделение в системный буфер обмена; затем удалить выделение.
Копировать: Скопировать выделение в системный буфер обмена.
Вставить: Вставить содержимое системного буфера обмена в текущее окно.

Функции буфера обмена также доступны в контекстных меню.

Выделить всё: Выделить всё содержимое текущего окна.
Найти…: Открыть диалоговое окно поиска со множеством опций
Найти снова: Повторить последний поиск, если он был выполнен.
Найти выделение: Найти выделенный текст, если таковой имеется.
Найти в файлах…: Открыть диалоговое окно поиска по файлам. Результаты помещаются в новое окно вывода.
Заменить…: Открыть диалоговое окно поиска и замены.
Перейти к строке: Переместить курсор к указанной строке номера и отобразить эту строку.
Показать автодополнение: Открыть раскрывающийся список, позволяющий выбрать ключевые слова и атрибуты. См. Автодополнение в разделах «Советы» ниже.
Развернуть слово: Развернуть введённый префикс до полного слова в том же окне; повторите, чтобы получить другое расширение.
Показать подсказку вызова: После незакрытой скобки функции откроется небольшое окно с подсказками параметров функции.
Показать окружающие скобки: Выделить окружающие скобки.

Отступ области: Сместить выделенные строки вправо на ширину отступа (по умолчанию 4 пробела).
Снять отступ области: Сместить выделенные строки влево на ширину отступа (по умолчанию 4 пробела).
Закомментировать область: Вставить ## перед выделенными строками.
Раскомментировать область: Удалить ведущие # или ## из выделенных строк.
Табулировать область: Преобразовать ведущие участки пробелов в табуляцию. (Примечание: Рекомендуется использовать блоки из 4 пробелов для отступа кода Python.)
Убрать табуляцию из области: Преобразовать все табуляции в соответствующее количество пробелов.
Переключить табуляцию: Открыть диалоговое окно для переключения между отступами с пробелами и табуляциями.
Новая ширина отступа: Открыть диалоговое окно для изменения ширины отступа. Принятым по умолчанию значением в сообществе Python является 4 пробела.
Форматировать абзац: Переформатировать текущий абзац, ограниченный пустой строкой, в блоке комментариев или многострочной строке, или выделенную строку в строке. Все строки в абзаце будут отформатированы так, чтобы занимать меньше N столбцов, где N по умолчанию равно 72.
Удалить хвостовые пробелы: Удалить все пробельные символы после последнего не-пробельного символа в строке.

1.4. Меню Выполнить (только окно редактора)

Python-консоль: Открыть или активировать окно Python-консоли.
Проверить модуль: Проверить синтаксис модуля, открытого в окне редактора. Если модуль не сохранён, IDLE предложит пользователю сохранить или автоматически сохранить его, как выбрано на вкладке «Общие» диалогового окна «Настройки IDLE». Если обнаружена синтаксическая ошибка, приблизительное местоположение будет указано в окне редактора.
Запустить модуль: Выполнить проверку модуля (выше). Если ошибок нет, перезапустить консоль, чтобы очистить среду, затем выполнить модуль. Вывод отображается в окне консоли. Обратите внимание, что вывод требует использования print или write. По завершении выполнения консоль сохраняет фокус и отображает приглашение. На этом этапе можно интерактивно изучить результат выполнения. Это похоже на выполнение файла с python -i file в командной строке.

Показать последнее перезапущение: Прокрутить окно консоли до последнего перезапуска.
Перезапустить консоль: Перезапустить консоль, чтобы очистить среду.
Прервать выполнение: Остановить выполнение программы.

Перейти к файлу/строке: Перейти к текущей строке с курсором и строке выше, чтобы найти имя файла и номер строки. Если найдено, открыть файл, если он ещё не открыт, и показать строку. Используйте эту функцию для просмотра строк исходного кода, указанных в трассировке исключений, и строк, найденных с помощью функции «Найти в файлах». Также доступно в контекстном меню окна консоли и окон вывода.

Отладчик (переключение): При включении код, введённый в консоль или запущенный из редактора, будет выполняться под отладчиком. В редакторе точки останова можно задавать с помощью контекстного меню. Эта функция ещё не завершена и частично экспериментальна.
Просмотр стека: Показать трассировку стека последнего исключения в древовидном виджете с доступом к локальным и глобальным переменным.
Автоматическое открытие просмотра стека: Включить или выключить автоматическое открытие просмотра стека при возникновении необработанного исключения.

Настроить IDLE

Открыть диалоговое окно настроек и изменить следующие параметры: шрифты, отступы, сочетания клавиш, темы оформления текста, стартовые окна и размеры, дополнительные источники справки и расширения (см. ниже). В OS X откройте диалоговое окно настроек, выбрав «Настройки» в меню приложения. Чтобы использовать новую встроенную тему оформления (IDLE Dark) с более старыми версиями IDLE, сохраните её как новую пользовательскую тему.

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

Контекст кода (переключение) (только окно редактора)

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

Изменить высоту: Переключает окно между обычным размером и максимальной высотой. Изначальный размер по умолчанию составляет 40 строк по 80 символов, если не изменён на вкладке «Общие» диалогового окна «Настроить IDLE».

Остальные пункты этого меню перечисляют имена всех открытых окон; выберите нужное, чтобы перевести его на передний план (развернув, если необходимо).

О IDLE: Отобразить версию, авторские права, лицензию, информацию об авторах и многое другое.
Справка по IDLE: Показать файл справки по IDLE, описывающий пункты меню, основные операции редактирования и навигации, а также другие советы.
Документация Python: Получить доступ к локальной документации Python, если она установлена, или открыть веб-браузер и перейти на docs.python.org, где отобразится последняя документация Python.
Демонстрация Черепахи: Запустить модуль turtledemo с примерами кода Python и чертежами черепахи.

Дополнительные источники справки могут быть добавлены здесь с помощью диалогового окна «Настроить IDLE» на вкладке «Общие».

1.10. Контекстные меню

Открыть контекстное меню, нажав правой кнопкой мыши в окне (нажатием клавиши Control на OS X). Контекстные меню содержат стандартные функции буфера обмена, также как и в меню «Правка».

Вырезать: Скопировать выделение в системный буфер обмена; затем удалить выделение.
Копировать: Скопировать выделение в системный буфер обмена.
Вставить: Вставить содержимое системного буфера обмена в текущее окно.

Окна редактора также содержат функции точек останова. Строки с установленной точкой останова помечаются особо. Точки останова действуют только при работе под отладчиком. Точки останова для файла сохраняются в каталоге .idlerc пользователя.

Установить точку останова: Установить точку останова на текущей строке.
Убрать точку останова: Убрать точку останова с этой строки.

Окна консоли и вывода содержат следующее.

Перейти к файлу/строке: То же, что и в меню «Отладка».

В этом разделе «C» относится к клавише Control в Windows и Unix, и к клавише Command в Mac OSX.

Backspace удаляет влево; Del удаляет вправо
C-Backspace удаляет слово влево; C-Del удаляет слово вправо
Клавиши со стрелками и Page Up/Page Down для перемещения
C-LeftArrow и C-RightArrow перемещает по словам
Home/End перемещение в начало/конец строки
C-Home/C-End перемещение в начало/конец файла
Некоторые полезные сочетания клавиш Emacs унаследованы от Tcl/Tk:
- C-a начало строки
- C-e конец строки
- C-k удаление строки (но не помещает её в буфер обмена)
- C-l центрирование окна вокруг точки вставки
- C-b перемещение на один символ назад без удаления (обычно для этого можно использовать клавишу со стрелкой влево)
- C-f перемещение на один символ вперёд без удаления (обычно для этого можно использовать клавишу со стрелкой вправо)
- C-p перемещение на строку вверх (обычно для этого можно использовать клавишу со стрелкой вверх)
- C-d удаление следующего символа

Стандартные сочетания клавиш (например, C-c для копирования и C-v для вставки) могут работать. Сочетания клавиш выбираются в диалоговом окне Настройка IDLE.

2.1. Автоматическое отступа

После оператора открытия блока следующая строка отступает на 4 пробела (в окне Python Shell на один табулятор). После определенных ключевых слов (break, return и т. д.) следующая строка сдвигается вправо. При отступе слева Backspace удаляет до 4 пробелов, если они есть. Tab вставляет пробелы (в окне Python Shell один табулятор), количество зависит от ширины отступа. В настоящее время табуляции ограничены четырьмя пробелами из-за ограничений Tcl/Tk.

См. также команды региона отступа/сдвига в меню Правка.

2.2. Автодополнение

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

Окно автодополнения (ACW) откроется после заданной задержки (по умолчанию две секунды) после ввода «.» или (в строке) os.sep. Если после одного из этих символов (плюс ноль или более других символов) нажимается клавиша табуляции, ACW откроется немедленно, если будет найден возможный вариант продолжения.

Если существует только одно возможное автодополнение для введённых символов, клавиша Tab предложит это автодополнение без открытия ACW.

«Показать автодополнение» позволит открыть окно автодополнения, по умолчанию C-space откроет окно автодополнения. В пустой строке оно будет содержать файлы в текущем каталоге. В пустой строке оно будет содержать встроенные и определённые пользователем функции и классы в текущих пространствах имён, а также любые импортированные модули. Если введены некоторые символы, ACW попытается быть более конкретным.

Если введена строка символов, выделение ACW переместится к записи, наиболее точно соответствующей этим символам. Ввод клавиши tab введёт в окно редактора или оболочки самую длинную однозначную совпадающую запись. Два нажатия клавиши tab подряд предложат текущий выбор ACW, как и возврат или двойной щелчок. Клавиши со стрелками, Page Up/Down, выбор мышью и колесо прокрутки работают с ACW.

«Скрытые» атрибуты можно получить, введя начало имени скрытого атрибута после «.», например «_». Это позволяет получить доступ к модулям с установленным __all__, или к частным атрибутам классов.

Автодополнение и функция «Развернуть слово» экономят много времени набора!

Автодополнение в настоящее время ограничено именами в пространствах имен. Имена в окне редактора, которые не находятся через __main__ и sys.modules, не будут найдены. Запустите модуль один раз с вашими импортами, чтобы исправить эту ситуацию. Обратите внимание, что IDLE сам помещает довольно много модулей в sys.modules, так что многие из них можно найти по умолчанию, например, модуль re.

Если вам не нравится, что ACW появляется без вашего ведома, просто увеличьте время задержки или отключите расширение.

2.3. Подсказки вызова

Подсказка вызова отображается при наборе «(» после имени доступной функции. Выражение имени может включать точки и индексы. Подсказка вызова остается до тех пор, пока на неё не кликнут, курсор не выйдет за область аргументов или не будет набран символ «) ». Когда курсор находится в части определения аргумента, меню или сочетание клавиш отображают подсказку вызова.

Подсказка вызова состоит из сигнатуры функции и первой строки строки документации. Для встроенных функций без доступной сигнатуры подсказка вызова состоит из всех строк до пятой строки или первой пустой строки. Эти детали могут меняться.

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

Например, перезапустите оболочку и введите itertools.count(. Подсказка вызова появляется, потому что Idle импортирует itertools в пользовательский процесс для собственного использования. (Это может измениться). Введите turtle.write( и ничего не появится. Idle не импортирует turtle. Меню или сочетание клавиш тоже ничего не делают. Введите import turtle и затем turtle.write( будет работать.

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

2.4. Окно Python Shell

C-c прерывает выполнение команды
C-d отправляет конец файла; закрывает окно, если введено в подсказке >>>
Alt-/ (Развернуть слово) также полезно для сокращения набора

История команд
- Alt-p извлекает предыдущую команду, соответствующую вашей записи. В OS X используйте C-p.
- Alt-n извлекает следующую. В OS X используйте C-n.
- Возврат в то время, когда активна любая предыдущая команда, извлекает эту команду

2.5. Цвета текста

Idle по умолчанию использует чёрный текст на белом фоне, но выделяет текст со специальными значениями. Для оболочки это вывод оболочки, ошибка оболочки, пользовательский вывод и пользовательская ошибка. Для кода Python в подсказке оболочки или в редакторе это ключевые слова, встроенные имена классов и функций, имена, следующие за class и def, строки и комментарии. Для любого текстового окна это курсор (если есть), найденный текст (если возможно) и выделенный текст.

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

3. Запуск и выполнение кода

При запуске с опцией -s, IDLE выполнит файл, на который ссылаются переменные окружения IDLESTARTUP или PYTHONSTARTUP. IDLE сначала проверяет IDLESTARTUP; если IDLESTARTUP присутствует, выполняется файл, на который он ссылается. Если IDLESTARTUP отсутствует, IDLE проверяет PYTHONSTARTUP. Файлы, на которые ссылаются эти переменные окружения, удобны для хранения часто используемых функций из оболочки IDLE или для выполнения инструкций импорта для импорта общих модулей.

Кроме того, Tk также загружает файл запуска, если он присутствует. Обратите внимание, что файл Tk загружается безусловно. Этот дополнительный файл — .Idle.py и ищется в домашнем каталоге пользователя. Инструкции в этом файле будут выполняться в пространстве имен Tk, поэтому этот файл не подходит для импорта функций, которые будут использоваться из оболочки Python IDLE.

3.1. Использование командной строки

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.

3.2. Отличия IDLE-консоли

По возможности, результат выполнения кода Python с IDLE такой же, как при выполнении этого же кода в окне консоли. Однако различные интерфейс и операции иногда влияют на видимые результаты. Например, sys.modules начинается с большего количества записей.

IDLE также заменяет sys.stdin, sys.stdout, и sys.stderr объектами, которые получают входные данные и отправляют выходные данные в окно Shell. Когда у этого окна фокус, оно управляет клавиатурой и экраном. Это обычно прозрачно, но функции, которые напрямую обращаются к клавиатуре и экрану, не будут работать. Если sys сброшен с помощью reload(sys), изменения IDLE потеряны, и такие вещи, как input, raw_input, и print не будут работать правильно.

С оболочкой IDLE вы вводите, редактируете и вызываете полные операторы. Некоторые консоли работают только с одной физической строкой за раз. IDLE использует exec для выполнения каждого оператора. В результате '__builtins__' всегда определён для каждого оператора.

3.3. Запуск без дочернего процесса

По умолчанию, IDLE выполняет пользовательский код в отдельном подпроцессе через сокет, который использует внутренний интерфейс обратной связи. Эта связь не видна извне и никакие данные не отправляются или не принимаются из интернета. Если программное обеспечение брандмауэра всё равно жалуется, вы можете проигнорировать это.

Если попытка установить сокетное соединение терпит неудачу, Idle уведомит вас. Такие сбои иногда временные, но если они повторяются, проблема может быть либо в брандмауэре, блокирующем соединение, либо в неправильной настройке системы. До тех пор, пока проблема не будет исправлена, можно запустить Idle с переключателем командной строки -n.

Если IDLE запускается с переключателем командной строки -n, он будет работать в одном процессе и не будет создавать подпроцесс, который запускает сервер выполнения Python RPC. Это может быть полезно, если Python не может создать подпроцесс или интерфейс сокета RPC на вашей платформе. Однако в этом режиме пользовательский код не изолирован от самого IDLE. Кроме того, среда не перезапускается при выборе пункта «Запустить/Запустить модуль» (F5). Если ваш код был изменён, вы должны перезагрузить() затронутые модули и повторно импортировать любые конкретные элементы (например, из foo импортировать baz), чтобы изменения вступили в силу. По этим причинам предпочтительнее запускать IDLE с использованием стандартного подпроцесса, если это вообще возможно.

Устаревшее начиная с версии 3.4.

4. Справка и настройки

4.1. Дополнительные источники справки

IDLE включает пункт меню справки «Документация Python», который откроет обширные источники справки, включая руководства, доступные на docs.python.org. Выбранные URL-адреса можно добавлять или удалять из меню справки в любое время с помощью диалогового окна «Настройка IDLE». Более подробную информацию см. в пункте меню справки IDLE.

4.2. Настройка предпочтений

Настройки шрифта, подсветки, клавиш и общие настройки можно изменить в диалоговом окне «Настройка IDLE» в меню «Параметры». Клавиши могут быть определены пользователем; IDLE поставляется с четырьмя встроенными наборами клавиш. Кроме того, пользователь может создать собственный набор клавиш в диалоговом окне «Настройка IDLE» на вкладке «Клавиши».

4.3. Расширения

IDLE содержит механизм расширений. Настройки расширений можно изменить с помощью «Настройка расширений». Дополнительную информацию см. в начале файла config-extensions.def в каталоге idlelib. Текущие стандартные расширения:

FormatParagraph
AutoExpand
ZoomHeight
ScriptBinding
CallTips
ParenMatch
AutoComplete
CodeContext
RstripExtension

IDLE

1. Меню

1.1. Меню Файл (консоль и редактор)

1.2. Меню Правка (консоль и редактор)

1.3. Меню Формат (только окно редактора)