2015-04-21 3 views
3

My IDLE (Python 3.4.3) не будет отображать функции doc-строк при вводе имени функции.Python IDLE не будет показывать docstring

Кто-нибудь знаком с этой проблемой?

Я пробовал все, включая удаление и т. Д. Ответы в Интернете нигде не найдены.

Я говорю о показе автоматически строки документации, НЕ когда специально печатая:

print(func. __ doc __) 

Благодаря

+1

Нажмите 'Ctrl + Space', чтобы начать автозавершение, перейдите к имени своей функции и используйте открывающую скобку, чтобы увидеть всплывающее окно, содержащее docstring. –

+0

У вас было это док-шоу? Вы также можете рассмотреть IDE для разработки. – pyan

+0

@MalikBrahimi, проблема в том, что после того, как я набрал открывающую скобку, docstring просто не покажут. – almog6564

ответ

2

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

Подвижная панель состоит из сигнатуры функции и первой строки docstring. Для встроенных без доступной подписи (например, в 3.4.3, int или bytes), callTip состоит из всех строк вверх по пятой строке или первой пустой строки.

Доступные функции зависит от того, какие модули были импортированы в пользовательский процесс (где выполняется ваш код), включая те, которые импортированы самим Idle и какой код был запущен (с момента последнего перезапуска). Например, перезапустить Shell (Cntl-F6), откройте новое окно редактора и введите

itertools.count(

появляется calltip'а, потому что импорт Idle itertools в процесс пользователя для своего собственного использования. Введите

turtle.write(

и ничего не появляется, потому что Idle не импортирует черепаху. Cntl- \ ничего не делает. Ввод

import turtle 

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

Это предполагает, что можно запустить файл после записи инструкций импорта вверху или сразу же запустить существующий файл перед редактированием.

Комментарии:

  1. Я подозреваю, ваша проблема в том, что вы пытаетесь получить calltip'а, для функции, которая в настоящее время не доступен, хотя это, возможно, были доступны раньше, и станут доступны после запуска вашего код.

  2. Я открыл issue 24028, чтобы добавить что-то вроде выше Документов Idle как части на calltips после пункта на completions

  3. Существующих issue 1350 о добавлении опции для отображения полной строки документации.

  4. Проблема доступности является неприятностью.У меня есть пара идей по его улучшению. В то же время используйте приведенное выше предложение о запуске вашего импорта.

+0

OK! Прежде всего, спасибо за кучу объяснений. Поэтому я использую CallTips. Конечно, приятно, что Ctrl- \ открывает подсказку в ручном режиме, я просто видел на днях, что на других компьютерах CallTips отображаются автоматически, когда функция (уже импортированного модуля, не волнуйтесь) вызывается после записи '(«.. И я расстроен тем, что мой IDLE не будет автоматически показывать CallTips .. Я все же импортировал модули, и это не проблема. – almog6564

+0

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