Зависимости
Плагины Аксиомы могут использовать сторонние библиотеки Python. Такой плагин во время установки обратится к каталогу пакетов PyPI и установит необходимые зависимости.
В коде плагина пакет импортируется обычным способом:
import numpy
...
Зависимости перечисляются в специальном файле requirements.txt
. Так плагин
с зависимостями может иметь следующую структуру:
ru_axioma_gis_axipy_example_plugin_from_package
├── __init__.py
├── manifest.ini
└── requirements.txt
Файл является простым текстовым файлом в кодировке UTF-8
, в котором
построчно перечислены необходимые пакеты. Например:
numpy
requests
idna
Примечание
В настоящий момент нет возможности указать версию пакета.
Без интернета. Ручная установка пакетов.
Может возникнуть ситуация, когда устанавливаемый плагин имеет внешние зависимости, а доступа к каталогу пакетов PyPI нет. Плагин не сможет успешно установиться.
В этом случае можно скачать все необходимые зависимые пакеты на компьютере, который имеет доступ к интернету и конкретно к каталогу пакетов PyPI, а затем перенести их на целевой компьютер.
Для этого рекомендуется:
Установить ГИС Аксиома на компьютер с доступом к сети Интернет (той же версии и платформы).
Извлечь из архива с плагином
.axp
файл зависимостейrequirements.txt
.Используя командную строку и интерпретатор Python внутри установленной Аксиомы, выполнить
python -m pip download -r requirements.txt --dest ./module_deps/
, где module_deps
- папка, в которую будут загружены зависимые пакеты.
Перенести зависимые пакеты на компьютер без интернета.
Аналогично, используя командную строку и интерпретатор Python внутри установленной Аксиомы, выполнить
python -m pip install -r requirements.txt --user --no-index --find-links ./module_deps/
Установить архив с плагином
*.axp
.
Определить каталог, куда будут устанавливаться зависимые python пакеты можно следующей командой:
python -m site --user-site
Результат:
C:\Users\user\AppData\Roaming\Python\Python37\site-packages
Для ориентировки, примерное расположение в зависимости от системы будет следующее:
Расположение каталога site-packages
для Windows – «%APPDATA%pythonpython<VERSION>site-packages»
для Linux – «$HOME/.local/lib/python<VERSION>/site-packages»
для macOS – «$HOME/Library/Python/<VERSION>/lib/python/site-packages»
Можно использовать для этих целей командный файл.
Пример скрипта для linux (install_requirement), где в качестве параметра можно передать имя файла с набором пакетов. Если параметр опущен, берется файл из текущего каталога requirements.txt:
#!/bin/bash
AXIOMA_BASE=/opt/Axioma.GIS
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${AXIOMA_BASE}/bin
if [ -z "$1" ]; then
filename="requirements.txt"
else
filename="$1"
fi
${AXIOMA_BASE}/python/bin/python3 -m pip install --user -r ${filename}
Пример команды для Windows (выполняется в консоли cmd.exe):
"C:/Program Files/Axioma v4/bin/python/python.exe" -m pip install --user -r requirements.txt
Если есть необходимость установить отдельный пакет по имени, то команда будет выглядеть следующим образом:
"C:/Program Files/Axioma v4/bin/python/python.exe" -m pip install --user qt5_applications
где qt5_applications наименование пакета, который необходимо установить.