http://freesource.info/wiki/WINE/WritingTests History/revisions of FreeSource/WINE/WritingTests en-us http://freesource.info/wiki/WINE/WritingTests/show?time=2008-07-17+11%3A33%3A34 <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=".wine.writingtests" href="http://freesource.info/wiki/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-07-17+11%3A33%3A34">2008-07-17 11:33:34</a> и <a href="http://freesource.info/wiki/WINE/WritingTests">2008-10-17 19:45:22</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Описание создания тестов из&nbsp;оригинальной документации:<br /> <a href="http://www.winehq.org/site/docs/winedev-guide/testing" target="_blank" title="Внешняя ссылка (откроется в новом окне)" class="outerlink"><img src="http://freesource.info/wiki/themes/coffee/icons/web.gif" alt="" border="0" />http://www.winehq.org/site/docs/winedev-guide/testing</a></div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2008-06-25+11%3A54%3A06 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-25+11%3A54%3A06">2008-06-25 11:54:06</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-07-17+11%3A33%3A34">2008-07-17 11:33:34</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">- модификация trace(). Самая главная функция, без&nbsp;неё тест &ndash; не&nbsp;тест, а&nbsp;вся соль в&nbsp;первом параметре. Туда передаётся логическое условие, если это&nbsp;условие TRUE, то&nbsp;функция ничего не&nbsp;выводит и&nbsp;счётчик УСПЕШНО пройденных тестов инкрементируется. Если FALSE, то&nbsp;функция дальше работает как&nbsp;trace(), просто выводит всё что&nbsp;ей&nbsp;запихнули, но&nbsp;самое главное &ndash; предваряет вывод строчки отображением ругательства &laquo;test failed: ваша строка&raquo; &ndash; данная строчка &ndash; это&nbsp;заклинание, которое позволяет находить среди горы информации, переданной в&nbsp;поток вывода, тесты, которые упали. Счётчик ПРОВАЛЕННЫХ тестов также плюсуется.</div><br /> <b>Удалено:</b><br /> <div class="deletions">- модификация trace(). Самая главная функция, без&nbsp;неё тест &ndash; не&nbsp;тест, а&nbsp;вся соль в&nbsp;первом параметре. Туда передаётся логическое условие, если это&nbsp;условие TRUE, то&nbsp;функция ничего не&nbsp;выводит и&nbsp;счётчик УСПЕШНО пройденных тестов инкрементируется. Если FALSE, то&nbsp;функция дальше работает как&nbsp;trace(), просто выводит всё что&nbsp;ей&nbsp;запихнули, но&nbsp;сапое главное &ndash; предваряет вывод строчки отображением ругательства &laquo;test failed: ваша строка&raquo; &ndash; данная строчка &ndash; это&nbsp;заклинание, которое позволяет находить среди горы информации, переданной в&nbsp;поток вывода, тесты, которые упали. Счётчик ПРОВАЛЕННЫХ тестов также плюсуется.</div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2008-06-25+11%3A51%3A13 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-25+11%3A51%3A13">2008-06-25 11:51:13</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-25+11%3A54%3A06">2008-06-25 11:54:06</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">3. Если отправляется только тест из&nbsp;второй группы отдельным письмом, а&nbsp;затем следующим письмом исправление, основанное на&nbsp;этом тесте, то&nbsp;в исправлении должны быть строчки, убирающие todo_wine из&nbsp;теста, либо выставляющие FALSE флагу функции ok_sequence(...).</div><br /> <b>Удалено:</b><br /> <div class="deletions">3. Если отправляется только тест из&nbsp;второй группы отдельным письмом, а&nbsp;затем следующим письмом исправление, основанное на&nbsp;этом тесте. То&nbsp;в исправлении должны быть строчки, убирающие todo_wine из&nbsp;теста, либо выставляющие FALSE флагу функции ok_sequence(...).</div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2008-06-25+11%3A49%3A55 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-25+11%3A49%3A55">2008-06-25 11:49:55</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-25+11%3A51%3A13">2008-06-25 11:51:13</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><em>Исключение правда составляют тесты на&nbsp;последовательность (функция ok_sequence(...)), где&nbsp;последний параметр-флаг должен быть выставлен как&nbsp;FALSE, что&nbsp;говорит о&nbsp;том, что&nbsp;тестируемое поведение не&nbsp;требует доработки и&nbsp;соответствует поведению эталона</em><br /> 2. Если отправляется только тест из&nbsp;второй группы отдельным письмом, то&nbsp;он оформляется в&nbsp;соответствии с&nbsp;правилами.</div><br /> <b>Удалено:</b><br /> <div class="deletions"><em>Исключение правда составляют тесты на&nbsp;последовательность (функция ok_sequence(...)), где&nbsp;последний параметр-флаг должен быть выставлен как&nbsp;FALSE, что&nbsp;говорит о&nbsp;том, что&nbsp;тестируемое поведени не&nbsp;требует доработке и&nbsp;соответсвует поведению эталона</em><br /> 2. Если отправляется только тест из&nbsp;второй группы отдельным письмом, то&nbsp;он оформляется в&nbsp;соответсвии с&nbsp;правилами.</div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2008-06-24+18%3A03%3A13 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-24+18%3A03%3A13">2008-06-24 18:03:13</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-25+11%3A49%3A55">2008-06-25 11:49:55</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Глобально в&nbsp;Wine тесты делятся на&nbsp;два вила:<br /> 1. Тест успешно проходит в&nbsp;Windows и&nbsp;в Wine.<br /> 2. Тест успешно проходит в&nbsp;Windows, но&nbsp;проваливается в&nbsp;Wine.<br /> Все&nbsp;остальные тесты считаются по-умолчанию неверными.<br /> Тесты из&nbsp;первой группы являются регресс-тестами, либо тестами-пояснениями. Никакого особого оформления к&nbsp;ним не&nbsp;требуется. <br /> <em>Исключение правда составляют тесты на&nbsp;последовательность (функция ok_sequence(...)), где&nbsp;последний параметр-флаг должен быть выставлен как&nbsp;FALSE, что&nbsp;говорит о&nbsp;том, что&nbsp;тестируемое поведени не&nbsp;требует доработке и&nbsp;соответсвует поведению эталона</em><br /> Для&nbsp;оформления тестов второй группы существует несколько несложных правил:<br /> 1. Если для&nbsp;тестирования используется функция ok(...), то&nbsp;перед её вызовом необходимо поставить оператор todo_wine{ }, это&nbsp;будет символизировать то, что&nbsp;функционирование Wine, при&nbsp;данных условиях, отличается от&nbsp;работы Windows и&nbsp;Wine следует доработать.<br /> 2. Если для&nbsp;тестирования используется функция ok_sequence(...), то&nbsp;последний параметр-флаг должен быть выставлен как&nbsp;TRUE, по&nbsp;тем же&nbsp;причинам, что&nbsp;и&nbsp;в пункте 1.<br /> Несколько правил об&nbsp;отправке тестов в&nbsp;рассылку:<br /> 1. Если отправляется тест из&nbsp;второй группы вместе с&nbsp;исправлением неправильной работы Wine одним патчем, то&nbsp;todo_wine или&nbsp;TRUE в&nbsp;ok_sequence(...) выставлять не&nbsp;следует, но&nbsp;стоит описать в&nbsp;теле письма, то&nbsp;что добавляется тест и&nbsp;сразу исправление кода.<br /> 2. Если отправляется только тест из&nbsp;второй группы отдельным письмом, то&nbsp;он оформляется в&nbsp;соответсвии с&nbsp;правилами.<br /> 3. Если отправляется только тест из&nbsp;второй группы отдельным письмом, а&nbsp;затем следующим письмом исправление, основанное на&nbsp;этом тесте. То&nbsp;в исправлении должны быть строчки, убирающие todo_wine из&nbsp;теста, либо выставляющие FALSE флагу функции ok_sequence(...).</div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2008-06-24+17%3A49%3A28 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-24+17%3A49%3A28">2008-06-24 17:49:28</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-24+18%3A03%3A13">2008-06-24 18:03:13</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Часто, после написания теста, есть смысл поделиться им&nbsp;с сообществом разработчиков wine. Несколько слов об&nbsp;оформлении тестов для&nbsp;отправки их&nbsp;в рассылку.</div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2007-10-13+13%3A59%3A20 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2007-10-13+13%3A59%3A20">2007-10-13 13:59:20</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2008-06-24+17%3A49%3A28">2008-06-24 17:49:28</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h8076-1"></a><h3>Share your ideas</h3></div></div> http://freesource.info/wiki/WINE/WritingTests/show?time=2007-09-20+17%3A41%3A42 <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/WINE/WritingTests&" class="">/WINE&nbsp;/&nbsp;Writing&nbsp;Tests</a> за <a href="http://freesource.info/wiki/WINE/WritingTests?time=2007-09-20+17%3A41%3A42">2007-09-20 17:41:42</a> и <a href="http://freesource.info/wiki/WINE/WritingTests?time=2007-10-13+13%3A59%3A20">2007-10-13 13:59:20</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Сперва стоит уточнить, что&nbsp;мы&nbsp;занимаемся разработкой, доработкой и&nbsp;поддержкой нашего продукта WINE@Etersoft, который базируется на&nbsp;свободном проекте Wine.<br /> Но&nbsp;80% работы &ndash; это&nbsp;системная отладка: поиск и&nbsp;безжалостное уничтожение ошибок, бесконечная шлифовка кода Wine, высшая форма которой является признание получившегося патча сообществом Wine и&nbsp;включение его&nbsp;в&nbsp;cvs. Поэтому тесты необходимы. На&nbsp;нынешнем этапе развития Wine уже&nbsp;реализовано порядка 20 000 функций <span class="missingpage">Win&nbsp;API</span><a href="http://freesource.info/wiki/WinAPI/edit?add=1&" title="Создать эту страницу">?</a> и&nbsp;невозможно прикладывать отдельно каждый патч и&nbsp;проверять &ndash; вносит ли&nbsp;он полезные изменения и&nbsp;что более важно &ndash; не&nbsp;ломает ли&nbsp;он уже&nbsp;работающее? Сегодня практически стало стандартом, когда вместе с&nbsp;отправкой патча высылается тест, наглядно демонстрирующий изменения, вносимые исправлением. Но&nbsp;в ряде случаев очень приветствуется и&nbsp;простое написание тестов, демонстрирующие ошибки или&nbsp;различия реализации <span class="missingpage">Win&nbsp;API</span><a href="http://freesource.info/wiki/WinAPI/edit?add=1&" title="Создать эту страницу">?</a> в&nbsp;ОС разных версий, так&nbsp;как это&nbsp;позволяет &laquo;задокументировать&raquo; проблему и&nbsp;иметь надёжный способ её повторить ( ведь не&nbsp;всем же&nbsp;нравится читать описание на&nbsp;пол экрана как&nbsp;проявляется бага, а&nbsp;затем ещё пол&nbsp;часа тыкать мышкой :) ).<br /> Хорошо написанный тест чётко показывает различие в&nbsp;реализации API&nbsp;в&nbsp;Wine и&nbsp;Windows, он&nbsp;может прогоняться автоматически, т.к. должен быть интегрирован в&nbsp;систему тестирования Wine. &laquo;Наша&raquo; ситуация &ndash; это&nbsp;тест ИДЕАЛЬНО проходит в&nbsp;Windows, но&nbsp;однозначно и&nbsp;постоянно падает в&nbsp;одном и&nbsp;том же&nbsp;месте, будучи запущенным в&nbsp;Wine, только после этого можно приступать к&nbsp;исправлению ошибки. Кстати, грамотно написанный тест автоматически убавляет 50% работы, потому что&nbsp;часто не&nbsp;сложно исправить ошибку, но&nbsp;очень трудно локализовать её.<br /> И&nbsp;ещё одно: существующий тест &ndash; это&nbsp;весьма весомый аргумент при&nbsp;принятии исправлений, который позволяет на&nbsp;тратить много слов на&nbsp;объяснения вида &laquo;Но как&nbsp;это работает, и&nbsp;почему в&nbsp;Windows это&nbsp;устроено так&nbsp;неординарно (глупо) ?!". Плюс, если кто-то поломает что-то в&nbsp;том же&nbsp;модуле, в&nbsp;котором Вы&nbsp;вносили исправления, то&nbsp;тест лишает Вас&nbsp;головной боли вида: &laquo;От чего отлаженный механизм перестал работать?&raquo;, &ndash; и&nbsp;позволяет быстро найти вредителя, откладывая патчи и&nbsp;прогоняя тест. Поверьте &ndash; хороший тест сэкономит Вам&nbsp;кучу времени и&nbsp;нервов, а&nbsp;это очень дорогие вещи сейчас.<br /> <ol type="2"><li> Найти функцию, куда следует добавить наши 2 &ndash; 3 строчки, если же&nbsp;такой функции нет, то&nbsp;дополнительное задание &ndash; придумать ей&nbsp;имя и&nbsp;её создать. В&nbsp;нашем случае это&nbsp;будет функция <span class="cite">static void test_listbox_height(void)</span>.</li></ol> Ремарка: Если же&nbsp;пришлось создавать свою функцию, то&nbsp;чтобы она&nbsp;запустилась при&nbsp;прогоне теста, следует в&nbsp;самом конце модуля внутри функции START_TEST(имя тестового модуля) добавить вызов своей функции:<br /> <!--notypo-->{{backlinks}}<!--/notypo--></div><br /> <b>Удалено:</b><br /> <div class="deletions">Сперва стоит уточнить, что&nbsp;мы&nbsp;занимается разработкой, доработкой и&nbsp;поддержкой нашего продукта Wine@Etersoft, который базируется на&nbsp;Open Source проекте Wine.<br /> Но&nbsp;80% работы &ndash; это&nbsp;системная отладка &ndash; поиск и&nbsp;безжалостное уничтожение ошибок, бесконечная шлифовка кода Wine, высшая форма которой является признание получившегося патча сообществом wine и&nbsp;включение его&nbsp;в&nbsp;cvs. Поэтому тесты необходимы. На&nbsp;нынешнем этапе развития Wine уже&nbsp;реализовано порядка 20 000 Win&nbsp;Api функций и&nbsp;невозможно прикладывать отдельно каждый патч и&nbsp;проверять &ndash; вносит ли&nbsp;он полезные изменения и&nbsp;что более важно &ndash; не&nbsp;ломает ли&nbsp;он уже&nbsp;работающее? Сегодня практически стало стандартом, когда вместе с&nbsp;отправкой патча высылается тест, наглядно демонстрирующий изменения, вносимые исправлением. Но&nbsp;в ряде случаев очень приветствуется и&nbsp;простое написание тестов, демонстрирующие ошибки или&nbsp;различия реализации Win&nbsp;Api в&nbsp;ОС разных версий, так&nbsp;как это&nbsp;позволяет &laquo;задокументировать&raquo; проблему и&nbsp;иметь надёжный способ её повторить ( ведь не&nbsp;всем же&nbsp;нравится читать описание на&nbsp;пол экрана как&nbsp;проявляется бага, а&nbsp;затем ещё пол&nbsp;часа тыкать мышкой :) ).<br /> Хорошо написанный тест чётко показывает различие в&nbsp;реализации api&nbsp;в&nbsp;Wine и&nbsp;Windows, он&nbsp;может прогоняться автоматически, т.к. должен быть интегрирован в&nbsp;систему тестирования Wine. &laquo;Наша&raquo; ситуация &ndash; это&nbsp;тест ИДЕАЛЬНО проходит в&nbsp;Windows, но&nbsp;однозначно и&nbsp;постоянно падает в&nbsp;одном и&nbsp;том же&nbsp;месте, только после этого можно приступать к&nbsp;исправлению ошибки. Кстати, грамотно написанный тест автоматически убавляет 50% работы, потому что&nbsp;часто не&nbsp;сложно исправить ошибку, но&nbsp;очень трудно локализовать её.<br /> И&nbsp;ещё одно: существующий тест &ndash; это&nbsp;весьма весомый аргумент при&nbsp;принятии исправлений, который позволяет на&nbsp;тратить много слов на&nbsp;объяснения вида &laquo;Но как&nbsp;это работает, и&nbsp;почему в&nbsp;Windows это&nbsp;устроено так&nbsp;неординально (глупо) ?!". Плюс, если кто-то поломает что-то в&nbsp;том же&nbsp;модуле, в&nbsp;котором Вы&nbsp;вносили исправления, то&nbsp;тест лишает Вас&nbsp;головной боли вида: &laquo;От чего отлаженный механизм перестал работать?&raquo;,- и&nbsp;позволяет быстро найти вредителя, откладывая патчи и&nbsp;прогоняя тест. Поверьте &ndash; хороший тест сэкономит Вам&nbsp;кучу времени и&nbsp;нервов, а&nbsp;это очень дорогие вещи сейчас.<br /> <ol type="2"><li> Найти функцию, куда следует дабавить наши 2 &ndash; 3 строчки, если же&nbsp;такой функции нет, то&nbsp;дополнительное задание &ndash; придумать ей&nbsp;имя и&nbsp;её создать. В&nbsp;нашем случае это&nbsp;будет функция <span class="cite">static void test_listbox_height(void)</span>.</li></ol> Ремарка: Если же&nbsp;пришлось создавать свою функцию, то&nbsp;чтобы она&nbsp;запустилась при&nbsp;прогоне теста, следует в&nbsp;самом конце модуля внутри функции START_TEST(имя тестового модуля) добавить вызов своей фунцкии:</div></div>