VS Code Linux

Инструкция написана для версии VS Code 1.86.2.

Установка расширений.

После запуска VS Code, нужно установить расширение для работы с python. Для этого нужно выбрать из левого бокового меню, вкладку «Extensions» (Ctrl+Shift+X), набрать в поиске «Python» и установить расширение.

Создание проекта.

Сначала, нужно создать папку проекта, например: ~/VSCodeProjects/pythonProject.

Затем, в меню «File», нужно выбрать пункт «Open folder…» (Ctrl+O) и открыть ранее созданную папку.

Создание виртуального окружения.

Сначала нужно открыть менеджер команд (Ctrl+Shift+P) «Command Palette».
Затем нужно выбрать команду Python: Create Environment... и выбрать вариант Venv.
Далее, нужно ввести путь к питону Аксиомы
в поле Enter interpreter path...: /opt/axioma-gis5/python/bin/python3.8.
Дождаться когда VS Code создаст виртуальное окружение.

Настройка виртуального окружения.

После создания виртуального окружения, его нужно настроить, чтобы оно могло обнаружить axipy. Для этого, нужно открыть файл .venv/pyvenv.cfg на редактирование. В нем, нужно изменить значение параметра «include-system-site-packages» на «true». Чтобы изменение вступило в силу, необходимо перезапустить VS Code.

Запуск кода.

Чтобы проверить работу VS Code с axipy, нужно создать файл main.py в папке проекта и выполнить следующий код:

from axipy import init_axioma, mainwindow

app = init_axioma()
mainwindow.show()
app.exec_()

В процессе ввода кода VS Code будет отображать подсказки.

Разработка плагинов (модулей) для Аксиомы.

В папке /opt/axioma-gis5/bin/python_plugins/ находятся встроенные модули Аксиомы. Их можно использовать как пример при написании плагинов.

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

pythonProject  # папка с проектом
├── ru_axioma_gis_axipy_example_plugin_minimal  # модуль
│   ├── __init__.py  # Точка входа модуля
│   └── manifest.ini # Описание модуля

Далее, нужно переименовать папку с модулем, например example_plugin_minimal (Название папки является уникальным идентификатором плагина). В файле manifest.ini нужно изменить отображаемое имя, чтобы найти плагин в списке модулей Аксиомы, например: name=Минимальный пользовательский плагин

Затем, нужно запустить Аксиому и добавить папку проекта в Дополнительные пути загрузки модулей. (Вкладка Основные | Настройки | Модули | Дополнительные модули | Настройки) Далее, нужно включить плагин в списке установленных плагинов. Теперь, при каждом запуске Аксиомы, плагин будет автоматически загружаться.

Подробнее о разработке плагинов можно прочитать в разделе Разработка Плагинов (Модулей).