Фултон Хэл — Программирование на языке Ruby

Модуль

реализует несколько директив Apache, в частности:

• 

определяет одну или несколько потребных библиотек;

• 

определяет обработчик для объекта Ruby;

• 

определяет имена переменных окружения, передаваемых сценариям;

• 

устанавливает переменные окружения;

• 

задает величину тайм-аута для Ruby-сценариев;

• 

задает уровень безопасности $SAFE;

• 

устанавливает кодировку символов для Ruby.

В состав пакета входят также классы и модули Ruby для взаимодействия с Apache. Модуль

(здесь слово «модуль» употребляется в смысле, принятом в Ruby) включает несколько функций, например и ; там же определены классы и .

— это обертка для типа данных , определяющая такие методы, как , , и т.д. Класс — обертка для типа данных ; он определяет, среди прочих, методы , и .

Имеются подробные инструкции по компиляции и установке пакета

. Обратитесь к поставляемой в комплекте с ним документации (или эквивалентной информации в Сети).

19.7.2. Использование erb

Для начала договоримся о терминологии. Речь не идет о встраивании интерпретатора Ruby в электронные устройства, скажем, в телевизор или тостер. Мы говорим о встраивании кода на Ruby в текст.

Далее отметим, что встраивать Ruby-код в текстовые файлы можно несколькими способами. В этом разделе мы рассмотрим лишь самый общеупотребительный инструмент, а именно программу

(автор Шуго Маэда).

Почему мы упоминаем подобный инструмент в связи с Web? Очевидно, потому, что чаще всего Ruby-код встраивается в HTML или XML-тексты.

Но можно придумать и другие применения. Например, в старомодных текстовых играх, или в каких-нибудь утилитах слияния почты, или как часть задания

для динамического создания файла с «сообщением дня» () в полночь. Не ограничивайте свое воображение. Ищите новые интересные применения и делитесь своими находками с сообществом. Большая часть примеров в этом разделе носит общий (и потому искусственный) характер, конкретно с HTML они почти не связаны.

Утилита

— это просто фильтр или препроцессор. Для выделения кода, выражений и комментариев, написанных на Ruby, применяется специальная нотация, весь остальной текст передается без изменений.

Текст, который нужно специально обрабатывать, заключается в скобки

и . Есть три вида такой нотации, отличающиеся первым символом внутри «тега».

Если первый символ — знак равенства (

), то содержимое рассматривается как выражение Ruby; результат его вычисления подставляется в текущее место файла, например:

Если назвать этот файл

, то для его фильтрации надо будет выполнить команду:

Результат направляется на стандартный вывод:

Комментарий вводится символом

:

Как и следовало ожидать, комментарии игнорируются, то есть мы увидим такой результат:

Все остальные символы после знака процента рассматриваются как часть кода. Все, что этот код выводит (не результат вычисления значения), помещается в текстовый поток. Для удобства восприятия рекомендую оставлять после процента пробел, хотя

этого и не требует.

В следующем примере тег в первой строчке ничего не вставляет в текст, так как ничего не выводит. Во вторую же строку вставляется

, как и следовало ожидать.

Результат получается такой:

Фрагменты кода на Ruby не являются независимыми. Так, переменную, определенную в одном теге, можно использовать в следующем за ним.

Пробелы внутри тегов в последней строке необязательны, но с ними текст становится понятнее. Выводится следующий текст:

Попробуйте сделать внутри тега синтаксическую ошибку. Вы обнаружите, что

выдает очень подробное сообщение, в котором печатается сгенерированный код и максимально точно указывается место ошибки.

Что если включить «магическую строку» в сам текст в виде литерала? Экранирование с помощью обратной косой черты не работает. Мы рекомендуем такой способ:

Результат таков: