FindPython3
Поиск интерпретатора, компилятора и среды разработки Python 3 (включая каталоги заголовков и библиотеки).
Поддерживаются три компонента:
-
Interpreter: поиск интерпретатора Python 3 -
Compiler: поиск компилятора Python 3. Предлагается только IronPython. -
Development: поиск артефактов разработки (каталоги заголовков и библиотеки) -
NumPy: поиск каталогов заголовков NumPy.
Если COMPONENTS не указан, предполагается Interpreter.
Для обеспечения согласованности версий компонентов Interpreter, Compiler, Development и NumPy, укажите все компоненты одновременно:
find_package (Python3 COMPONENTS Interpreter Development)
Этот модуль ищет только версию 3 Python. Этот модуль может использоваться совместно с модулем FindPython2, чтобы использовать обе версии Python.
Модуль FindPython можно использовать, если версия Python не имеет значения.
Примечание
Если оба компонента Interpreter и Development указаны, этот модуль ищет только интерпретатор с той же архитектурой платформы, что и определена конфигурацией CMake. Это ограничение не применяется, если указан только компонент Interpreter.
Импортированные цели
Этот модуль определяет следующие Импортированные цели (если CMAKE_ROLE имеет значение PROJECT):
-
Python3::Interpreter -
Интерпретатор Python 3. Цель определена, если найден компонент
Interpreter. -
Python3::Compiler -
Компилятор Python 3. Цель определена, если найден компонент
Compiler. -
Python3::Python -
Библиотека Python 3. Цель определена, если найден компонент
Development. -
Python3::NumPy -
Библиотека NumPy для Python 3. Цель определена, если найден компонент
NumPy.
Переменные результатов
Этот модуль установит следующие переменные в вашем проекте (см. Стандартные имена переменных):
-
Python3_FOUND -
Система имеет запрашиваемые компоненты Python 3.
-
Python3_Interpreter_FOUND -
Система имеет интерпретатор Python 3.
-
Python3_EXECUTABLE -
Путь к интерпретатору Python 3.
-
Python3_INTERPRETER_ID -
- Короткая строка, уникальная для интерпретатора. Возможные значения включают:
-
- Python
- ActivePython
- Anaconda
- Canopy
- IronPython
-
Python3_STDLIB -
Стандартный независимый от платформы каталог установки.
Информация, возвращаемая
distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=True). -
Python3_STDARCH -
Стандартный зависящий от платформы каталог установки.
Информация, возвращаемая
distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=True). -
Python3_SITELIB -
Независимый от платформы каталог установки сторонних библиотек.
Информация, возвращаемая
distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=False). -
Python3_SITEARCH -
Зависимый от платформы каталог установки сторонних библиотек.
Информация, возвращаемая
distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=False). -
Python3_Compiler_FOUND -
Система имеет компилятор Python 3.
-
Python3_COMPILER -
Путь к компилятору Python 3. Предлагается только IronPython.
-
Python3_COMPILER_ID -
- Короткая строка, уникальная для компилятора. Возможные значения включают:
-
- IronPython
-
Python3_Development_FOUND -
Система имеет артефакты разработки Python 3.
-
Python3_INCLUDE_DIRS -
Каталоги заголовков Python 3.
-
Python3_LIBRARIES -
Библиотеки Python 3.
-
Python3_LIBRARY_DIRS -
Каталоги библиотек Python 3.
-
Python3_RUNTIME_LIBRARY_DIRS -
Каталоги библиотек времени выполнения Python 3.
-
Python3_VERSION -
Версия Python 3.
-
Python3_VERSION_MAJOR -
Основная версия Python 3.
-
Python3_VERSION_MINOR -
Дополнительная версия Python 3.
-
Python3_VERSION_PATCH -
Версия исправления Python 3.
-
Python3_NumPy_FOUND -
Система имеет NumPy.
-
Python3_NumPy_INCLUDE_DIRS -
Каталоги заголовков NumPy.
-
Python3_NumPy_VERSION -
Версия NumPy.
Рекомендации
-
Python3_ROOT_DIR -
Определите корневой каталог установки Python 3.
-
Python3_USE_STATIC_LIBS -
- Если не определено, поиск общих и статических библиотек производится в этом порядке.
- Если установлено в TRUE, поиск производится только статических библиотек.
- Если установлено в FALSE, поиск производится только общих библиотек.
-
Python3_FIND_REGISTRY -
В Windows переменная
Python3_FIND_REGISTRYопределяет порядок предпочтения между реестром и переменными среды. ПеременнаяPython3_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 для её предпочтительного выбора.
Команды
Этот модуль определяет команду Python3_add_library (если CMAKE_ROLE имеет значение PROJECT), которая имеет ту же семантику, что и add_library(), но учитывает правила именования модулей Python (применяется только если тип библиотеки MODULE), и добавляет зависимость от цели Python3::Python.
Python3_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/FindPython3.html