MQL4unit

Ну вот, наконец-то я поборол лень и написал краткий мануал для своей мини-библиотечки

MQL4unit – библиотека для юнит-тестирования функций, написанных на языке MQL4 компании MetaQuotes.

Автор: я)))

Идея библиотеки взята из статьи «Повышаем качество кода при помощи Unit Tests»(articles.mql4.com/ru/936), но текущая реализация доработана до стандарта xUnit. Используемая лицензия – GNU/GPL v 2.0 (http://infolex.narod.ru/gpl_gnu/gplrus.html).

Подробнее о практике Unit Testing можно прочитать в книге Кента Бека «Экстремалное программирование. Разработка через тестирования» (Beck Kent “Extreme Programming. Test Driven Development”, Addison-Wesley, 2000). Так как MQL4 является процедурным языком, минимальным тестировочным юнитом будет являться одна функций (процедура). Результаты тестирования можно посмотреть во вкладке «Эксперты» (“Experts”) торгового терминала.

Функции инициализации и деинициализации набора тестов.

void UnitTestStart(string TestName) – функция инициализации набора тестов. Принимает один параметр типа string, обозначающий название набора тестов. Рекомендуется применять осмысленные названия для более четкой идентификации результатов тестирования. Должна быть вызвана до каких-либо других функций библиотеки, так как она инициализирует счетчики успешных и проваленных тестов, общего количества. В противном случае общий результат тестирования будет некорректен.

bool UnitTestEnd() – функция деинициализации набора тестов. Возвращает true в случае прохождения всех тестов, false – в противном случае. Должна быть вызвана после всех обращений к функциям библиотеки в пределах одного набора тестов.

Функции тестирования единичных значений.

bool AssertTrue(bool var) – функция для тестирования логической переменной на ожидаемое значение "истина".

Параметр: bool var.

Возвращаемое значение: true, если входная переменная содержит значение "истина"; false, если входная переменная содержит значение "ложь".

bool AssertFalse(bool var) – функция для тестирования логической переменной на ожидаемое значение "ложь".

Параметр: bool var.

Возвращаемое значение: true, если входная переменная содержит значение "ложь"; false, если входная переменная содержит значение "истина".

bool AssertBoolsEqual(bool gotten, bool needed) – функция для тестирования двух булевых переменных на равенство (полученной в результате работы тестируемого юнита и ожидаемой).

Параметры: bool gotten – значение, полученное в результате работы тестируемого юнита, bool needed – ожидаемое значение.

Возвращаемое значение: true, если значения входных переменных равны; false, если значения входных переменных не равны.

bool AssertIntsEqual(int gotten, int needed) – функция для тестирования двух целочисленных переменных на равенство (полученной в результате работы тестируемого юнита и ожидаемой).

Параметры: int gotten – значение, полученное в результате работы тестируемой функции, int needed – ожидаемое значение

Возвращаемое значение: true, если значения входных переменных равны; false, если значения входных переменных не равны.

bool AssertDoublesEqual(double gotten, double needed, int pres) – функция для тестирования двух переменных типа double на равенство (полученной в результате работы тестируемого юнита и ожидаемой).

Параметры: double gotten – значение, полученное в результате работы тестируемой функции, double needed – ожидаемое значение, int pres – требуемая точность сравнение (кол-во знаков после запятой).

Возвращаемое значение: true, если значения входных переменных равны; false, если значения входных переменных не равны.

bool AssertColorsEqual(color gotten, color needed) – функция для тестирования двух (цветовых) переменных типа color на равенство (полученной в результате работы тетстируемого юнита и ожидаемой).

Параметры: color gotten – значение, полученное в результате работы тестируемой функции, color needed – ожидаемое значение.

Возвращаемое значение: true, если значения входных переменных равны; false, если значения входных переменных не равны.

bool AssertStringsEqual(string gotten, string needed) – функция для тестирования двух строковых переменных типа на равенство (полученной в результате работы тестируемого юнита и ожидаемой)

Параметры: string gotten – значение, полученное в результате работы тестируемой функции, string needed – ожидаемое значение.

Возвращаемое значение: true, если значения входных переменных равны; false, если значения входных переменных не равны.

Функции сравнения массивов.

bool AssertBoolArraysEqual(bool gotten[], bool needed[]) – функция для тестирования двух массивов булевых переменных на равенство (полученного в результате работы тестируемого юнита и ожидаемого).

Параметры: bool gotten[]– массив, полученный в результате работы тестируемой функции, bool needed[] – ожидаемый массив.

Возвращаемое значение: true, если массивы равной длины и совпадают поэлементно, false – в противном случае.

bool AssertIntArraysEqual(int gotten[], int needed[]) – функция для тестирования двух массивов целочисленных переменных на равенство (полученного в результате работы тестируемого юнита и ожидаемого).

Параметры: int gotten[] – массив, полученный в результате работы тестируемой функции, int needed[] – ожидаемый массив.

Возвращаемое значение: true, если массивы равной длины и совпадают поэлементно, false – в противном случае.

bool AssertDoubleArraysEqual(double gotten[], double needed[]) – функция для тестирования двух массивов вещественных переменных на равенство (полученного в результате работы тестируемого юнита и ожидаемого).

Параметры: int gotten[] – массив, полученный в результате работы тестируемой функции, int needed[] – ожидаемый массив.

Возвращаемое значение: true, если массивы равной длины и совпадают поэлементно, false – в противном случае.

bool AssertStringArraysEqual(string gotten[], string needed[]) – функция для тестирования двух массивов строковых переменных на равенство (полученного в результате работы тестируемого юнита и ожидаемого).

Параметры: string gotten[] – массив, полученный в результате работы тестируемой функции, string needed[] – ожидаемый массив.

Возвращаемое значение: true, если массивы равной длины и совпадают поэлементно, false – в противном случае.

bool AssertColorArraysEqual(color gotten[], color needed[]) – функция для тестирования двух массивов значений цвета на равенство (полученного в результате работы тестируемого юнита и ожидаемого).

Параметры: color gotten[] – массив, полученный в результате работы тестируемой функции, color needed[] – ожидаемый массив.

Возвращаемое значение: true, если массивы равной длины и совпадают поэлементно, false – в противном случае.

bool AssertDatetimeArraysEqual(datetime gotten[], datetime needed[]) –функция для тестирования двух массивов дат на равенство (полученного в результате работы тестируемого юнита и ожидаемого).

Параметры: datetime gotten[] – массив, полученный в результате работы тестируемой функции, datetime needed[] – ожидаемый массив.

Возвращаемое значение: true, если массивы равной длины и совпадают поэлементно, false – в противном случае।


Код с полной документацией лежит тут.

Размышления о киберорганике

Киберорганика, как бы странно это не звучало, уже входит в нашу жизнь. И не потому, что некоторые ученые пытаются создавать человекоподобных роботов, пытаясь привить им подобие исконно человеческих возможностей, а потому, что первые шаги к замене утерянной человеческой конечности сделали ученые из Германии, разработав для инвалида настолько чувствительную механическую руку, что он с ее помощью может переносить стеклянные стаканы с водой и куриные яйца.

Как мне кажется, это явление трудно оценить однозначно, оно может как приносить благо людям, так и убивать остатки человечности. Все, как и в случае с любой технологией, зависит от ее использования. С помощью одних и тех же методик можно лечить инвалидов, возвращая их почти к полноценной жизни и «вытаскивать с того света» жертв аварий и катастроф, пересаживая им механические органы или все тело, а можно - создавать непобедимых солдат, универсальных машин для убийства, не чувствующих боли и страха и соединяющих в себе преимущества обоих типов мышления – образного человеческого и дискретного машинного, позволяющие такому организму ориентироваться на местности без навигаторов и приборов ночного видения, точно обсчитывать дифференциальные уравнения полета пули и снаряда и уничтожать все живое максимально эффективно.

Основная проблема в этом кроется как раз во втором подходе. К сожалению, люди при создании новой технологии сначала стараются применить ее к уничтожению себе подобных и захвата максимально жирного куска или теплого места. Это, конечно, результат естественного отбора и в природе было бы нормально, другое дело что в природе это все находится в том равновесии, которое позволяет выживать глобальной экосистеме, поддерживая все звенья цепочек питания на оптимальном уровне. Но технологии уже нарушили этот хрупкий баланс, а киберорганика может привести к еще большим последствиям из-за невозможности животного мира противостоять таким киборгам. Недаром в «Дао Дэ Цзин» и других трактатах древних мудрецов так много уделяется внимания сохранению равновесия в мире и каждом человеке. Как мне кажется, человечество вообще должно чаще присматриваться к восточной культуре, которая более созерцательная и меньше направлена на подавление окружающего мира. В то же время кибернетизированный человек может довести уровень своей роботизации до такого состояния, что он сам не будет осознавать, кто он теперь – человек или машина. Наиболее ярко такие рассуждения показаны от лица майора Кусанаги в известной анимации «Призрак в доспехах». И кто знает, какой ответ в такой ситуации окажется правильным и где заканчивается сознание человека и начинается сознание машины, если таковое существует. Над решением этой проблемы бьются многие философы и вполне может случиться, что на практике ответ на этот вопрос будет получен гораздо раньше, чем в кулуарах философских саммитов и коллегий. И есть ненулевая и даже не очень малая вероятность того, что этот ответ может не обрадовать ни самого роботизированного человека, ни тех самых философов.

Но за темной полосой возможных проблем нельзя забывать о потенциальной пользе, которую такие технологии могут принести инвалидам и людям с неизлечимыми болезнями внутренних органов, которые можно будет просто заменить на искусственные. О таком мечтали многие фантасты, и многие из них стали провидцами. Как всегда, все зависит от нас. И если мы вовремя начнем думать не только о прямой выгоде, киберорганика может стать одним из ведущих факторов, приведших человечество вообще и каждого человека в отдельности к долгой и счастливой жизни, не омраченной ежедневной болью из-за болезни или постоянного чувства собственной неполноценности и невозможности быть как другие у инвалидов. Я думаю, такой результат стоит больших усилий и глубоких раздумий.

Это все - мое конкурсное эссе на конкурс октября 2010