http://freesource.info/wiki/AltLinux/Sisyphus/ruby History/revisions of FreeSource/AltLinux/Sisyphus/ruby en-us http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-26+14%3A46%3A32 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a name=".altlinux.sisyphus.ruby" href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-26+14%3A46%3A32">2008-07-26 14:46:32</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby">2008-07-29 11:30:37</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><div class="action" style="float:right; width:250px"><div class="action-content">Эта&nbsp;страница была перенесена на&nbsp;<a href="http://altlinux.org/Ruby_Packaging_mini-HOWTO" target="_blank" title="" class="outerlink">altlinux.org</a>. Текст на&nbsp;freesource.info заморожен.</div></div></div><br /> <b>Удалено:</b><br /> <div class="deletions"><div class="action" style="float:right; width:250px"><div class="action-content">Эта&nbsp;страница была перенесена на&nbsp;<a href="http://altlinux.org/ruby" target="_blank" title="" class="outerlink">altlinux.org</a>. Текст на&nbsp;freesource.info заморожен.</div></div></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-25+02%3A20%3A10 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-25+02%3A20%3A10">2008-07-25 02:20:10</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-26+14%3A46%3A32">2008-07-26 14:46:32</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><div class="action" style="float:right; width:250px"><div class="action-content">Эта&nbsp;страница была перенесена на&nbsp;<a href="http://altlinux.org/ruby" target="_blank" title="" class="outerlink">altlinux.org</a>. Текст на&nbsp;freesource.info заморожен.</div></div><br /> Документация в&nbsp;формате RI&nbsp;генерируется при&nbsp;помощи утилиты <tt>rdoc</tt>, находящейся в&nbsp;пакете <tt>ruby-tool-rdoc</tt>. Для&nbsp;этого существует стандартный макрос <tt>%rdoc</tt> предназначенный для&nbsp;использования в&nbsp;секции <tt>%install</tt> (обычно одной из&nbsp;последних строк). В&nbsp;качестве аргументов этого макроса перечисляются файлы и&nbsp;каталоги с&nbsp;исходниками и&nbsp;при необходимости другие опции утилиты <tt>rdoc</tt>.<br /> Pure-ruby модули помещаются в&nbsp;<tt>%ruby_sitelibdir</tt>, бинарные модули в&nbsp;<tt>%ruby_sitearchdir</tt>, документация в&nbsp;формате RI&nbsp;в <tt>%ruby_ri_sitedir</tt> (при этом файл <tt>%ruby_ri_sitedir/created.rid</tt> упаковывать не&nbsp;нужно).<a name="h8599-1"></a><h2>Добро пожаловать в&nbsp;реальный мир</h2> В&nbsp;теории всё выглядит красиво, однако на&nbsp;практике среднего размера модуль представляет собой &laquo;нечто&raquo;, что&nbsp;может работать в&nbsp;любой помойке. Однако мы&nbsp;делаем не&nbsp;помойку, поэтому местечковые хаки нам&nbsp;не&nbsp;нужны.<a name="h8599-2"></a><h3>Не загрязняем <tt>$LOAD_PATH</tt> (<tt>$:</tt>)</h3> Очень часто в&nbsp;коде можно увидеть конструкции вида:<br /> $:.unshift File.join(File.dirname(<u>FILE</u>), '..', 'lib')<!--notypo--><textarea class="code" rows="13" readonly="readonly">Эта конструкция добавляет в ##$LOAD_PATH## некоторый путь. Сделано это для того, чтобы модуль (или исполняемый скрипт) можно было использовать из любого места. Поскольку в нашем случае все файлы пакуются в стандартные места, подобные конструкции не нужны. В большинстве случаев такие конструкции можно безболезненно удалить. ====Используем существующие модули и размаскируем зависимости==== Поскольку наша помойка не является &quot;любой&quot;, её ТТХ нам известны. Например, известно что это Linux, есть Iconv и так далее. Поэтому специфичный код, предназначенный для работы на других платформах в наших пакетах не нужен (а иногда бывает и вреден, поскольку даже &quot;мёртвый&quot; код может порождать зависимости, которые в некоторых случаях превращаются в unmet'ы). Также мы можем превратить опциональную зависимость в явную. Пример: begin require 'iconv' rescue LoadError module Iconv # Далее следует некоторый код, который в результате предоставляет API # похожий на API модуля iconv, возможно урезанный функционально. end end</textarea><!--/notypo--><br /> В&nbsp;данном случае <strong>всю</strong> эту&nbsp;сложную конструкцию можно заменить на&nbsp;одну строку <tt>require 'iconv'</tt>. Как&nbsp;бонус мы&nbsp;получаем зависимость на&nbsp;<tt>ruby(iconv)</tt> и&nbsp;полную функциональность данного модуля.<br /> Реальные примеры можно посмотреть в&nbsp;пакете <a href="http://git.altlinux.org/people/raorn/packages/?p=ruby-gettext.git" target="_blank" title="Внешняя ссылка (откроется в новом окне)" class="outerlink"><img src="http://freesource.info/wiki/themes/coffee/icons/web.gif" alt="" border="0" />ruby-gettext</a>.</div><br /> <b>Удалено:</b><br /> <div class="deletions">Документация в&nbsp;формате RI&nbsp;генерируется при&nbsp;поможи утилиты <tt>rdoc</tt>, находящейся в&nbsp;пакете <tt>ruby-tool-rdoc</tt>. Для&nbsp;этого существует стандартный макрос <tt>%rdoc</tt> предназначенный для&nbsp;использования в&nbsp;секции <tt>%install</tt> (обычно одной из&nbsp;последних строк). В&nbsp;качестве аргументов этого макроса перечисляются файлы и&nbsp;каталоги с&nbsp;исходниками.<br /> Pure-ruby модули помещаются в&nbsp;<tt>%ruby_sitelibdir</tt>, бинарные модули в&nbsp;<tt>%ruby_sitearchdir</tt>, документация в&nbsp;формате RI&nbsp;в <tt>%ruby_ri_sitedir</tt>.</div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-25+01%3A22%3A05 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-25+01%3A22%3A05">2008-07-25 01:22:05</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-25+02%3A20%3A10">2008-07-25 02:20:10</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Далее используются макросы <tt>%ruby_config</tt>, <tt>%ruby_build</tt> и&nbsp;<tt>%ruby_install</tt>.</div><br /> <b>Удалено:</b><br /> <div class="deletions">Далее используются макросы <tt>%ruby_config</tt>, <!--notypo--><textarea class="code" rows="2" readonly="readonly">%ruby_build</textarea><!--/notypo--> и&nbsp;<tt>%ruby_install</tt>.</div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-24+20%3A28%3A30 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-24+20%3A28%3A30">2008-07-24 20:28:30</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-25+01%3A22%3A05">2008-07-25 01:22:05</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h8599-1"></a><h3><tt>Rakefile</tt> и&nbsp;остальные случаи</h3> Если task <tt>install</tt> не&nbsp;определён или&nbsp;вообще отсутствует установочный скрипт (в случае pure-ruby модуля), можно использовать <tt>setup.rb</tt> из&nbsp;пакета <tt>ruby-tool-setup</tt> примерно следующим образом:<br /> %prep<br /> %setup<br /> %patch -p1<br /> cp&nbsp;%_datadir/ruby-setup/setup.rb .<!--notypo--><textarea class="code" rows="2" readonly="readonly">Далее используются макросы ##%ruby_config##,</textarea><!--/notypo-->%ruby_build<!--notypo--><textarea class="code" rows="6" readonly="readonly">и ##%ruby_install##. ===Пакуем документацию=== Документация в формате RI генерируется при поможи утилиты ##rdoc##, находящейся в пакете ##ruby-tool-rdoc##. Для этого существует стандартный макрос ##%rdoc## предназначенный для использования в секции ##%install## (обычно одной из последних строк). В качестве аргументов этого макроса перечисляются файлы и каталоги с исходниками. Для pure-ruby модулей как правило используется конструкция: %rdoc lib/</textarea><!--/notypo--><br /> Если присутствуют бинарные модули:<br /> %rdoc *.c lib/<!--notypo--><textarea class="code" rows="4" readonly="readonly">Документацию желательно паковать в подпакет ##%name-doc##. При этом паковать следует только документацию для основных классов модуля, описание расширений сторонних классов паковать не нужно. ===Складываем файлы в пакеты=== Pure-ruby модули помещаются в ##%ruby_sitelibdir##, бинарные модули в ##%ruby_sitearchdir##, документация в формате RI в ##%ruby_ri_sitedir##.</textarea><!--/notypo-->(comments) vim: set&nbsp;wrap lbr&nbsp;spell spelllang=ru,en: %%</div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h8599-1"></a><h3><tt>Rakefile</tt></h3></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-20+15%3A29%3A26 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+15%3A29%3A26">2008-07-20 15:29:26</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-24+20%3A28%3A30">2008-07-24 20:28:30</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><ul><li> <strong>test/</strong> &ndash; unit-тесты;</li></ul> Также как&nbsp;правило присутствует один или&nbsp;несколько &laquo;сценариев сборки&raquo;, о&nbsp;них расскажу далее.<br /> Аналог configure, использует модуль <tt>mkmf</tt>, входящий в&nbsp;стандартную поставку ruby. Внутри скрипта проверяется наличие необходимых заголовочных файлов и&nbsp;библиотек, на&nbsp;выходе генерится Makefile, который обрабатывается стандартным make. Используется только в&nbsp;тех проектах, где&nbsp;есть бинарные модули. Если &laquo;рядом&raquo; с&nbsp;<tt>extconf.rb</tt> находится файл <tt>depend</tt>, его&nbsp;содержимое добавляется к&nbsp;<tt>Makefile</tt>. Исходные тексты и&nbsp;заголовочные файлы бинарного модуля как&nbsp;правило тоже лежат &laquo;рядом&raquo; с&nbsp;<tt>extconf.rb</tt>.<br /> Типичные секции <tt>%build</tt> и&nbsp;<tt>%install</tt> выглядят следующим образом:<br /> <!--notypo--><textarea class="code" rows="6" readonly="readonly">%build %ruby_configure &lt;опции extconf.rb&gt; %make_build %install %make_install DESTDIR=%buildroot install</textarea><!--/notypo--><a name="h8599-1"></a><h3><tt>setup.rb</tt> имени Minero Aoki</h3> Скрипт сборки и&nbsp;установки общего назначения. Как&nbsp;правило используется для&nbsp;сборки и&nbsp;установки pure-ruby модулей. Имеет некоторое количество стандартных опций, может собирать бинарные модули, находящиеся в&nbsp;каталоге <strong>ext/</strong> (как правило там&nbsp;присутствует <tt>extconf.rb</tt>, см.&nbsp;выше).<br /> Типичные секции <tt>%build</tt> и&nbsp;<tt>%install</tt> выглядят следующим образом:<br /> <!--notypo--><textarea class="code" rows="6" readonly="readonly">%build %ruby_config &lt;опции setup.rb&gt; %ruby_build %install %ruby_install</textarea><!--/notypo--><a name="h8599-2"></a><h3><tt>install.rb</tt></h3> Иногда это&nbsp;самописный скрипт, иногда встречается одна из&nbsp;первых версий <tt>setup.rb</tt>. Как&nbsp;правило используется только для&nbsp;установки pure-ruby модулей. Стандартных макросов для&nbsp;поддержки <tt>install.rb</tt> нет.<a name="h8599-3"></a><h3><tt>Rakefile</tt></h3> Сценарий для&nbsp;<tt>rake</tt>. Обычно может иметь task'и <tt>build</tt> (если есть бинарные модули) и&nbsp;<tt>test</tt>, но&nbsp;последнее время не&nbsp;имеет task'а <tt>install</tt>. Зато использует <tt>rubygems</tt>.<br /> Для&nbsp;вызова <tt>rake</tt> и&nbsp;<tt>rake install</tt> есть два&nbsp;стандартных макроса <tt>%rake</tt> и&nbsp;<tt>%rake_install</tt> соответственно.</div><br /> <b>Удалено:</b><br /> <div class="deletions">Аналог configure, использует модуль <tt>mkmf</tt>, входящий в&nbsp;стандартную поставку ruby. Внутри скрипта проверяется наличие необходимых заголовочных файлов и&nbsp;библиотек, на&nbsp;выходе генерится Makefile, который обрабатывается стандартным make.<br /> <em>...</em></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-20+14%3A56%3A56 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+14%3A56%3A56">2008-07-20 14:56:56</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+15%3A29%3A26">2008-07-20 15:29:26</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Есть два&nbsp;способа сборки модулей. При&nbsp;помощи rubygems (который мы&nbsp;не рассматриваем по&nbsp;ряду причин), и&nbsp;&laquo;нативная&raquo; сборка, с&nbsp;помещением файлов в&nbsp;специальные каталоги, которые находятся в&nbsp;<tt>$LOAD_PATH</tt>.<br /> Модули устанавливаются в&nbsp;так называемый vendor dir. В&nbsp;ALT Linux это&nbsp;<tt>/usr/share/ruby/vendor_ruby/RUBY.VERSION</tt> и&nbsp;<tt>/usr/lib/ruby/RUBY.VERSION/ARCHITECTURE</tt>. Поскольку по&nbsp;умолчанию установка модулей идёт в&nbsp;site dir, при&nbsp;сборке пакета надо использовать модуль <tt>vendor_specific</tt>, вызывая интерпретатор ruby как&nbsp;<tt>ruby -rvendor_specific</tt>. Для&nbsp;этого есть макрос <tt>%ruby</tt>.<br /> Внутри тарбола с&nbsp;модулем (или программой) могут находиться следующие файлы и&nbsp;каталоги:<br /> <ul><li> <strong>bin/</strong> &ndash; скрипты, будут установлены в&nbsp;<tt>%_bindir</tt>; </li><li> <strong>ext/</strong> &ndash; компилируемые модули (при использовании <tt>setup.rb</tt>), будут установлены в&nbsp;<tt>%ruby_sitearchdir</tt>; </li><li> <strong>lib/</strong> &ndash; pure-ruby модули, будут установлены в&nbsp;<tt>%ruby_sitelibdir</tt>; </li><li> <strong>data/</strong> &ndash; произвольные данные(при использовании <tt>setup.rb</tt>), будут установлены в&nbsp;<tt>%_datadir/ИМЯМОДУЛЯ</tt>;</li></ul><a name="h8599-1"></a><h3><tt>extconf.rb</tt> AKA&nbsp;MkMf</h3> Аналог configure, использует модуль <tt>mkmf</tt>, входящий в&nbsp;стандартную поставку ruby. Внутри скрипта проверяется наличие необходимых заголовочных файлов и&nbsp;библиотек, на&nbsp;выходе генерится Makefile, который обрабатывается стандартным make.<br /> <em>...</em></div><br /> <b>Удалено:</b><br /> <div class="deletions">Есть два&nbsp;способа сборки модулей. При&nbsp;помощи rubygems (который мы&nbsp;не рассматриваем по&nbsp;ряду причин), и&nbsp;&laquo;нативная&raquo; сборка, с&nbsp;помещением файлов в&nbsp;специальные каталоги, которые находятся в $LOAD_PATH.<br /> ...<a name="h8599-1"></a><h3>extconf.rb AKA&nbsp;MkMf</h3> Аналог configure, использует модуль mkmf, входящий в&nbsp;стандартную поставку ruby. Внутри скрипта проверяется наличие необходимых заголовочных файлов и&nbsp;библиотек, на&nbsp;выходе получается Makefile, который обрабатывается стандартным make.<br /> <em>иду спать, продолжение следует</em></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-20+01%3A52%3A51 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+01%3A52%3A51">2008-07-20 01:52:51</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+14%3A56%3A56">2008-07-20 14:56:56</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h8599-1"></a><h2>Внутри тарбола</h2> ...<a name="h8599-2"></a><h2>Собираем модуль</h2><a name="h8599-3"></a><h3>extconf.rb AKA&nbsp;MkMf</h3></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h8599-1"></a><h2>extconf.rb AKA&nbsp;MkMf</h2></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-20+01%3A52%3A07 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+01%3A52%3A07">2008-07-20 01:52:07</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+01%3A52%3A51">2008-07-20 01:52:51</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h8599-1"></a><h2>extconf.rb AKA&nbsp;MkMf</h2></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h8599-1"></a><h2>extconf.rb AKA&nbsp;<span class="missingpage">Mk&nbsp;Mf</span><a href="http://freesource.info/wiki/MkMf/edit?add=1&" title="Создать эту страницу">?</a></h2></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/ruby/show?time=2008-07-20+00%3A42%3A07 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;ruby</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+00%3A42%3A07">2008-07-20 00:42:07</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/ruby?time=2008-07-20+01%3A52%3A07">2008-07-20 01:52:07</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Основные правила сборки приложений и&nbsp;модулей ruby изложены в&nbsp;<span class="missingpage">Ruby Packaging Policy</span><a href="http://freesource.info/wiki/Policy/Ruby/edit?add=1&" title="Создать эту страницу">?</a>. Цель же&nbsp;этого документа &ndash; об'яснить на&nbsp;простых примерах как&nbsp;следует поступать в&nbsp;различных ситуациях а&nbsp;также показать как&nbsp;можно собирать простые модули.<br /> Я&nbsp;не рассматриваю rubygems, так&nbsp;как эта&nbsp;система включает в&nbsp;себя свой пакетный менеджер, не&nbsp;совместимый с&nbsp;дистрибутивным. Про&nbsp;отношение Debian к&nbsp;rubygems можно прочитать <a href="http://pkg-ruby-extras.alioth.debian.org/rubygems.html" target="_blank" title="Внешняя ссылка (откроется в новом окне)" class="outerlink"><img src="http://freesource.info/wiki/themes/coffee/icons/web.gif" alt="" border="0" />тут</a>, рекомендации апстриму изложены <a href="http://pkg-ruby-extras.alioth.debian.org/upstream-devs.html" target="_blank" title="Внешняя ссылка (откроется в новом окне)" class="outerlink"><img src="http://freesource.info/wiki/themes/coffee/icons/web.gif" alt="" border="0" />тут</a>. У&nbsp;нас ситуация в&nbsp;общем аналогичная.<br /> <em>Тут пока находится поток сознания, который я&nbsp;буду приводить к&nbsp;нормальному виду.</em><br /> <!--notypo--><fieldset><legend><strong> Оглавление документа </strong></legend><div class="toc1"><a href="#h8599-2">Общие принципы сборки модулей</a></div><div class="toc1"><a href="#h8599-3">Внутри тарбола</a></div><div class="toc1"><a href="#h8599-4">Собираем модуль</a></div><div class="toc2"><a href="#h8599-5">extconf.rb AKA&nbsp;MkMf</a></div><div class="toc2"><a href="#h8599-6">setup.rb имени Minero Aoki</a></div><div class="toc2"><a href="#h8599-7">install.rb</a></div><div class="toc2"><a href="#h8599-8">Rakefile и&nbsp;остальные случаи</a></div><div class="toc1"><a href="#h8599-9">Пакуем документацию</a></div><div class="toc1"><a href="#h8599-10">Складываем файлы в&nbsp;пакеты</a></div><div class="toc1"><a href="#h8599-11">Добро пожаловать в&nbsp;реальный мир</a></div><div class="toc2"><a href="#h8599-12">Не загрязняем $LOAD_PATH ($:)</a></div><div class="toc2"><a href="#h8599-13">Используем существующие модули и&nbsp;размаскируем зависимости</a></div></fieldset><!--/notypo--><a name="h8599-1"></a><h2>Общие принципы сборки модулей</h2> Есть два&nbsp;способа сборки модулей. При&nbsp;помощи rubygems (который мы&nbsp;не рассматриваем по&nbsp;ряду причин), и&nbsp;&laquo;нативная&raquo; сборка, с&nbsp;помещением файлов в&nbsp;специальные каталоги, которые находятся в $LOAD_PATH.<br /> Сборка пакета включает в&nbsp;себя:<br /> <ul><li> компиляцию бинарных модулей (если они&nbsp;есть); </li><li> выполнение тестов (если они&nbsp;есть и&nbsp;их выполнение возможно в&nbsp;hasher); </li><li> установку файлов в&nbsp;соответствующие каталоги; </li><li> генерацию документации в&nbsp;формате ri&nbsp;(class reference);</li></ul> Существует несколько, различного уровня &laquo;стандартности&raquo;, способов сборки модулей ruby.<a name="h8599-2"></a><h2>extconf.rb AKA&nbsp;<span class="missingpage">Mk&nbsp;Mf</span><a href="http://freesource.info/wiki/MkMf/edit?add=1&" title="Создать эту страницу">?</a></h2> Аналог configure, использует модуль mkmf, входящий в&nbsp;стандартную поставку ruby. Внутри скрипта проверяется наличие необходимых заголовочных файлов и&nbsp;библиотек, на&nbsp;выходе получается Makefile, который обрабатывается стандартным make.<br /> <em>иду спать, продолжение следует</em></div><br /> <b>Удалено:</b><br /> <div class="deletions">Основные правил сборки приложений и&nbsp;модулей ruby изложены в&nbsp;<span class="missingpage">Ruby Packaging Policy</span><a href="http://freesource.info/wiki/Policy/Ruby/edit?add=1&" title="Создать эту страницу">?</a>. Цель же&nbsp;этого документа &ndash; об'яснить на&nbsp;конкретных примерах как&nbsp;следует поступать в&nbsp;различных ситуациях а&nbsp;также на&nbsp;простых примерах показать как&nbsp;можно собирать простые модули.</div></div>