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)

Этот модуль ищет только версию 2 Python. Этот модуль можно использовать совместно с модулем 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 для модулей Python.

Python2_Development.Embed_FOUND

Новое в версии 3.18.

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

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 и Unix. Эта переменная может принимать те же значения, что и переменная 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.