aet - Интернет в облаке

ПРОГРАММА:

ИМЯ

aegis test - запускать тесты

СИНТАКСИС

эгида -Контрольная работа [ вариант...] [ имя=ценностное ][ имя файла...]
эгида -Контрольная работа -Независимый [ вариант...] [ имя=ценностное ][ имя файла...]
эгида -Контрольная работа -Список [ вариант...]
эгида -Контрольная работа -Помощь

ОПИСАНИЕ

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

Вы можете назвать каталоги в командной строке и все соответствующие тесты в этом каталоге.
дерево в изменении будет запущено. Это ошибка, если нет соответствующих тестов.

Каждую архитектуру нужно тестировать отдельно. Это потому, что могут быть тонкие
проблемы, которые обнаруживаются только на некоторых архитектурах. Некоторые проекты также могут иметь
разный код для разных архитектур.

Статус последнего запуска теста запоминается, поэтому тесты не запускаются, если нет
необходимость. (Это не относится к -РЕГРЕССИЯ тесты, к сожалению.) Тесты нужно запускать заново
если тест ранее не удался, если тестовый файл был изменен, если была сборка,
и для каждой архитектуры.

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

Ассоциация -сила опция приводит к добавлению неявной переменной force = 1 в список
присваивания переменных и, таким образом, добавляются в конец команды. Это наиболее полезно, когда
используя Batch_test_command файл конфигурации проекта.

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

Можно заставить все присвоения переменных превратиться в переменные среды.
поместив $ var в Начало команды перед именем оболочки, а не в
расположение по умолчанию в конце команды.

Файл Фамилия Интерпретация
Программа aegis попытается определить имена файлов проекта по именам файлов.
задано в командной строке. Все имена файлов хранятся в проектах aegis как относительные.
в корень базового дерева каталогов. Каталог разработки и
каталог интеграции - это тени этого базового каталога, поэтому эти относительные имена
применяются и здесь. Файлы, названные в командной строке, сначала преобразуются в абсолютные пути
если необходимо. Затем они сравниваются с базовым путем, каталогом разработки.
путь и путь к каталогу интеграции, чтобы определить имя, относящееся к базовой линии. это
ошибка, если указанный файл находится за пределами одного из этих деревьев каталогов.

Ассоциация -BAse_RElative опция может использоваться для того, чтобы относительные имена файлов интерпретировались как
относительно базовой линии; абсолютные имена файлов по-прежнему будут сравниваться с различными
пути для определения имени относительно базовой линии.

Ассоциация относительное_имя_файла_предпочтение в файле конфигурации пользователя может использоваться для изменения
это поведение по умолчанию. Видеть aeuconf(5) для получения дополнительной информации.

ИСПЫТАНИЕ ПРОЦЕСС ПРОЕКТИРОВАНИЯ

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

Регрессия Tests
Тесты рассматриваются как любой другой исходный файл и поддерживаются в базовом и
история со всеми остальными исходными файлами. Тесты, которые должны сопровождать каждое изменение
накапливаются в базовой линии проекта, обеспечивая определение правильной функции для
исходный уровень. Эти накопленные тесты могут быть выполнены с помощью команды «aegis -REGression»,
чтобы убедиться, что проект не «регрессирует» в результате изменения.

Базовая линия Tests
Исправления ошибок необходимы для их тестирования неудача против базовой линии проекта (в отличие от
в каталог разработки). Это гарантирует, что тест действительно демонстрирует ошибку.
в исходном состоянии, а также демонстрирует, что это исправлено изменением. Новый
функциональность тривиально не соответствует базовой, поэтому Aegis не пытается
угадайте, является ли тест тестом на исправление ошибок или тестом новой функциональности, он просто требует, чтобы тесты
не соответствуют базовому уровню.

Это требование применяется как к новым тестам, создаваемым изменением, так и к тестам.
которые были скопированы в изменение для модификации.

Обзор Tests
Рецензенты могут быть уверены, что компания Aegis обеспечила соблюдение требований к тестам; это изменение
должны иметь тесты, которые должны быть внесены в изменение, которые проходят тесты на предмет разработки.
каталог, и что тесты не соответствуют базовому уровню. Эти условия соблюдаются
by Aede(1) и изменение не будет перенесено на не являетесь отзывы состояние, пока эти
условия соблюдены. Таким образом, рецензенты должны проверять тесты для полнота освещения
код в изменении и нечувствительность к изменениям в среде выполнения (например,
не чувствительна к дате). Рецензенты также должны использовать «aegis -list change_details» для проверки
что для изменения есть или нет исключения для тестирования.

Изъятия
Администраторы проекта могут предоставить различные исключения для тестирования, см. Aepa(1) и
эпатр(5) для получения дополнительной информации. Копирование тестов в изменение или добавление новых тестов в
изменить, может отменить эти исключения.

ИСПЫТАНИЕ КОМАНДА КОНФИГУРАЦИЯ

Команда, используемая для выполнения тестов, определяется test_command поле в проекте
файл конфигурации (см. aepconf(5) для получения дополнительной информации), по умолчанию используется
Оболочка Борна, если не установлена. Текущий каталог будет верхним среди соответствующих
дерево каталогов. Если для тестов требуются временные файлы, их следует создавать в / Tmp, как
test не может ожидать разрешения на запись в текущий каталог.

Если вы хотите использовать более сложный механизм тестирования, а не простой сценарий оболочки,
но этот механизм тестирования не возвращает коды результатов, подходящие для использования с aegis, вы можете
оберните его в сценарий оболочки, который переписывает статус выхода в значения, ожидаемые aegis.
Вы также можете добиться тех же результатов, написав более сложный test_command в
Проект конфиг .

Также можно написать тестовые команды, которые могут тестировать более одного файла в
однажды. Это контролируется Batch_test_command область проекта конфиг файл. В
в этом случае подстановка $ {output} указывает имя файла, в котором должна выполняться тестовая команда.
создать, в аэтест(5) формат, содержащий результаты выполнения тестов. Это часто используется
в системах с несколькими процессорами или с возможностью распределения заданий по нескольким компьютерам
в сети.

Замены
Все Aesub(5) в тестовых командах доступны замены. Некоторые из них
Особо следует отметить:

Архитектура
Эта замена заменяется именем тестируемой архитектуры.

Путь_поиска
Эта подстановка заменяется разделенным двоеточием списком абсолютных путей к
ищите при поиске файлов поддержки тестов.

Поиск_Пути_Исполняемого файла
Эта подстановка заменяется разделенным двоеточием списком абсолютных путей к
поиск при поиске исполняемых файлов поддержки (файлы библиотеки и вложенные
команды).

Большую часть времени $ Search_Path_Executable точно такие же. Однако во время «aegis -t
-bl »они будут другими, с $ Seach_Path начиная с каталога разработки (
выполняется тест) и $ Seach_Path_Executable начиная с базовой линии (исполняемый файл
запустить).

Пусконаладка Результат Коды
По мере выполнения каждого теста (через test_command поле в проекте конфиг файл), эгида
определяет, был ли тест успешным или неудачным, просмотрев его статус выхода. Этот выход
status в основном соответствует ожиданиям для команд UNIX.

Успех
Тест должен выйти из 0, чтобы указать на успех, т. Е. Что конкретная тестируемая функция
работал как положено.

Ошибка
Тест должен выйти из 1, чтобы указать на сбой, т. Е. Что конкретная тестируемая функция
не сработало, как ожидалось.

Нет Результат
Тест должен выйти из 2, чтобы показать отсутствие результата, т.е. что конкретная функция под
Тест не может быть проведен, потому что что-то еще пошло не так. Например, бег
не хватает места на диске при создании тестовых входных файлов в / Tmp каталог.

Пропущено
Тест должен выйти 77, чтобы указать, что он был пропущен. Обычно это связано с
текущая архитектура не имеет смысла. По возможности используйте «Нет результата».
вместо. (Значение было выбрано для совместимости с другими тестовыми системами.)

Фактически, любой код выхода, отличный от 0, 1 или 77, будет интерпретироваться как «без результата».
Однако постоянное использование 0, 1, 2 или 77 означает, что если новый код результата требуется
после выпуска Aegis ваши существующие тесты продолжат работать.

ИСПЫТАНИЕ СООТВЕТСТВИЕ

Команда «aegis -Test -SUGgest» может использоваться для того, чтобы программа aegis предлагала подходящую регрессию.
проверяет ваше изменение на основе исходных файлов в вашем изменении. Это автоматически
фокусирует усилия по тестированию на соответствующих тестах, сокращая количество регрессионных тестов
необходимо, чтобы быть уверенным, что вы не ввели ошибку.

Тестовые корреляции генерируются командой «aegis -Integrate_Pass», которая
связывает каждый тест в изменении с каждым исходным файлом в изменении. Таким образом, каждый
Исходный файл накапливает список тестов, которые были связаны с ним в прошлом.
Это не так точно, как анализ покрытия кода, но является разумным приближением в
практика.

Ассоциация AECP(1) и анф(1) команды используются для связывания файлов с изменением. В то время как они
не выполняют активную ассоциацию, это файлы, используемые эипасс(1) и
AET(1), чтобы определить, какие исходные файлы связаны с какими тестами.

Пусконаладка Корреляция точность
Предполагая, что корреляции тестирования точны и что тесты
распределенных по функциональному пространству, будет меньше, чем 1 / номер шанс, что
соответствующий тест не проводился программой «aegis -Test -SUGgest. номерКоманда. Маленький
количество шума добавляется к весовому тесту, поэтому иногда возникают неожиданные вещи.
проверено, и одни и те же тесты не запускаются каждый раз.

Точность корреляции теста можно повысить, если:

· Каждое изменение должно быть строго целенаправленным, без дополнительных файлов. Этот
избегает ложных корреляций.

· Каждый элемент новой функциональности следует добавлять в отдельное изменение, а не
несколько вместе. Это сильно коррелирует между тестами и функциональностью.

· Каждую ошибку следует исправлять в отдельном изменении, а не в нескольких вместе. Этот
сильно коррелирует тесты с функциональностью.

· Тестовые корреляции будут потеряны при перемещении файлов. Это потому, что корреляции
имя.

Лучший способ точной корреляции тестов с исходными файлами - это изменение
содержит тест и именно те файлы, которые относятся к тестируемой функциональности. Тоже
много ложных файлов ослабят полезность корреляций тестирования.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Подразумеваются следующие варианты:

-АВТОМАТИЧЕСКИЙ
Эта опция может использоваться для указания автоматических тестов. Автоматические тесты не требуют
человеческая помощь.

-Базовая линия
Эта опция может использоваться, чтобы указать, что базовый план проекта является предметом
команда.

-BAse_RElative
Эта опция может использоваться для того, чтобы относительные имена файлов считались относительно
основание исходного дерева. Видеть aeuconf(5) для соответствующего пользователя
предпочтение.

-CUrrent_RElative
Эта опция может использоваться для того, чтобы относительные имена файлов считались относительно
текущий каталог. Обычно это значение по умолчанию. Видеть aeuconf(5) для
соответствующие предпочтения пользователя.

-Изменять номер
Этот параметр можно использовать для указания конкретного изменения в проекте. Видеть
эгида(1) для полного описания этой опции.

-Сила Эта опция может использоваться, чтобы указать, что все тесты должны быть запущены, даже если
статус последнего тестового запуска указывает на то, что нет необходимости запускать конкретный
тест.

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

-Независимый
Эта опция используется, чтобы указать, что тест должен выполняться независимо от каких-либо
конкретное изменение. Если ни один из тестов не назван, будут запущены все тесты базового уровня.

-Список
Эта опция может использоваться для получения списка подходящих субъектов для этой команды.
Список может быть более общим, чем ожидалось.

-Руководство по эксплуатации Эта опция может использоваться для указания ручных тестов. Ручные тесты требуют участия человека
вмешательство, например: подтверждение некоторого поведения экрана (например, X11), или
какое-то действие пользователя, «отключите кабель Ethernet сейчас».

-Not_Logging
Эта опция может использоваться, чтобы отключить автоматическое ведение журнала вывода и ошибок в
файл. Это часто бывает полезно, когда несколько команд aegis объединены в оболочке.
скрипты.

-PНастойчиво
Эта опция может использоваться, чтобы указать, что все тесты должны быть запущены, даже если некоторые
неудача. По умолчанию для пользователя persevere_preference если не указано, см.
aeuconf(5) для получения дополнительной информации.

-No_PErsevere
Эта опция может использоваться, чтобы указать, что тестовый запуск должен останавливаться после первого
отказ. По умолчанию для пользователя persevere_preference если не указано, см.
aeuconf(5) для получения дополнительной информации.

-Проект имя
Эта опция может быть использована для выбора интересующего проекта. Когда нет -Проект
опция указана, ЭГИС_ПРОЕКТ переменная среды консультируется. Если
которого не существует, пользователь $ HOME / .aegisrc файл проверяется на предмет дефолта
поле проекта (см. aeuconf(5) для получения дополнительной информации). Если этого не существует,
когда пользователь работает только над изменениями в рамках одного проекта, проект
имя по умолчанию для этого проекта. В противном случае это ошибка.

-Прогресс
Эта опция может использоваться, чтобы указать, что сообщения о ходе выполнения должны выдаваться перед
каждый тестовый запуск или перед каждым тестовым запуском партии в случае, если Batch_test_command поле
указано в проекте конфиг файл (см. aeuconf(5) для получения дополнительной информации).

-Нет прогресса
Эта опция может использоваться, чтобы указать, что сообщения о ходе выполнения должны подавляться.
Это значение по умолчанию.

-РЕГРЕССИЯ
Эта опция используется, чтобы указать, что должен быть запущен набор регрессионных тестов. В
набор регрессионных тестов состоит из всех тестов в базовой линии, которые не отображаются
в смене. Если нет регрессионных тестов, это ошибка. Вы не можете
name tests в командной строке при использовании параметра -REGression. Вы можете назвать
отдельные тесты для запуска из командной строки без использования -REGression
вариант; если они не являются частью изменения, одноименные тесты в
базовый уровень будет запущен.

-Предложить [ номер ]
"эгида -Integrate_Pass»Команда собирает статистику корреляции тестов, когда
изменения интегрированы. Эта опция может использоваться, чтобы запросить у Aegis предложение
какие тесты следует запускать, используя эти корреляции тестирования. Если номер не указан
указано, будет предложено 10 тестов. Этот вариант подразумевает -РЕГРЕССИЯ
опцию.

-SUGgest_Limit минут
Эта опция может использоваться для ограничения количества тестов до определенного количества
минут. Они будут проходить от наиболее релевантного к наименее релевантному.

-SUGgest_Noise номер
Эта опция может использоваться для управления количеством шума, вводимого в тест.
отбор осуществлен -Предложить вариант. Число - это процент шума.
быть введенным. Если не указано иное, по умолчанию - 10. Введение шума обеспечивает
что при последующих запусках выполняется множество тестов, а также некоторые из левого поля
в качестве проверки на вменяемость.

-TERse
Эта опция может использоваться для того, чтобы списки отображали минимум
Информация. Обычно это полезно для сценариев оболочки.

-Подробный
Эта опция может использоваться для увеличения производительности aegis. По умолчанию aegis
выводит только сообщения об ошибках. При использовании с -Список вариант этот вариант
вызывает добавление заголовков столбцов.

-Ждать Эта опция может использоваться для того, чтобы команды Aegis ожидали блокировки доступа, если
их нельзя получить сразу. По умолчанию для пользователя lock_wait_preference
если не указано, см. aeuconf(5) для получения дополнительной информации.

-Нет, подождите
Эта опция может использоваться для того, чтобы команды Aegis выдавали фатальную ошибку, если доступ
замки нельзя получить сразу. По умолчанию для пользователя
lock_wait_preference если не указано, см. aeuconf(5) для получения дополнительной информации.

Смотрите также эгида(1) для параметров, общих для всех команд aegis.

Все параметры могут быть сокращены; аббревиатура оформляется заглавными буквами,
все строчные буквы и символы подчеркивания (_) необязательны. Вы должны использовать последовательные
последовательности необязательных букв.

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

Например: аргументы «-project», «-PROJ» и «-p» интерпретируются как означающие
-Проект вариант. Аргумент "-prj" не будет понят, потому что последовательные
необязательные символы не были предоставлены.

Параметры и другие аргументы командной строки могут быть произвольно смешаны в командной строке,
после переключателей функций.

Понятны длинные имена опций GNU. Поскольку все имена опций для эгида длинные,
это означает игнорирование лишнего начала "-". "--вариант=ценностное "конвенция также
понят.

Рекомендуемые ALIAS

Рекомендуемый псевдоним для этой команды:
csh% псевдоним aet 'aegis -t \! * -v'
sh $ aet () {aegis -t "$ @" -v}

ОШИБКИ

Будет ошибкой, если изменение не в одном из не являетесь развитый or не являетесь интегрированный
состояния.
Это ошибка, если изменение не назначено текущему пользователю.
Это ошибка, если у вас нет соответствующих тестов и соответствующего освобождения.

ВЫХОД статус

Ассоциация эгида команда завершит работу со статусом 1 при любой ошибке. В эгида команда будет только
выйти со статусом 0, если ошибок нет.

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

Читать эгида(1) для списка переменных среды, которые могут повлиять на эту команду. Видеть
aepconf(5) для файла конфигурации проекта проект_специфический поле для установки
переменные среды для всех команд, выполняемых Aegis.

Используйте aet в Интернете с помощью сервисов onworks.net