Python.el и режим Python: документация и функции

Я некоторое время читал о различных пакетах Python, доступных для Emacs. Однако мне так и не удалось найти официальную документацию ни на один из пакетов.

Насколько я понимаю, python-mode размещен на панели запуска, но в репозитории нет ни вики, ни документа, объясняющего функции и т. д. С другой стороны, python.el поставляется с последними версиями Emacs, но я не могу найти документацию. пройти его функции в любом месте.

Кроме того, оба они поддерживают пошаговую отладку через ipdb ipython? Где я могу найти дополнительную информацию по этому вопросу?


python emacs
person Amelio Vazquez-Reina    schedule 16.06.2013    source источник
comment
Прочтите комментарии обеих библиотек. Вы можете найти их в специальном разделе комментариев прямо в начале этих файлов. По крайней мере, для встроенного в Emacs python.el этот комментарий является исчерпывающим и объясняет все особенности режима.   -  person lunaryorn    schedule 17.06.2013

Ответы (2)


arrow_upward
3
arrow_downward

Комментарии после ;;; Commentary являются хорошей отправной точкой, как предложил @lunarorn. Если вам нужна настройка, сначала прочитайте эту часть.

Но я думаю, что просто начните использовать его, когда ваша настройка будет завершена (для python.el ничего не нужно делать, если вы используете Emacs 24.3), это лучший способ ознакомиться с функциями.

Это потому, что Emacs является самодокументирующимся редактором. Вы можете прочитать весь документ о Emacs в Emacs. В буфере Python используйте <f1> b (или C-h вместо <f1>), чтобы увидеть список команд, которые вы можете использовать (это список функций). Каждая команда связана со строкой документации команды. Вы также можете открыть меню, используя «Ctrl + правый клик», чтобы увидеть список команд, которые вы можете использовать в буфере. Документ функции python-mode, который может быть открыт <f1> f python-mode RET, может быть еще одной хорошей отправной точкой. Если вы хотите увидеть документацию по какой-либо связке клавиш, введите <f1> k KEY-BIND. Есть более полезные команды помощи. См. <f1> <f1> для получения дополнительной информации. Эти методы не относятся к режиму python, поэтому вы можете использовать их для python.el и python-mode.el.

Re ipdb: python.el (и, я думаю, python-mode.el тоже) может это сделать. В ;;; Commentary есть фрагмент кода, который вы можете использовать в конфигурации Emacs.

person tkf    schedule 17.06.2013
comment
Спасибо @tkf! Когда вы упомянули ;;; Commentary, какой файл вы имеете в виду? Я использую последнюю стабильную версию Emacs, но не могу найти python.el в своей установке Emacs (я нашел только python.elc и python.el.gz под /path/to/emacs/share/emacs/24.3/lisp/progmodes) - person Amelio Vazquez-Reina; 18.06.2013
comment
Я имею в виду python.el.gz. Обычно связанные библиотеки имеют исходный код в *.el.gz файлах для экономии места на диске. Кстати, самый простой способ посетить файл — открыть <f1> f python-mode RET и щелкнуть ссылку на файл. - person tkf; 18.06.2013
comment
@tkf Поскольку python.el предоставляет 'python -- что хорошо, поскольку python-mode.el предоставляет 'python-mode -- возможно, полезно писать режим python при ссылке на python.el, а в противном случае - режим python. Просто идея. - person Andreas Röhler; 18.06.2013
comment
Под режимом python я имел в виду основной режим. И python.el, и python-mode.el определяют функцию с именем python-mode. Так что думаю путаницы нет. - person tkf; 18.06.2013

arrow_upward
2
arrow_downward

https://blueprints.launchpad.net/python-mode/+documentation

Тем временем это предлагает некоторые основные часто задаваемые вопросы.

python-mode.el предназначен для поддержки ipdb и всех других отладчиков прямо с места. Конфигурация, описанная в верхней части python.el, не требуется, так как все это реализовано. Большинство команд говорят сами за себя. Каждая команда имеет строку документации, которую пользователи сочтут полезной для некоторых функций, таких как py-expression. Также там сообщаются возвращаемые значения.

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

http://www.gnu.org/software/emacs/manual/html_node/emacs/Menu-Bar.html

python-mode.el перечисляет команды вместе с пояснениями в каталоге «doc».

Прочитайте комментарии, как было предложено. После этого можно использовать outline-mode или hs-minor-mode, чтобы совершить экскурсию по символам.

Наконец: M-x py-TAB, соотв. M-x python-TAB перечисляет реализованные команды. Как только имя известно, вызовите его документ Ctrl-h f

Оба режима должны работать с IPython/ipdb.

Кажется, несколько Howto в сети.

Может быть, проконсультируйтесь с этим

http://gremu.net/blog/2010/using-ipythons-debugger-pdb-replacement/

Пожалуйста, отправьте отчет об ошибке, если вы не можете заставить его работать.

Что касается python-mode.el:

https://bugs.launchpad.net/python-mode

Что касается python.el: M-x report-emacs-bug RET

person Andreas Röhler    schedule 18.06.2013