FindPython2

Поиск интерпретатора, компилятора и среды разработки Python 2 (включая каталоги заголовков и библиотеки).

Поддерживаются три компонента:

• Interpreter: поиск интерпретатора Python 2
• Compiler: поиск компилятора Python 2. Предлагается только IronPython.
• Development: поиск артефактов разработки (каталоги заголовков и библиотеки)
• NumPy: поиск каталогов заголовков NumPy.

Если COMPONENTS не указан, предполагается Interpreter.

Для обеспечения согласованных версий между компонентами Interpreter, Compiler, Development и NumPy, укажите все компоненты одновременно:

find_package (Python2 COMPONENTS Interpreter Development)

Этот модуль ищет только версию 2 Python. Этот модуль можно использовать совместно с модулем FindPython3, чтобы использовать обе версии Python.

Модуль FindPython можно использовать, если версия Python не имеет значения.

Импортированные цели

Этот модуль определяет следующие импортированные цели (когда CMAKE_ROLE равно PROJECT):

Python2::Interpreter

Интерпретатор Python 2. Цель определена, если найден компонент Interpreter.

Python2::Compiler

Компилятор Python 2. Цель определена, если найден компонент Compiler.

Python2::Python

Библиотека Python 2 для встраивания Python. Цель определена, если найден компонент Development.

Python2::Module

Библиотека Python 2 для модулей Python. Цель определена, если найден компонент Development.

Python2::NumPy

Библиотека NumPy для Python 2. Цель определена, если найден компонент NumPy.

Переменные результатов

Этот модуль установит следующие переменные в вашем проекте (см. Стандартные имена переменных):

Python2_FOUND

Система имеет запрошенные компоненты Python 2.

Python2_Interpreter_FOUND

Система имеет интерпретатор Python 2.

Python2_EXECUTABLE

Путь к интерпретатору Python 2.

Python2_INTERPRETER_ID

Короткая строка, уникальная для интерпретатора. Возможные значения:

• Python
• ActivePython
• Anaconda
• Canopy
• IronPython

Python2_STDLIB

Стандартный независимый от платформы каталог установки.

Информация, возвращаемая distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=True).

Python2_STDARCH

Стандартный зависимый от платформы каталог установки.

Информация, возвращаемая distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=True).

Python2_SITELIB

Независимый от платформы каталог установки сторонних библиотек.

Информация, возвращаемая distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=False).

Python2_SITEARCH

Зависимый от платформы каталог установки сторонних библиотек.

Информация, возвращаемая distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=False).

Python2_Compiler_FOUND

Система имеет компилятор Python 2.

Python2_COMPILER

Путь к компилятору Python 2. Предлагается только IronPython.

Python2_COMPILER_ID

Короткая строка, уникальная для компилятора. Возможные значения:

• IronPython

Python2_Development_FOUND

Система имеет артефакты разработки Python 2.

Python2_INCLUDE_DIRS

Каталоги заголовков Python 2.

Python2_LIBRARIES

Библиотеки Python 2.

Python2_LIBRARY_DIRS

Каталоги библиотек Python 2.

Python2_RUNTIME_LIBRARY_DIRS

Каталоги библиотек Python 2 runtime.

Python2_VERSION

Версия Python 2.

Python2_VERSION_MAJOR

Основная версия Python 2.

Python2_VERSION_MINOR

Дополнительная версия Python 2.

Python2_VERSION_PATCH

Версия дополнений Python 2.

Python2_NumPy_FOUND

Система имеет NumPy.

Python2_NumPy_INCLUDE_DIRS

Каталоги заголовков NumPy.

Python2_NumPy_VERSION

Версия NumPy.

Рекомендации

Python2_ROOT_DIR

Определите корневой каталог установки Python 2.

Python2_USE_STATIC_LIBS

• Если не определено, поиск будет осуществляться по разделяемым библиотекам и статическим библиотекам в указанном порядке.
• Если установлено в TRUE, поиск будет осуществляться только по статическим библиотекам.
• Если установлено в FALSE, поиск будет осуществляться только по разделяемым библиотекам.

Python2_FIND_STRATEGY

Эта переменная определяет способ поиска. Переменная Python2_FIND_STRATEGY может быть пустой или иметь одно из следующих значений:

• VERSION: Попытка найти последнюю версию во всех указанных местоположениях. Это значение по умолчанию, если политика CMP0094 не определена или установлена в OLD.
• LOCATION: Остановка поиска, как только будет найдена версия, удовлетворяющая ограничениям версии. Это значение по умолчанию, если политика CMP0094 установлена в NEW.

Python2_FIND_REGISTRY

В Windows переменная Python2_FIND_REGISTRY определяет порядок предпочтения между реестром и переменными среды. Переменная Python2_FIND_REGISTRY может быть пустой или иметь одно из следующих значений:

• FIRST: Попытка использовать реестр до переменных среды. Это значение по умолчанию.
• LAST: Попытка использовать реестр после переменных среды.
• NEVER: Никогда не пытаться использовать реестр.

Python2_FIND_FRAMEWORK

В macOS переменная Python2_FIND_FRAMEWORK определяет порядок предпочтения между компонентами пакетов в стиле Apple и unix-стиле. Эта переменная может быть пустой или принимать те же значения, что и переменная CMAKE_FIND_FRAMEWORK.

Примечание

Значение ONLY не поддерживается, поэтому будет использоваться FIRST.

Если Python2_FIND_FRAMEWORK не определено, будет использована переменная CMAKE_FIND_FRAMEWORK, если она определена.

Python2_FIND_VIRTUALENV

Эта переменная определяет обработку виртуальных сред. Она имеет значение только при активной виртуальной среде (т.е. после выполнения скрипта activate). В этом случае она имеет приоритет перед переменными Python2_FIND_REGISTRY и CMAKE_FIND_FRAMEWORK. Переменная Python2_FIND_VIRTUALENV может быть пустой или иметь одно из следующих значений:

• FIRST: Виртуальная среда используется перед стандартными путями для поиска интерпретатора. Это значение по умолчанию.
• ONLY: Используется только виртуальная среда для поиска интерпретатора.
• STANDARD: Виртуальная среда не используется для поиска интерпретатора. В этом случае переменная Python2_FIND_REGISTRY (Windows) или CMAKE_FIND_FRAMEWORK (macOS) можно установить со значением LAST или NEVER для выбора интерпретатора из виртуальной среды по умолчанию.

Команды

Этот модуль определяет команду Python_add_library (когда CMAKE_ROLE равно PROJECT). Она имеет ту же семантику, что и add_library(), добавляет зависимость к цели Python2::Python или, когда тип библиотеки MODULE, к цели Python2::Module, и учитывает правила именования модулей Python:

Python2_add_library (my_module MODULE src1.cpp)

Если тип библиотеки не указан, предполагается MODULE.