FindPython
Поиск интерпретатора Python, компилятора и среды разработки (включая каталоги заголовочных файлов и библиотеки).
Поддерживаются три компонента:
-
Interpreter: поиск интерпретатора Python. -
Compiler: поиск компилятора Python. Предлагается только для IronPython. -
Development: поиск артефактов разработки (каталоги заголовочных файлов и библиотеки). -
NumPy: поиск каталогов заголовочных файлов NumPy.
Если COMPONENTS не указан, предполагается Interpreter.
Для обеспечения согласованной версии между компонентами Interpreter, Compiler, Development и NumPy, укажите все компоненты одновременно:
find_package (Python COMPONENTS Interpreter Development)
Этот модуль предпочтительно ищет версию 3 Python. Если не найдена, ищется версия 2. Для управления одновременными версиями 3 и 2 Python используйте модули FindPython3 и FindPython2, а не этот.
Примечание
Если компоненты Interpreter и Development указаны оба, этот модуль ищет только интерпретатор с архитектурой платформы, совпадающей с архитектурой, определенной конфигурацией CMake. Это ограничение не применяется, если указан только компонент Interpreter.
Импортированные цели
Этот модуль определяет следующие Импортированные цели (когда CMAKE_ROLE равно PROJECT):
-
Python::Interpreter -
Интерпретатор Python. Цель определена, если найден компонент
Interpreter. -
Python::Compiler -
Компилятор Python. Цель определена, если найден компонент
Compiler. -
Python::Python -
Библиотека Python. Цель определена, если найден компонент
Development. -
Python::NumPy -
Библиотека NumPy Python. Цель определена, если найден компонент
NumPy.
Переменные результатов
Этот модуль установит следующие переменные в вашем проекте (см. Стандартные имена переменных):
-
Python_FOUND -
Система имеет запрошенные компоненты Python.
-
Python_Interpreter_FOUND -
Система имеет интерпретатор Python.
-
Python_EXECUTABLE -
Путь к интерпретатору Python.
-
Python_INTERPRETER_ID -
- Короткая строка, уникальная для интерпретатора. Возможные значения включают:
-
- Python
- ActivePython
- Anaconda
- Canopy
- IronPython
-
Python_STDLIB -
Стандартный независимый от платформы каталог установки.
Информация возвращается
distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=True). -
Python_STDARCH -
Стандартный зависимый от платформы каталог установки.
Информация возвращается
distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=True). -
Python_SITELIB -
Вне зависимости от платформы, каталог установки сторонних библиотек.
Информация возвращается
distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=False). -
Python_SITEARCH -
Зависимый от платформы каталог установки сторонних библиотек.
Информация возвращается
distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=False). -
Python_Compiler_FOUND -
Система имеет компилятор Python.
-
Python_COMPILER -
Путь к компилятору Python. Предлагается только для IronPython.
-
Python_COMPILER_ID -
- Короткая строка, уникальная для компилятора. Возможные значения включают:
-
- IronPython
-
Python_Development_FOUND -
Система имеет артефакты разработки Python.
-
Python_INCLUDE_DIRS -
Каталоги заголовочных файлов Python.
-
Python_LIBRARIES -
Библиотеки Python.
-
Python_LIBRARY_DIRS -
Каталоги библиотек Python.
-
Python_RUNTIME_LIBRARY_DIRS -
Каталоги библиотек времени выполнения Python.
-
Python_VERSION -
Версия Python.
-
Python_VERSION_MAJOR -
Главная версия Python.
-
Python_VERSION_MINOR -
Дополнительная версия Python.
-
Python_VERSION_PATCH -
Релизная версия Python.
-
Python_NumPy_FOUND -
Система имеет NumPy.
-
Python_NumPy_INCLUDE_DIRS -
Каталоги заголовочных файлов NumPy.
-
Python_NumPy_VERSION -
Версия NumPy.
Подсказки
-
Python_ROOT_DIR -
Определите корневой каталог установки Python.
-
Python_USE_STATIC_LIBS -
- Если не определено, ищутся общие и статические библиотеки в этом порядке.
- Если установлено в TRUE, поиск только статических библиотек.
- Если установлено в FALSE, поиск только общих библиотек.
-
Python_FIND_REGISTRY -
В Windows переменная
Python_FIND_REGISTRYопределяет порядок предпочтения между реестром и переменными среды. ПеременнаяPython_FIND_REGISTRYможет быть пустой или одной из следующих:-
FIRST: Попытаться использовать реестр перед переменными среды. Это значение по умолчанию. -
LAST: Попытаться использовать реестр после переменных среды. -
NEVER: Никогда не пытаться использовать реестр.
-
-
CMAKE_FIND_FRAMEWORK -
В OS X переменная
CMAKE_FIND_FRAMEWORKопределяет порядок предпочтения между компонентами пакетов в стиле Apple и стиле Unix.Примечание
Значение
ONLYне поддерживается, поэтому используетсяFIRST.
Примечание
Если настроена виртуальная среда Python, установите переменную Python_FIND_REGISTRY (Windows) или CMAKE_FIND_FRAMEWORK (macOS) со значением LAST или NEVER для ее предпочтительного выбора.
Команды
Этот модуль определяет команду Python_add_library (когда CMAKE_ROLE равно PROJECT), которая имеет ту же семантику, что и add_library(), но учитывает правила именования модулей Python (применяется только если тип библиотеки MODULE), и добавляет зависимость от цели Python::Python:
Python_add_library (my_module MODULE src1.cpp)
Если тип библиотеки не указан, предполагается MODULE.
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.14/module/FindPython.html