FindRuby

Поиск Ruby

Этот модуль проверяет установку Ruby и определяет расположение файлов включаемых в него и библиотек. Поддерживаются Ruby версии от 1.8 до 3.1.

Минимальная необходимая версия Ruby может быть задана с использованием стандартного синтаксиса, например:

find_package(Ruby 2.5.1 EXACT REQUIRED)
# OR
find_package(Ruby 2.4)

Он также определяет имя библиотеки.

Виртуальные среды, такие как RVM, обрабатываются также путём передачи аргумента Ruby_FIND_VIRTUALENV

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

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

Ruby_FOUND

присваивается значение true, если ruby был успешно найден

Ruby_EXECUTABLE

полный путь к бинарному файлу ruby

Ruby_INCLUDE_DIRS

директории включаемых файлов для использования с библиотекой ruby

Ruby_LIBRARIES

Добавлено в версии 3.18: библиотеки, необходимые для использования ruby из C.

Ruby_VERSION

найденная версия ruby, например "1.8.7"

Ruby_VERSION_MAJOR

Основная версия Ruby.

Ruby_VERSION_MINOR

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

Ruby_VERSION_PATCH

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

RUBY_EXECUTABLE

то же, что и Ruby_EXECUTABLE.

RUBY_INCLUDE_DIRS

то же, что и Ruby_INCLUDE_DIRS.

RUBY_INCLUDE_PATH

то же, что и Ruby_INCLUDE_DIRS.

RUBY_LIBRARY

то же, что и Ruby_LIBRARY.

RUBY_VERSION

то же, что и Ruby_VERSION.

RUBY_FOUND

то же, что и Ruby_FOUND.

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

Ruby_ROOT_DIR

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

Ruby_FIND_VIRTUALENV

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

• FIRST: Виртуальная среда используется перед любыми другими стандартными путями для поиска интерпретатора. Это значение по умолчанию.
• ONLY: Используется только виртуальная среда для поиска интерпретатора.
• STANDARD: Виртуальная среда не используется для поиска интерпретатора (если она все ещё не присутствует в PATH...).