Отладка QGIS расширения в PyCharm: различия между версиями
Нет описания правки |
|||
| Строка 20: | Строка 20: | ||
'''Для Linux''' | '''Для Linux''' | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
sudo easy_install ~/Soft/pycharm-3.4.1/pycharm-debug.egg | $ sudo easy_install ~/Soft/pycharm-3.4.1/pycharm-debug.egg | ||
</syntaxhighlight> | |||
'''Для Windows''' | |||
<syntaxhighlight lang="bash"> | |||
python c:\Python27\Scripts\easy_install.py c:\Soft\pycharm-3.4.1\pycharm-debug.egg | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Версия от 11:36, 27 ноября 2014
В данной заметке описан один из способов отладки кода расширения QGIS в среде разработки JetBrains PyCharm версии 3.4 и выше
Описание проблемы
При разработке расширений QGIS на python не редко встает проблема отладки кода. К сожалению, для отладки модуля в "родном окружении" необходимо запустить QGIS, который и загрузит разрабатываемое расширение в своем процессе. При этом режим интерактивной отладки из среды разработки(IDE) становится недоступным, так как код расширения запущен не в режиме отладки (pdb), а в стандартном процессе-интерпретаторе Python.
Для того, что бы иметь возможность отлаживать части кода в IDE можно воспользоваться механизмом Remote Debug (удаленная отладка). В этом случае, код, выполняемый в другом процессе, может сам инициировать остановку исполнения и передать управление другому процессу, например нашей IDE.
Этим способом можно воспользоваться в различных IDE. В заметке описывается вариант для PyCharm версии 3.4 или выше.
Предварительные настройки
Предполагается, что PyCharm и QGIS уже установлены и настроены.
Так же, для удобства отладки желательно установить QGIS расширение Plugin Reloader. Этот модуль позволяет перезагружать разрабатываемое расширение, например в следствии изменения кода, без перезапуска самого QGIS.
Для возможности использовать удаленную отладку необходимо установить пакет pydevd в тот PYTHONPATH, с которым запускается QGIS. В общем случае это директория site-package системного Python. В случае использования OSGEO4W или нестандартной установки необходимо выбирать соответствующий интерпретатор\директорию установки.
Пакет pydevd распространяется вместе с PyCharm. Обычно файл pycharm-debug.egg (pycharm-debug-py3k.egg если использвется Python 3) находится в корневой директории установки PyCharm. Установить пакет можно различными способами. Наиболее простой - с помощью easy_install или pip:
Для Linux
$ sudo easy_install ~/Soft/pycharm-3.4.1/pycharm-debug.egg
Для Windows
python c:\Python27\Scripts\easy_install.py c:\Soft\pycharm-3.4.1\pycharm-debug.egg