http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5 History/revisions of FreeSource/AltLinux/Sisyphus/Alterator/internals/5 en-us http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5/show?time=2008-03-06+15%3A22%3A17 <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.alterator.internals.5" href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;internals&nbsp;/&nbsp;5</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2008-03-06+15%3A22%3A17">2008-03-06 15:22:17</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5">2008-03-06 15:22:49</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/Alterator/internals/5" target="_blank" title="" class="outerlink">altlinux.org</a>. Текст на&nbsp;freesource.info заморожен.</div></div><br /> * параметры у&nbsp;многоаргументных функций, суть локальные переменные со&nbsp;всеми вытекающими последствиями:</div><br /> <b>Удалено:</b><br /> <div class="deletions">Параметры у&nbsp;многоаргументных функций, суть локальные переменные со&nbsp;всеми вытекающими последствиями:</div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5/show?time=2007-03-30+05%3A31%3A19 <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/Alterator/internals/5&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;internals&nbsp;/&nbsp;5</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2007-03-30+05%3A31%3A19">2007-03-30 05:31:19</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2008-03-06+15%3A22%3A17">2008-03-06 15:22:17</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><div class="indent"> (define b&nbsp;4)<br /> (define (g)<br /> <div class="indent"><div class="indent">(write b)) ; мы&nbsp;видим эту&nbsp;переменную так&nbsp;как g&nbsp;сама определена внутри f<br /> </div></div> (g)<br /> (write a) ; мы&nbsp;видим эту&nbsp;переменную ибо&nbsp;она в&nbsp;охватывающем окружении<br /> (write b)) ; это&nbsp;наша локальная переменная</div> (write b) ; ошибка b&nbsp;&ndash; определена внутри f&nbsp;и не&nbsp;видна на&nbsp;вышестоящем уровне.<br /> <div class="indent"> (define a&nbsp;4)<br /> (write a))<br /> (write x))</div></div><br /> <b>Удалено:</b><br /> <div class="deletions"><div class="indent"><div class="indent"><div class="indent"><div class="indent">(define a&nbsp;3)<br /> (define (f)<br /> <div class="indent"> (define b&nbsp;4)<br /> (define (g)<br /> <div class="indent"><div class="indent">(write b)) ; мы&nbsp;видим эту&nbsp;переменную так&nbsp;как g&nbsp;сама определена внутри f<br /> </div></div> (g)<br /> (write a) ; мы&nbsp;видим эту&nbsp;переменную ибо&nbsp;она в&nbsp;охватывающем окружении<br /> (write b)) ; это&nbsp;наша локальная переменная<br /> </div>(write b) ; ошибка b&nbsp;&ndash; определена внутри f&nbsp;и не&nbsp;видна на&nbsp;вышестоящем уровне.<br /> (define a&nbsp;4)<br /> (write a))<br /> (write x))</div></div></div></div></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5/show?time=2006-10-31+17%3A14%3A59 <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/Alterator/internals/5&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;internals&nbsp;/&nbsp;5</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2006-10-31+17%3A14%3A59">2006-10-31 17:14:59</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2007-03-30+05%3A31%3A19">2007-03-30 05:31:19</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><div class="indent"><div class="indent"><div class="indent"><div class="indent">(write b) ; ошибка b&nbsp;&ndash; определена внутри f&nbsp;и не&nbsp;видна на&nbsp;вышестоящем уровне.</div></div></div></div></div><br /> <b>Удалено:</b><br /> <div class="deletions"><div class="indent"><div class="indent"><div class="indent"><div class="indent">(write b) ; ошибка a&nbsp;&ndash; определена внутри f&nbsp;и не&nbsp;видна на&nbsp;вышестоящем уровне.</div></div></div></div></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5/show?time=2006-10-31+17%3A11%3A37 <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/Alterator/internals/5&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;internals&nbsp;/&nbsp;5</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2006-10-31+17%3A11%3A37">2006-10-31 17:11:37</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2006-10-31+17%3A14%3A59">2006-10-31 17:14:59</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h5146-1"></a><h2>11 Локальные переменные</h2></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h5146-1"></a><h2>11 Опять про&nbsp;Scheme: Локальные переменные</h2></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5/show?time=2005-07-20+00%3A55%3A37 <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/Alterator/internals/5&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;internals&nbsp;/&nbsp;5</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2005-07-20+00%3A55%3A37">2005-07-20 00:55:37</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/internals/5?time=2006-10-31+17%3A11%3A37">2006-10-31 17:11:37</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h5146-1"></a><h2>11 Опять про&nbsp;Scheme: Локальные переменные</h2> В&nbsp;Scheme применяется привычный всем подход к&nbsp;областям видимости переменных (так называемый Lexical Scope):<br /> * Переменные определённые внутри некоторой функции видны во&nbsp;всех функциях, определённых внутри данной, но&nbsp;не видны вне&nbsp;её.<br /> <div class="indent"><div class="indent"><div class="indent"><div class="indent">(define a&nbsp;3)<br /> (define (f)<br /> <div class="indent"> (define b&nbsp;4)<br /> (define (g)<br /> <div class="indent"><div class="indent">(write b)) ; мы&nbsp;видим эту&nbsp;переменную так&nbsp;как g&nbsp;сама определена внутри f<br /> </div></div> (g)<br /> (write a) ; мы&nbsp;видим эту&nbsp;переменную ибо&nbsp;она в&nbsp;охватывающем окружении<br /> (write b)) ; это&nbsp;наша локальная переменная<br /> </div>(write b) ; ошибка a&nbsp;&ndash; определена внутри f&nbsp;и не&nbsp;видна на&nbsp;вышестоящем уровне.<br /> (define a&nbsp;4)<br /> (write a))<br /> (write x))</div></div></div></div></div><br /> <b>Удалено:</b><br /> <div class="deletions">Продолжение истории...<a name="h5146-1"></a><h2>3.  Первый модуль</h2> Мы&nbsp;уже узнали достаточно чтобы попробовать написать свой первый модуль для&nbsp;alterator. Так&nbsp;что не&nbsp;будем медлить с&nbsp;долгими рассказами, и&nbsp;сразу же&nbsp;приступим к&nbsp;делу. Я&nbsp;пока не&nbsp;буду давать лишних комментариев, и&nbsp;объяснять что&nbsp;и&nbsp;почему, просто смотрите как&nbsp;это сделать и&nbsp;всё ;)<br /> Если формат backend'a покажется вам&nbsp;несколько странным, то&nbsp;объясню &ndash; он&nbsp;был изначально рассчитан на&nbsp;существование в&nbsp;виде модуля для&nbsp;виртуальной файловой системы &ndash; admfs. Сейчас она&nbsp;не&nbsp;используется &ndash; а&nbsp;формат остался ... может в&nbsp;будущем мы&nbsp;вернёмся к&nbsp;этой идее, уж&nbsp;больно она&nbsp;красивая.<br /> Для&nbsp;того чтобы создать простейший модуль для&nbsp;alterator, надо:<br /> <ol type="1"><li> написать низкоуровневую часть &ndash; backend, которая собственно и&nbsp;будет крутить ручки в&nbsp;системе </li><li> написать интерфейс </li></ol> Давайте сделаем модуль, который позволит выбирать пользователю локаль в&nbsp;системе.<a name="h5146-2"></a><h2>3.1 Устройство backend</h2> Интерфейс и&nbsp;backend будут обмениваться между собой посредством команд фиксированного формата: "&lt;объект&gt; &lt;действия&gt;". Объект принято именовать так&nbsp;же&nbsp;как и&nbsp;объекты в&nbsp;файловой системе, то&nbsp;есть последовательность слов, разделённых символом '/'.<br /> Например:<br /> /users/root<br /> /network/interfaces/eth0<br /> Первая часть имени совпадает с&nbsp;именем файла бакенда.<br /> Например<br /> /users/root &ndash; файл backend, называется users<br /> /network/interfaces/eth0 &ndash; файл backend называется network<br /> Оставшаяся часть имени передаётся backend и&nbsp;он дальше сам&nbsp;разбирается с&nbsp;тем что&nbsp;с&nbsp;ней делать.<br /> Действия есть последовательность атрибутов со&nbsp;значениями, один атрибут имеет особое значение, зовут его&nbsp;action. action &ndash; собственно означает какое действие мы&nbsp;можем предпринять над&nbsp;объектов.<br /> Возможные значения action:<br /> read &ndash; прочитать атрибуты объекта<br /> write &ndash; изменить некоторые атрибуты объекта<br /> list &ndash; получить список объектов которые данный содержит (аналогично ls&nbsp;в каталоге)<br /> new&nbsp;&ndash; создать объект<br /> delete &ndash; удалить объект<br /> Атрибут action всегда должен присутствовать в&nbsp;команде.<br /> Например:<br /> /users/test action=new uid=506 gecos="Some User"<br /> (создать пользователя тест с&nbsp;UID 506 и&nbsp;комментарием &#8220;Some User&#8221;)<br /> /network/interfaces/eth0 action="read"<br /> (считать параметры интерфейса, например ip-адрес,шлюз etc.)<br /> Этот язык общения со&nbsp;времён первого alterator носит странное имя&nbsp;WOO.<br /> В&nbsp;нашем случае мы&nbsp;имеем следующие объекты:<br /> /i18n/current &ndash; текущее значение локали<br /> /i18n/available &ndash; установленные в&nbsp;системе локали<br /> ...<br /> /i18n/available/Russian locale for&nbsp;Russia &ndash; например одна из&nbsp;локалей в&nbsp;системе.<br /> Как&nbsp;можно догадаться, i18n &ndash; это&nbsp;будет имя&nbsp;нашего файла &ndash; backend'a.<br /> /i18n/current будет иметь следующие атрибуты:<br /> stdname &ndash; стандартное имя&nbsp;локали без&nbsp;кодировки, например &#8220;ru_RU&#8221;<br /> title &ndash; описательное имя&nbsp;локали, например &#8220;Russian locale for&nbsp;Russia&#8221;<br /> charmap &ndash; кодировка, например &#8220;KOI8-R&#8221;<br /> stdname.charmap &ndash; даёт стандартное системное имя, которое обычно<br /> содержится в&nbsp;переменной LANG, в&nbsp;нашем случае это&nbsp;ru_RU.KOI8-R.<br /> Можно было бы&nbsp;сделать один атрибут lang, но&nbsp;удобнее держать отдельно<br /> кодировку.<br /> Чтобы считать текущее значение, команда следующая:<br /> /i18n/current action=read<br /> Чтобы записать новое значение переменной LANG, команда следующая:<br /> /i18n/current action=write lang=ru_RU.KOI8-R<br /> Как&nbsp;видите атрибуты на&nbsp;чтение и&nbsp;запись не&nbsp;обязаны совпадать. Может это&nbsp;не<br /> совсем идеологически верно, зато удобно.<a name="h5146-3"></a><h2>3.1.2 Пишем backend</h2> С&nbsp;языком общения мы&nbsp;вроде как&nbsp;разобрались, теперь собственно формат<br /> backend.<br /> backend &ndash; это&nbsp;обычное приложение, написанное на&nbsp;произвольном языке<br /> программирования, который откликается на&nbsp;внешние раздражители следующим образом:<br /> *(action=read)* backend -r объект &ndash; выдать на&nbsp;stdout, атрибуты и&nbsp;их значения в&nbsp;формате:<br /> атрибут1:значение1<br /> атрибут2:значение2<br /> ....<br /> (соответственно имя&nbsp;атрибута не&nbsp;должно содержать двоеточия &ndash; это&nbsp;не&nbsp;очень<br /> сильное ограничение)<br /> объект &ndash; это&nbsp;хвост имени объекта, с&nbsp;отрезанным именем backend.<br /> Так&nbsp;&laquo;a/b/c/d&raquo; &ndash; урежется до&nbsp;&laquo;b/c/d&raquo;.<br /> Например: (для woo-команды: /i18n/current action=read)<br />         $ ./i18n -r current<br />         stdname:ru_RU<br />         title:Russian locale for&nbsp;Russia<br />         charmap:KOI8-R<br />         $ ./i18n -r &laquo;available/Russian locale for&nbsp;Russia&raquo;<br />         stdname:ru_RU<br />         charmaps:CP1251,IBM866,ISO-<span class="nobr">8859&ndash;5</span>,KOI8-R,UTF-8<br /> *(action=list)* backend -l объект &ndash; выдать на&nbsp;stdout список подобъектов в&nbsp;формате<br /> &laquo;имя[пробел][r|d]" где&nbsp;d&nbsp;ставится рядом с&nbsp;объектом, содержащим другие<br /> объекты, а&nbsp;r &ndash; рядом с&nbsp;обычным объектом.<br /> Например: (для woo-команд: /i18n action=list и&nbsp;/i18n/available action=list)<br />         $ ./i18n -l /  <br />         available d<br />         current r<br />         <br />         $ ./i18n -l available<br />         Russian locale for&nbsp;Russia r<br />         Russian locale for&nbsp;Ukraine r<br /> *(action=write,new)* backend -w объект &ndash; принять с&nbsp;stdin параметры в&nbsp;виде "атрибут:значение" и&nbsp;записать их&nbsp;в объект.<br /> Например: (для woo-команды: /i18n/current action=write lang=ru_RU.CP1251)<br />         $echo "lang:ru_RU.CP1251"| ./i18n -w current<br /> Отдельной команды для&nbsp;action=new нет, backend сам&nbsp;в&nbsp;состоянии догадаться, делать ему&nbsp;новый объект или&nbsp;модифицировать имеющийся.<br /> *(action=delete)* backend -d объект &ndash; удалить указанный объект<br /> Ну&nbsp;вот собственно и&nbsp;весь формат backend.<br /> Пример скрипта на&nbsp;shell, который всё это&nbsp;реализует приложен к&nbsp;письму. Думаю что&nbsp;вы&nbsp;легко сможете написать и&nbsp;свою версию, возможно даже более правильную и&nbsp;корректную ;)<a name="h5146-4"></a><h2>3.2 Опять про&nbsp;Scheme: Локальные переменные</h2> В&nbsp;Scheme в&nbsp;отличие от&nbsp;Common Lisp применяется привычный подход к&nbsp;понятию локальности (так называемый &#8220;Lexical Scope&#8221; против &#8220;Dynamic Scope&#8221; в&nbsp;Common Lisp):<br /> * Переменные определённые внутри некоторой функции видны во&nbsp;всех функциях,   определённых внутри данной, но&nbsp;не видны вне&nbsp;её.<br />         (define a&nbsp;3)<br />         (define (f)<br />            (define b&nbsp;4)<br />            (define (g)<br />               (write b)) ; мы&nbsp;видим эту&nbsp;переменную так&nbsp;как g&nbsp;сама определена внутри f<br />            (g)<br />            (write a) ; мы&nbsp;видим эту&nbsp;переменную ибо&nbsp;она в&nbsp;охватывающем окружении<br />            (write b)) ; это&nbsp;наша локальная переменная<br />         (write b) ; ошибка a&nbsp;&ndash; определена внутри f&nbsp;и не&nbsp;видна на&nbsp;вышестоящем уровне.<br />         (define a&nbsp;4)<br />         (write a))<br />         (write x))</div></div>