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

ПРОГРАММА:

ИМЯ

aegis new test - добавить новый тест в изменение

СИНТАКСИС

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

ОПИСАНИЕ

Ассоциация эгида -Новый_Тест команда используется для добавления нового теста к изменению. Создается новый файл
в каталоге разработки.

Новые тесты по умолчанию являются «автоматическими», если не указано иное.

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

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

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

Пусконаладка Имя файла Поколение
Вы можете выбрать собственное имя файла для теста, указав его в командной строке.

Если имя файла не указано в командной строке, автоматически создается тестовое имя файла.
сгенерировано. Это контролируется новое_test_filename область проекта
файл конфигурации (см. aepconf(5) для получения дополнительной информации. Все автоматически генерируется
Имена файлов тестов в проекте имеют уникальную нумерацию. Шаблон по умолчанию для нового теста
имена файлов "test / XX / tXXXX [am] .sh", где XX это первые 2 цифры номера теста,
XXXX - это полный номер теста, и [утра] это a для автоматических тестов и m для ручных тестов.

Изменение Tests
В будущем тесты могут быть изменены путем добавления их к изменению с AECP(1) команда.
Тесты обрабатываются так же, как и любой другой исходный файл, и подвергаются тому же процессу.

Файл Шаблоны
Когда в каталоге разработки создается новый файл, проект конфиг файл
искал шаблон для нового файла. Если шаблон найден, новый файл будет
инициализируется шаблоном, иначе он будет создан пустым. Видеть aepconf(5) подробнее
Информация.

Самая простая форма - использовать файлы шаблонов, например
файл_шаблон =
[
{
шаблон = ["* .c"];
body = "$ {read_file $ {исходный шаблон / c abs}}";
},
{
шаблон = ["тест / * /. ш"];
body = "$ {read_file $ {исходный шаблон / тест абс}}";
},
];
Как видите, файлы шаблонов являются частью исходного кода проекта, поэтому вы можете добавить
соответствующие уведомления об авторских правах и обертки, и т.д, $ источник замена находит их,
если они не являются частью текущего изменения (а обычно это не так).

Сами файлы шаблонов содержат подстановки. В $ filename замена
доступен и содержит имя создаваемого файла. Этим можно манипулировать в
различными способами при конструировании соответствующего содержимого файла. Видеть Aesub(5) подробнее
информация о заменах.

Также можно запустить команду для создания нового файла. Вы можете сделать это вместо
указание основной строки, а именно:
файл_шаблон =
[
{
шаблон = ["*"];
body_command = "perl $ {source template.pl abs} $ filename";
},
];
Команда запускается с текущим каталогом, установленным в верхнюю часть каталога разработки.
Если команда не может создать файл, это ошибка. Вы можете смешивать и сочетать два
методы, тело строка и body_command, если ты хочешь.

Будьте внимательны и убедитесь, что шаблон шаблона тестового имени файла соответствует
новое_test_filename поле.

Файл Фамилия ограничения
Доступен ряд элементов управления, ограничивающих форму имен файлов проекта. Все
эти элементы управления можно найти в файле конфигурации проекта, см. aepconf(5) подробнее
Информация. Здесь кратко описаны наиболее важные из них:

максимальное_имя_файла_длина = целое число;
Это поле используется для ограничения длины имен файлов. Все новые файлы могут не иметь
компоненты пути длиннее этого. По умолчанию 255, если не установлено. Для максимального
Переносимость, вы должны установить это на 14.

posix_filename_charset = логический;
Это поле можно использовать для ограничения символов, разрешенных в именах файлов, только теми
явно разрешено POSIX. По умолчанию ложный если не установлен, то есть все, что у вас
операционная система допускает, за исключением пробелов и символов с высоким битом.
Для максимальной переносимости вы должны установить это на правда.

dos_filename_required = логическое;
Это поле можно использовать для ограничения имен файлов, чтобы они соответствовали DOS 8 + 3.
пределы имени файла и набор символов имени файла DOS. По умолчанию ложный если не
комплект.

windows_filename_required = логический;
Это поле можно использовать для ограничения имен файлов, чтобы они соответствовали стандарту Windows98.
и WindowsNT ограничения имен файлов и набор символов. По умолчанию ложный если не установлен.

shell_safe_filenames = логический;
Это поле можно использовать для ограничения имен файлов, чтобы они не содержали оболочку
специальные символы. По умолчанию правда если не установлен. Если в этом поле установлено значение ложный,
вам нужно будет использовать $ {quote} подстановка имен файлов в командах, чтобы
убедитесь, что имена файлов, содержащие специальные символы оболочки, не содержат непреднамеренных
побочные эффекты. Странные символы в именах файлов также могут сбить с толку вашу зависимость.
инструмент для обслуживания.

allow_white_space_in_filenames = логический;
Это поле может использоваться, чтобы разрешить использование символов пробела в именах файлов. Это будет
разрешить использование следующих символов в именах файлов: backspace (BS, \ b, 0x08),
горизонтальная табуляция (HT, \ t, 0x09), новая строка (NL, \ n, 0x0A), вертикальная табуляция (VT, \ v,
0x0B), подача формы (FF, \ f, 0x0C) и возврат каретки (CR, \ r, 0x0D). По умолчанию
false, если не установлен.

Обратите внимание, что это поле не отменяет другие фильтры имен файлов. Это будет
необходимо явно установить Shell_safe_filenames = ложный также. Это будет
необходимо установить dos_filename_required = ложный (по умолчанию). Это будет
необходимо установить posix_filename_charset = ложный (по умолчанию).

Пользователь должен очень внимательно использовать замену $ {quote} для всего файла.
имена в командах в конфигурации проекта. И даже тогда замены
которые ожидают, что список имен файлов, разделенных пробелами, будет иметь неопределенные результаты.

allow_non_ascii_filenames = логическое;
Это поле может использоваться, чтобы разрешить имена файлов с символами, не печатаемыми в формате ascii, в
их. Обычно это означает кодировку UTF8 или какую-либо международную кодировку.
Если не задано, по умолчанию используется значение false.

Обратите внимание, что это поле не отменяет другие фильтры имен файлов. Это будет
необходимо явно установить Shell_safe_filenames = ложный также. Это будет
необходимо установить dos_filename_required = ложный (по умолчанию). Это будет
необходимо установить posix_filename_charset = ложный (по умолчанию).

filename_pattern_accept = [строка];
Это поле используется для указания списка шаблонов допустимых имен файлов.
По умолчанию "*", если не установлен.

filename_pattern_reject = [строка];
Это поле используется для указания списка шаблонов недопустимых имен файлов.

Пожалуйста, Примечание: Aegis также обращается к базовой файловой системе, чтобы определить ее понятие
максимальный размер файла. Если максимальный размер файла файловой системы меньше, чем
максимальная_имя_файла_длина, файловая система выигрывает. Это может произойти, например, когда вы
с использованием файловой системы Linux UMSDOS или когда у вас есть NFS, смонтированная на древнем V7
файловая система. Параметр максимальная_имя_файла_длина до 255 в этих случаях не меняет
Дело в том, что ограничения для базовых файловых систем намного меньше (12 и 14 соответственно).

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

Если ваши каталоги разработки обычно находятся в файловой системе Linux UMSDOS, вы должны
наверное, лучше было бы устроить dos_filename_required = правда, а также изменение
development_directory_template поле. Гетерогенная разработка с различными окнами
окружающая среда также может потребовать этого.

Изменение домен Тип of a Файл
Если вы хотите изменить тип файла (скажем, с тестового на исходный файл или вице
Versa) вы можете сделать это как два изменения, сначала используя Aerm(1) с одной заменой, а затем
через анф(1) или Aent(1) во втором изменении, или вы можете объединить оба шага в одном
изменение. Не забудьте использовать Aerm -ночь вариант или вы получите самый необычный новый
шаблон файла.

Уведомления
Ассоциация new_test_command в проекте конфиг файл запускается, если установлен. В проект_файл_команда
также запускается, если он установлен, и если недавно была произведена интеграция. Видеть aepconf(5) для
больше информации.

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

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

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

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

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

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

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

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

Команда «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 объединены в оболочке.
скрипты.

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

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

-Шаблон
Этот параметр можно использовать, чтобы указать, что следует использовать новый шаблон файла, даже
если файл уже существует.

-No_TEMplate
Эта опция может использоваться, чтобы указать, что новый шаблон файла не должен использоваться,
даже если файл не существует (будет создан любой пустой файл).

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

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

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

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

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

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

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

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

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

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

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

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

ОШИБКИ

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

ВЫХОД статус

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

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

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

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