Вход:  Пароль:  
FreeSource: AltLinux/Policy/Ruby ...
Free Source | Каталог | Изменения | НовыеКомментарии | Пользователи | Регистрация |
Эта страница была перенесена на altlinux.org. Текст на freesource.info заморожен.

Ruby Packaging Policy


СтатусДействующая политика с 16 апреля 2008
АвторAlexey I. Froloff
Обязательно в4.1 и выше
Метабагпока не создан

Правила упаковки модулей и программ на языке Ruby.


Оглавление документа

Пакет ruby и его обновление


Основная часть интерпретатора ruby находится в пакете libruby. Это библиотека libruby.so.X.Y и каталоги, входящие в $LOAD_PATH.


В системе и в публичном репозитарии может находиться только она версия пакета libruby.


При сборке новой версии ruby из-за изменения $LOAD_PATH необходимо пересобрать все пакеты, имеющие зависимости (прямые или косвенные) на пакет libruby.

Внешний вид пакетов


Пакеты должны иметь префикс “ruby-". Если оригинальное название не включает этот префикс, он добавляется к имени пакета, например rcairo -> ruby-rcairo. Исключение составляют пакеты, оригинальное название которых содержит постфикс “-ruby”, например “sqlite3-ruby”.


Префикс “ruby-module-" является излишним и допустим только для модулей, собирающихся из пакета ruby.


Пакеты должны иметь группу Development/Ruby.


Вышесказанное относится к pure-module пакетам, а не end-user программам, написанным на языке ruby (например alexandria). В этом случае имя и группа пакета должны соответствовать действительности.


Пакет должен иметь архитектуру noarch если не содержит архитектурно-зависимых компонентов, упаковка ruby не накладывает дополнительных ограничений.

Расположение файлов


Все модули, которые могут использоваться в «обычной программе на языке ruby», должны помещать свои файлы в так называемые “vendor dirs”, описываемые макросами %ruby_sitelibdir и %ruby_sitearchdir. Каталоги %ruby_libdir и %ruby_archdir используются исключительно для модулей, собирающихся из пакета ruby.

Макросы RPM


Макросы находятся в пакете rpm-build-ruby. Рекомендуется добавить в spec строчку:



Макросописание
каталоги
%ruby_sitearchdir%_libdir/ruby/vendor_ruby/$VERSION/$ARCH/
%ruby_sitelibdir%_datadir/ruby/vendor_ruby/$VERSION/
%ruby_archdir%_libdir/ruby/$VERSION/$ARCH/
%ruby_libdir%_datadir/ruby/$VERSION/
%ruby_siteincludedir/usr/include/ruby/$VERSION/ (изменится в ruby >= 1.9)
%ruby_includedir/usr/include/ruby/$VERSION/
%ruby_ri_sitedir%_datadir/ri/$VERSION/site/
опции поиска зависимостей
%set_ruby_req_methodstrict, normal или relaxed
%add_ruby_lib_pathдобавляет путь для поиска Provides
%add_ruby_weakprov_pathдобавляет путь для поиска «статически слинкованных» модулей (пример использования в пакете ruby-actionpack)
сборка и установка
%ruby_vendorruby -rvendor-specific
%rdocвызов rdoc (для секции %indtall) с опциями --ri-site --all
setup.rb имени Minero Aoki
%_ruby_setup_rbпуть к setup.rb (по умолчанию setup.rb)
%ruby_setup_rb%ruby_vendor %_ruby_setup_rb
%ruby_config%ruby_setup_rb config
%ruby_build%ruby_setup_rb setup
%ruby_install%ruby_setup_rb install --prefix=%buildroot
mkmf и extconf.rb
%ruby_configure%ruby_vendor extconf.rb --ruby=/usr/bin/ruby
rake и Rakefile
%rake%ruby_vendor %_bindir/rake
%rake_installDESTDIR=%buildroot %rake install

Зависимости


В пакете rpm-build-ruby (начиная с версии 1:0.0.1-alt1 или в branch/4.1) реализован автоматический поиск зависимостей. Таким образом все зависимости, поставленные вручную, являются не только бесполезными, но и вредными (за исключением особых случаев).


Зависимости имеют вид ruby(ИМЯ/МОДУЛЯ) и не привязаны к конкретной версии ruby. Для модулей, расположенных внутри каталогов, входящих в $LOAD_PATH дополнительно появляется зависимость на конкретный каталог. Стандартные каталоги принадлежат пакету libruby. Это косвенная привязка к версии ruby. Такие пакеты необходимо пересобрать при изменении версии ruby.


Зависимости, найденные внутри блоков begin/rescue и внутри методов не экспортируются. Также не экспортируются зависимости, которые невозможно разрешить в имя модуля, например 'require «rake/tasks/#{task}.raketask»'.


В случае «маскирования» зависимостей в коде (например при помощи блока begin/rescue) мантейнер пакета должен самостоятельно принять решение, убрать «маскировку» патчем, добавить в спек Requires: ruby(ИМЯ/МОДУЛЯ) или оставить всё как есть в зависимости от величины ущерба для функциональности пакета.


Автоматический поиск зависимостей не отслеживает изменение $LOAD_PATH, в этих случаях надо вручную добавить необходимые каталоги к путям поиска при помощи макроса %add_ruby_lib_path.

Rubygems


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


Есть мнение, неоднократно доказанное экспериментально, что любой пакет можно отучить требовать rubygems без ущерба для его функциональности.


 
Файлов нет. [Показать файлы/форму]
Комментариев нет. [Показать комментарии/форму]