FindPython2

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

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

• Interpreter: поиск интерпретатора Python 2
• Compiler: поиск компилятора Python 2. Предлагается только для IronPython.

• Development: поиск артефактов разработки (каталоги заголовков и библиотеки).

  Добавлен в версии 3.18: Этот компонент включает два подкомпонента, которые можно указать независимо:

  • Development.Module: поиск артефактов для разработки модулей Python 2.
  • Development.Embed: поиск артефактов для разработки встраивания Python 2.
• NumPy: поиск каталогов заголовков NumPy.

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

Если указан компонент Development, это подразумевает подкомпоненты Development.Module и Development.Embed.

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

find_package (Python2 COMPONENTS Interpreter Development)

Этот модуль ищет только версии Python 2. Этот модуль можно использовать совместно с модулем FindPython3 для использования обеих версий Python.

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

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

Этот модуль определяет следующие Импортированные цели:

Python2::Interpreter

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

Python2::InterpreterDebug

Добавлен в версии 3.30.

Отладочный интерпретатор Python 2. Эта цель определена только если найден компонент Interpreter и переменная Python2_EXECUTABLE_DEBUG определена. Цель определена только на платформе Windows.

Python2::InterpreterMultiConfig

Добавлен в версии 3.30.

Интерпретатор Python 2. Будет использована версия интерпретатора релиз или отладка, в зависимости от контекста (платформы, конфигурации). Эта цель определена только если найден компонент Interpreter.

Python2::Compiler

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

Python2::Module

Добавлен в версии 3.15.

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

Python2::Python

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

Python2::NumPy

Добавлен в версии 3.14.

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

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

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

Python2_FOUND

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

Python2_Interpreter_FOUND

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

Python2_EXECUTABLE

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

Python2_EXECUTABLE_DEBUG

Добавлен в версии 3.30.

Путь к отладочному интерпретатору Python 2. Он определён только на платформе Windows.

Python2_INTERPRETER

Добавлен в версии 3.30.

Путь к интерпретатору Python 2, определённый с помощью generator expression для выбора переменной Python2_EXECUTABLE или Python2_EXECUTABLE_DEBUG в зависимости от контекста (платформа, конфигурация).

Python2_INTERPRETER_ID

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

• Python
• ActivePython
• Anaconda
• Canopy
• IronPython
• PyPy

Python2_STDLIB

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

Информация полученная от sysconfig.get_path('stdlib') или же distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=True).

Python2_STDARCH

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

Информация полученная от sysconfig.get_path('platstdlib') или же distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=True).

Python2_SITELIB

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

Информация полученная от sysconfig.get_path('purelib') или же distutils.sysconfig.get_python_lib(plat_specific=False,standard_lib=False).

Python2_SITEARCH

Третьей стороной каталог установки, зависящий от платформы.

Информация полученная от sysconfig.get_path('platlib') или же 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_DOTNET_LAUNCHER

Добавлен в версии 3.18.

Интерпретатор .Net. Используется только реализацией IronPython.

Python2_Development_FOUND

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

Python2_Development.Module_FOUND

Добавлен в версии 3.18.

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

Python2_Development.Embed_FOUND

Добавлен в версии 3.18.

Система имеет артефакты разработки для встраивания Python 2.

Python2_INCLUDE_DIRS

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

Python2_DEBUG_POSTFIX

Приставка для отладочного модуля Python. Эта переменная может быть использована для определения свойства целевого объекта DEBUG_POSTFIX.

Python2_LINK_OPTIONS

Добавлен в версии 3.19.

Параметры линковки Python 2. Некоторые конфигурации требуют специфических параметров линковки для корректной сборки и выполнения.

Python2_LIBRARIES

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

Python2_LIBRARY_DIRS

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

Python2_RUNTIME_LIBRARY_DIRS

Каталоги библиотек выполнения Python 2.

Python2_VERSION

Версия Python 2.

Python2_VERSION_MAJOR

Главная версия Python 2.

Python2_VERSION_MINOR

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

Python2_VERSION_PATCH

Версия исправления Python 2.

Python2_PyPy_VERSION

Добавлен в версии 3.18.

Версия PyPy для Python 2.

Python2_NumPy_FOUND

Добавлен в версии 3.14.

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

Python2_NumPy_INCLUDE_DIRS

Добавлен в версии 3.14.

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

Python2_NumPy_VERSION

Добавлен в версии 3.14.

Версия NumPy.

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

Python2_ROOT_DIR

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

Python2_USE_STATIC_LIBS

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

Примечание

Этот совет будет проигнорирован на Windows из-за отсутствия статических библиотек на этой платформе.

Python2_FIND_STRATEGY

Добавлен в версии 3.15.

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

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

См. также Python2_FIND_UNVERSIONED_NAMES.

Python2_FIND_REGISTRY

Добавлен в версии 3.13.

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

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

Python2_FIND_FRAMEWORK

Добавлен в версии 3.15.

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

Примечание

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

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

Python2_FIND_VIRTUALENV

Добавлен в версии 3.15.

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

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

Добавлен в версии 3.17: Добавлена поддержка сред conda.

Примечание

Если запрашивается компонент Development, настоятельно рекомендуется также включить компонент Interpreter, чтобы получить ожидаемый результат.

Python2_FIND_IMPLEMENTATIONS

Добавлен в версии 3.18.

Эта переменная определяет, в упорядоченном списке, различные реализации, которые будут искаться. Переменная Python2_FIND_IMPLEMENTATIONS может принимать следующие значения:

• CPython: Это стандартная реализация. Различные продукты, такие как Anaconda или ActivePython, полагаются на эту реализацию.
• IronPython: Эта реализация использует язык CSharp для .NET Framework поверх Dynamic Language Runtime (DLR). См. IronPython.
• PyPy: Эта реализация использует язык RPython и RPython translation toolchain для создания интерпретатора Python. См. PyPy.

Значение по умолчанию:

• Платформа Windows: CPython, IronPython
• Другие платформы: CPython

Примечание

Этот совет имеет наименьший приоритет из всех советов, поэтому даже если, например, вы укажете IronPython в первую очередь, а CPython во вторую, продукт Python, основанный на CPython, может быть выбран, потому что, например, с Python2_FIND_STRATEGY=LOCATION, каждое место будет искаться сначала для IronPython и во вторую для CPython.

Примечание

Когда указан IronPython, на платформах, отличных от Windows, ожидается, что интерпретатор .Net (т.е. команда mono) будет доступен через переменную PATH.

Python2_FIND_UNVERSIONED_NAMES

Добавлен в версии 3.20.

Эта переменная определяет, как будут выполняться поиск общих имён. В настоящее время это применяется только к общим именам интерпретатора, а именно python2 и python. Переменная Python2_FIND_UNVERSIONED_NAMES может быть установлена в одно из следующих значений:

• FIRST: Общие имена ищутся до более специализированных (например, python2.5).
• LAST: Общие имена ищутся после более специализированных. Это значение по умолчанию.
• NEVER: Общие имена не ищутся вообще.

См. также Python2_FIND_STRATEGY.

Спецификация артефактов

Для решения специальных случаев можно напрямую указать артефакты, установив следующие переменные:

Python2_EXECUTABLE

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

Python2_COMPILER

Путь к компилятору.

Python2_DOTNET_LAUNCHER

Добавлен в версии 3.18.

Интерпретатор .Net. Используется только реализацией IronPython.

Python2_LIBRARY

Путь к библиотеке. Он будет использован для вычисления переменных Python2_LIBRARIES, Python2_LIBRARY_DIRS и Python2_RUNTIME_LIBRARY_DIRS.

Python2_INCLUDE_DIR

Путь к каталогу заголовков Python. Будет использован для вычисления переменной Python2_INCLUDE_DIRS.

Python2_NumPy_INCLUDE_DIR

Путь к каталогу заголовков NumPy. Будет использован для вычисления переменной Python2_NumPy_INCLUDE_DIRS.

По умолчанию этот модуль поддерживает несколько вызовов в разных каталогах проекта с разными требованиями к версии/компонентам, обеспечивая корректные и согласованные результаты для каждого вызова. Для поддержки этого поведения кэш CMake не используется традиционным способом, что может быть проблематично для интерактивного задания. Поэтому, для включения интерактивного задания, поведение модуля может быть контролировано с помощью следующей переменной:

Python2_ARTIFACTS_INTERACTIVE

Добавлен в версии 3.18.

Выбирает поведение модуля. Это булева переменная:

• Если установлено в TRUE, создать записи кэша CMake для вышеуказанных переменных задания артефактов, чтобы пользователи могли редактировать их интерактивно. Это отключает поддержку множественных требований к версиям/компонентам.
• Если установлено в FALSE или не определено, включить поддержку множественных требований к версиям/компонентам.

Команды

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

Python2_add_library (<name> [STATIC | SHARED | MODULE]
                     <source1> [<source2> ...])

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