VS Code Windows

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

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

../../_images/Welcome3.png

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

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

../../_images/PythonExtension1.png

Далее, нужно создать папку проекта, например: C:\Users\User\VSCodeProjects\pythonProject.

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

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

Сначала нужно открыть менеджер команд (Ctrl+Shift+P) «Command Palette».
Затем нужно выбрать команду Python: Create Environment... и выбрать вариант Venv. Далее, нужно ввести путь к питону Аксиомы
в поле Enter interpreter path...: C:\Program Files\Axioma v5\bin\python\python.exe. Дождаться когда VS Code создаст виртуальное окружение.
../../_images/CommandPalette1.png

Запуск кода.

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

from axipy import init_axioma, mainwindow

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

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

../../_images/PopUpDocs3.png

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

В папке C:\Program Files\Axioma v5\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=Минимальный пользовательский плагин

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

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