gem help COMMAND вывести справку о команде COMMAND
(например, 'gem help install')
Дополнительная информация:
forge.org
Самые важные команды не вызывают
затруднений. Например, чтобы установить библиотеку
feedtools
, нужно выполнить команду:
gem install feedtools
Сначала она будет искать gem-пакет локально, а если не найдет, то обратится к серверу Ruby Forge. По умолчанию устанавливается последняя версия (хотя в некоторых случаях вам задают вопрос, какой именно пакет вы хотите установить). Можно и явно указать версию с помощью флага
– v
или
– -version
. Есть еще несколько флагов, управляющих установкой; подробную информацию дает команда
gem help install
.
Иногда gem-пакет зависит от других пакетов. В таком случае вас спросят, надо ли их устанавливать. Понятно, что, отказавшись от требуемых пакетов, вы не сможете установить и тот, что хотели изначально.
Как узнать имя нужного вам пакета? Если он находится на сайте RubyForge, то обычно называется так же, как проект. Например, программа
rake
находится на страницеили простопоэтому для установки нужно выполнить команду
gem install rake
.
Если вы не располагаете даже такой информацией, попробуйте воспользоваться командой
gem search
. Если указать часть предполагаемого имени gem-пакета, то будут найдены все пакеты с похожими именами. По умолчанию поиск производится на локальном компьютере; чтобы искать в центральном репозитории, задайте флаг
– -remote
. Например, команда
gem search xml --remote
нашла 12 пакетов.
Чтобы получить информацию об установленном пакете, введите команду
gem specification
— она напечатает все содержащиеся в пакете метаданные (в основном содержимое самого файла
gemspec
). Флаг
– -remot
e существует, но пока не реализован.
Кроме того, имеется команда деинсталляции
uninstall
, а также команды
query
и
list
, отчасти перекрывающие друг друга и команду
search
. Есть и еще много команд (дополнительную информацию вы найдете во встроенной справке или в онлайновой документации).
Полезно установить gem-сервер и на своей системе — не в качестве репозитория, из которого другие смогут дистанционно устанавливать пакеты, а как централизованный механизм, позволяющий просматривать в браузере все локально установленные пакеты вместе с документацией.
Для запуска gem-сервера просто наберите команду
gem_server
(обычно сервер работает в фоновом режиме). Указав в адресной строке браузера URL
localhost:8808
, вы увидите страницу «RubyGems Documentation Index», где в алфавитном порядке перечислены все установленные gem-пакеты со ссылками на документацию в формате
rdoc
и на домашнюю страницу проекта в Web.
О системе RubyGems можно еще многое сказать; к тому же она постоянно развивается. Самая актуальная информация
представлена на сайте http://rubygems.rubyforge.org.
21.2. Программа Rake
Утилита
rake
— это вариация на тему давно известной в UNIX программы
make
. Но вместо «странного» синтаксиса
make
, который все мы знаем и терпеть не можем, в
rake
используется код на самом Ruby. Программу написал Джим Вайрих (Jim Weirich); это первый, насколько мне известно, пример формальной реализации языка DSL (domain-specific language — язык предметной области) на Ruby.
Есть два варианта написания названия: Rake и
rake
. Первый - это название инструмента, второй — имя самого исполняемого файла. На мой взгляд, различие несущественное.
Нет сомнения, что на дизайн Rake оказала большое влияние программа make, так что терминология одна и та же. Как и раньше, мы говорим о целях, действиях, зависимостях и правилах.
Применениям Rake нет числа. Вы можете пользоваться ею для сборки проектов, написанных на С, C++ или Java (или на любом другом языке). Годится она и для генерирования документации с помощью RDoc, развертывания программ, обновления проекта на сайте Ruby Forge и множества других задач.
Неудивительно, что на вход Rake подается командный файл (rake-файл), который по умолчанию называется
rakefile
или
Rakefile
. Если вы хотите назвать его иначе, укажите имя с помощью флага
– f
или
– -rakefile
:
$ rake # Искать сначала 'rakefile', потом 'Rakefile'.
$ rake -f myfile # Использовать файл с именем 'myfile'.
Основная «единица работы» в Rake — задание; именуются задания посредством символов Ruby. Предполагается, что в каждом rake-файле есть задание по умолчанию
:default
— оно будет выполняться, если явно не указано другое имя.
$ rake # Выполнить задание по умолчанию.
$ rake mytask # Выполнить задание с именем 'mytask'.
Внутри rake-файла мы указываем задания с помощью метода
task
, передавая символ и блок:
task :mytask do
# ...
end
Содержимое блока в примере выше опущено. То, что в нем находится, называется действием.
В действии можно выполнять произвольный код на Ruby. Для типичных операций предусмотрены готовые методы. Так, метод
sh
(название которого напоминает об интерпретаторе команд в UNIX) запускает системную команду.
Методы
cp
,
mv
и
rm
предназначены соответственно для копирования, перемещения и удаления файлов. (Как и
make
, Rake беззастенчиво выдает свое происхождение от UNIX.) Есть и другие подобные команды; дополнительную информацию вы найдете в онлайновой документации на сайте http://docs.rubyrake.org.
При желании можете заключать блок в фигурные скобки, но обычно в этом случае интерпретатор Ruby ожидает, что параметры будут заключены в круглые скобки.