aent - クラウド上のオンライン

プログラム：

NAME

aegis 新しいテスト - 新しいテストを変更に追加します

SYNOPSIS

イージス -新規_テスト [ オプション...] [ ファイル名...]
イージス -新規_テスト -リスト [ オプション...]
イージス -新規_テスト -ヘルプ

DESCRIPTION

この イージス -新規_テスト コマンドは、変更に新しいテストを追加するために使用されます。 新しいファイルが作成されます
開発ディレクトリ内。

特に指定がない限り、新しいテストはデフォルトで「自動」になります。

File お名前 解釈
aegisプログラムは、ファイル名からプロジェクトファイル名を判別しようとします。
コマンドラインで指定します。 すべてのファイル名は、相対的なものとしてaegisプロジェクト内に保存されます
ベースラインディレクトリツリーのルートに移動します。 開発ディレクトリと
統合ディレクトリはこのベースラインディレクトリの影であるため、これらの相対名
こちらもお申し込みください。 コマンドラインで指定されたファイルは、最初に絶対パスに変換されます
必要であれば。 次に、それらはベースラインパスである開発ディレクトリと比較されます。
パス、およびベースライン相対名を決定するための統合ディレクトリパス。 です
指定されたファイルがこれらのディレクトリツリーのいずれかの外にある場合はエラーになります。

この -BAse_RElative オプションを使用すると、相対ファイル名を次のように解釈できます。
ベースラインパスを基準にしています。 絶対ファイル名は引き続きさまざまなファイル名と比較されます
ベースライン相対名を決定するためのパス。

この Relative_filename_preference ユーザー構成ファイルで変更するために使用される場合があります
このデフォルトの動作。 見る aeuconf（5）詳細については。

ホイール試乗 ファイル名 世代
コマンド ラインで指定することで、テスト用に独自のファイル名を選択できます。

コマンドラインでファイル名が指定されていない場合、テストファイル名が自動的に付けられます。
生成された。 これは次によって制御されます。 新しいテストファイル名 プロジェクトの分野
構成ファイル (を参照) aepconf詳細については (5) を参照してください。 すべて自動生成
プロジェクト内のテスト ファイル名には一意の番号が付けられます。 新しいテストのデフォルトのパターン
ファイル名は「テスト/XX/tXXXX[午前].sh"、 どこ XX はテスト番号の最初の 2 桁です。
ブース番号：XNUMXホールXNUMXCXNUMX はテスト番号全体であり、 [午前] a は自動テストの場合、m は手動テストの場合です。

変更 テスト
テストは、変更に追加することで将来変更される可能性があります。 acp（1）コマンド。
テストは他のソース ファイルと同様に扱われ、同じプロセスの対象となります。

File テンプレ
開発ディレクトリに新しいファイルが作成されると、プロジェクトは 設定 ファイルは
新しいファイルのテンプレートを検索しました。 テンプレートが見つかった場合、新しいファイルは
テンプレートに初期化されない場合は、空で作成されます。 見る aepconf（5）詳細
情報を表示します。

最も単純な形式は、次のようなテンプレート ファイルを使用することです。
ファイルテンプレート =
[
{
パターン = [ "*.c" ];
body = "${read_file ${ソーステンプレート/c abs}}";
},
{
パターン = [ "test/*/.sh" ];
body = "${read_file ${ソーステンプレート/テストabs}}";
},
];
ご覧のとおり、テンプレート ファイルはプロジェクト ソースの一部であるため、
適切な著作権表示とラッパー、 等を選択します。 $ソース 置換によりそれらが見つかります。
それらが現在の変更の一部ではない場合 (通常はそうではありません)。

テンプレート ファイル自体には置換が含まれています。 の $ filename 置換は
利用可能で、作成中のファイルの名前が含まれています。 これはで操作できます
適切なファイルの内容を構築する際のさまざまな方法。 見る エースサブ（5）詳細
代替品に関する情報。

コマンドを実行して新しいファイルを作成することもできます。 代わりにこれを行うことができます
本体文字列を指定し、 つまり：
ファイルテンプレート =
[
{
パターン = [ "*" ];
body_command = "perl ${source template.pl abs} $filename";
},
];
このコマンドは、現在のディレクトリを開発ディレクトリの先頭に設定して実行されます。
コマンドがファイルの作成に失敗した場合はエラーになります。 XNUMX つを組み合わせて使用​​できます
テクニック、 ボディ 文字列と ボディコマンド、 お望みならば。

テスト ファイル名のテンプレート パターンが、
新しいテストファイル名 フィールド。

File お名前 製品制限
プロジェクト ファイル名の形式を制限するために使用できるコントロールが多数あります。 すべての
これらのコントロールはプロジェクト構成ファイル内にある場合があります。「」を参照してください。 aepconf（5）詳細
情報。 最も重要なものをここで簡単に説明します。

maximum_filename_length = 整数;
このフィールドは、ファイル名の長さを制限するために使用されます。 すべての新しいファイルには、
これより長いパスコンポーネント。 設定されていない場合、デフォルトは 255 です。 最大限に
移植性を考慮して、これを 14 に設定する必要があります。

posix_filename_charset = ブール値;
このフィールドは、ファイル名に使用できる文字を次の文字のみに制限するために使用できます。
POSIX によって明示的に許可されています。 デフォルトは false 設定されていない場合は、どんな意味でも
オペレーティング システムは、空白文字と高ビットオン文字を除いて許容します。
移植性を最大限に高めるには、これを次のように設定する必要があります。 true.

dos_filename_required = ブール値;
このフィールドは、DOS 8+3 に準拠するようにファイル名を制限するために使用できます。
ファイル名は DOS ファイル名文字セットに制限されます。 デフォルトは false そうでなければ
設定します。

windows_filename_required = ブール値;
このフィールドは、Windows98 に準拠するようにファイル名を制限するために使用できます。
WindowsNT のファイル名の制限と文字セット。 デフォルトは false 設定されていない場合。

shell_safe_filenames = ブール値;
このフィールドは、ファイル名にシェルが含まれないように制限するために使用できます。
特殊文字。 デフォルトは true 設定されていない場合。 このフィールドが次のように設定されている場合、 false,
あなたは使用する必要があります ${引用} コマンド内のファイル名の置換、
シェル特殊文字を含むファイル名に意図しない文字が含まれていないことを確認します。
副作用。 ファイル名に奇妙な文字が含まれていると依存関係が混乱する可能性もあります
メンテナンスツール。

allow_white_space_in_filenames = ブール値;
このフィールドは、ファイル名に空白文字を使用できるようにするために使用できます。 この意志
ファイル名に次の文字を使用できるようにします: バックスペース (BS、\b、0x08)、
水平タブ (HT、\t、0x09)、改行 (NL、\n、0x0A)、垂直タブ (VT、\v、
0x0B)、フォーム フィード (FF、\f、0x0C)、およびキャリッジ リターン (CR、\r、0x0D)。 デフォルトは
設定されていない場合は false。

このフィールドは他のファイル名フィルターをオーバーライドしないことに注意してください。 そうなる
明示的に設定する必要がある シェル_セーフ_ファイル名 = false 同じように。 そうなる
設定する必要があります dos_ファイル名_必須 = false (デフォルト)も同様です。 そうなる
設定する必要があります posix_filename_charset = false (デフォルト)も同様です。

ユーザーは、すべてのファイルで ${quote} 置換を使用するように細心の注意を払う必要があります。
プロジェクト設定のコマンド内の名前。 そしてそれでも、交代
スペースで区切られたファイル名のリストを想定している場合、結果は未定義になります。

allow_non_ascii_filenames = ブール値;
このフィールドは、ASCII で印刷できない文字を含むファイル名を許可するために使用できます。
彼ら。 通常、これは UTF8 またはある種の国際文字セットを意味します。
設定されていない場合、デフォルトは false になります。

このフィールドは他のファイル名フィルターをオーバーライドしないことに注意してください。 そうなる
明示的に設定する必要がある シェル_セーフ_ファイル名 = false 同じように。 そうなる
設定する必要があります dos_ファイル名_必須 = false (デフォルト)も同様です。 そうなる
設定する必要があります posix_filename_charset = false (デフォルト)も同様です。

filename_pattern_accept = [文字列];
このフィールドは、許容されるファイル名のパターンのリストを指定するために使用されます。
設定されていない場合のデフォルトは「*」です。

ファイル名_パターン_拒否 = [文字列];
このフィールドは、受け入れられないファイル名のパターンのリストを指定するために使用されます。

お近くのLuxinar支社またはディストリビューターに ご注意: Aegis はまた、基礎となるファイル システムを参照して、その概念を決定します。
最大ファイルサイズ。 ファイルシステムの最大ファイルサイズが以下の場合
最大ファイル名の長さ、ファイルシステムが勝ちます。 これは、たとえば、次のような場合に発生する可能性があります。
Linux UMSDOS ファイル システムを使用するか、NFS が古い V7 をマウントしている場合
ファイルシステム。 設定 最大ファイル名の長さ この場合、255 に変更しても、
実際、基礎となるファイル システムの制限ははるかに小さい (それぞれ 12 と 14)。

開発ディレクトリ (またはプロジェクト全体) が次のファイル名を持つファイルシステム上にある場合
制限があるか、異種ビルドの一部がそのような環境で行われる場合、
Aegis が何であるかを伝えるのに役立ちます (プロジェクトを使用) 設定 ファイルのフィールド)
プロジェクトがより寛容な環境に基づいて構築される状況に遭遇しないようにする
ただし、より制限された環境では不可解なエラーが発生して失敗します。

開発ディレクトリが日常的に Linux UMSDOS ファイルシステム上にある場合は、次のようにします。
おそらく設定した方が良いでしょう dos_ファイル名_必須 = true、また、
開発ディレクトリのテンプレート 分野。 さまざまなWindowsによるヘテロジニアス開発
環境によってはこれが必要になる場合もあります。

を変える、 　 種類 of a File
ファイルの種類を変更する場合（たとえば、テストからソースファイルに、または バイス
その逆）最初に使用することにより、XNUMXつの変更としてそれを行うことができます アーム（1）XNUMX回の変更で
アーエンフ（1）または えんと（1）XNUMX番目の変更で、または同じで両方のステップを組み合わせることができます
変化する。 を使用することを忘れないでください アーム -ノーホワイトアウト オプションまたはあなたは最も独特な新しいを取得します
ファイルテンプレート。

通知ですよ
この 新しいテストコマンド プロジェクト内の 設定 設定されている場合、ファイルが実行されます。 NS プロジェクトファイルコマンド
設定されている場合、および最近統合が行われた場合にも実行されます。 見る aepconf（5）
詳しくは。

テスト プロセス

それぞれの変更にはテストを伴う必要があり、それらのテストは次のことを行う必要があります。
構築された開発ディレクトリに対して実行され、合格する必要があります。 これにより、新しい
機能にはその正確性を検証するためのテストが伴い、バグ修正は
バグが修正されたことを確認するテストが伴います。

不具合 テスト
テストは他のソース ファイルと同様に扱われ、ベースラインと
他のすべてのソース ファイルとの履歴。 あらゆる変化に伴うテスト
プロジェクトのベースラインに蓄積し、プロジェクトに正しい機能の定義を提供します。
ベースライン。 これらの蓄積されたテストは、「aegis -REGression」コマンドを使用して実行できます。
変更の結果としてプロジェクトが「後退」しないことを確認します。

ベースライン テスト
テストするにはバグ修正が必要です 失敗する プロジェクトのベースラインに対して（対照的に）
開発ディレクトリにコピーします)。 これにより、テストで実際にバグが実証されることが保証されます。
ベースラインで確認するだけでなく、変更によって修正されることも示します。 新しい
機能はベースラインに対して簡単に失敗するため、イージスはそれを試行しません。
テストがバグ修正テストか新機能テストかは、単純にテストが必要であると推測します。
ベースラインに対して失敗します。

この要件は、変更によって作成される新しいテストとテストの両方に適用されます。
変更のために変更にコピーされています。

検討する テスト
査読者は、イージスがテスト要件を強制していると確信しているかもしれません。 それは変化です
テストが必要であること、変更を構築する必要があること、開発に対してテストが合格すること
ディレクトリに保存され、テストがベースラインに対して失敗することがわかります。 これらの条件は強制されます
by エーデ(1) 変更は次の段階には進められません。 さ 日 これらまでの状態
条件は満たされています。 したがって、レビュー担当者は以下のテストをレビューする必要があります。 完全 の範囲の
変更内のコード、および実行環境の変更に対する鈍感さ (例:
日付は重要ではありません)。 レビュー担当者は「aegis -list change_details」も使用して検証する必要があります。
変更にテストの免除があるかどうか。

免除
プロジェクト管理者によってさまざまなテストの免除が許可される場合があります。を参照してください。 アエパ（1）と
アエパット詳細については (5) を参照してください。 テストを変更にコピーする、または新しいテストを変更に追加する
変更した場合、これらの免除が取り消される場合があります。

テスト 相関関係

「aegis -Test -SUGgest」コマンドは、aegis に適切な回帰を提案させるために使用できます。
変更内のソース ファイルに基づいて、変更をテストします。 これは自動的に
テスト作業を関連テストに集中させ、回帰テストの数を削減します。
バグが持ち込まれていないことを確信する必要があります。

テスト相関は「aegis -Integrate_Pass」コマンドによって生成されます。
変更内の各テストを変更内の各ソース ファイルに関連付けます。 したがって、それぞれの
ソース ファイルには、過去に関連付けられたテストのリストが蓄積されます。
これはコード カバレッジ分析ほど正確ではありませんが、妥当な近似値です。
練習。

この acp（1）と アーエンフ(1) コマンドは、ファイルを変更に関連付けるために使用されます。 彼らがいる間、
積極的に関連付けを実行しません。これらは、によって使用されるファイルです。 アイパス（1）と
食べる(1) どのソース ファイルがどのテストに関連付けられているかを判断します。

ホイール試乗 相関 正確さ
テストの相関関係が正確で、テストが均等であると仮定します。
関数空間全体に分散すると、 1/数値 チャンスがある
関連するテストは「aegis -Test -SUGgest」によって実行されていません 数" 指図。 小さな
テストの重み付けにノイズが追加されるため、予期しないことが発生することがあります。
同じテストが毎回実行されるわけではありません。

テスト相関の精度は、以下を確保することで向上できます。

· それぞれの変更は、不必要なファイルを含めることなく、重点を置く必要があります。 これ
偽の相関関係を回避します。

· 新しい機能の各項目は、個別の変更として追加する必要があります。
いくつか一緒に。 これにより、テストと機能が強く相関します。

· 各バグは、複数の変更をまとめて修正するのではなく、個別の変更で修正する必要があります。 これ
テストと機能には強い相関関係があります。

· ファイルを移動すると、テストの相関関係が失われます。 これは、相関関係が
名前。

テストがソース ファイルと正確に関連付けられる最善の方法は、変更が加えられたときです。
テストと、テスト対象の機能に関連する正確なファイルが含まれています。 それも
偽のファイルが多数あると、相関関係のテストの有用性が弱まります。

OPTIONS

次のオプションが理解されます。

-自動
このオプションは自動テストを指定するために使用できます。 自動テストには何も必要ありません
人間の援助。

-BAse_RElative
このオプションを使用すると、相対ファイル名が相対ファイル名と見なされるようになります。
ソースツリーのベース。 見る aeuconf（5）対応するユーザーの場合
好み。

-CURRENT_RElative
このオプションを使用すると、相対ファイル名が相対ファイル名と見なされるようになります。
現在のディレクトリ。 これは通常、デフォルトです。 見る aeuconf（5）
対応するユーザー設定。

-変化する 数
このオプションは、プロジェクト内の特定の変更を指定するために使用できます。 見る
イージス（1）このオプションの完全な説明。

-ヘルプ
このオプションは、使用方法に関する詳細情報を取得するために使用できます。 イージス
プログラム。

-リスト
このオプションは、このコマンドに適したサブジェクトのリストを取得するために使用できます。
リストは予想よりも一般的かもしれません。

-マニュアル このオプションは手動テストを指定するために使用できます。 手動テストには人間によるテストが必要です
介入、例: 何らかの画面動作 (X11 など) の確認、または
何らかのユーザーアクション、「今すぐイーサネットケーブルを抜く」。

-Not_Logging
このオプションは、出力とエラーの自動ログを無効にするために使用できます。
ファイル。 これは、複数のaegisコマンドがシェルで組み合わされている場合に便利です。
スクリプト。

-出力 ファイル名
このオプションは、
自動的に決定されるテストファイル名。 スクリプトを書くのに便利です。

-事業 名
このオプションは、関心のあるプロジェクトを選択するために使用できます。 いいえの場合 -事業
オプションが指定されている場合、 AEGIS_PROJECT 環境変数が参照されます。 もしも
それは存在しません、ユーザーの $ HOME / .aegisrc ファイルはデフォルトで検査されます
プロジェクトフィールド（を参照） aeuconf（5）詳細については）。 それが存在しない場合は、
ユーザーが単一のプロジェクト内の変更のみに取り組んでいる場合、プロジェクト
nameのデフォルトはそのプロジェクトです。 それ以外の場合はエラーです。

-テンプレート
このオプションは、新しいファイル テンプレートを使用することを指定するために使用できます。
ファイルがすでに存在する場合。

-No_TEMplate
このオプションは、新しいファイル テンプレートを使用しないことを指定するために使用できます。
ファイルが存在しない場合でも（空のファイルが作成されます）。

-簡潔
このオプションを使用して、リストに最低限の
情報。 これは通常、シェルスクリプトに役立ちます。

-詳細
このオプションは、aegisがより多くの出力を生成するようにするために使用できます。 デフォルトではイージス
エラー時にのみ出力を生成します。 と一緒に使用する場合 -リスト オプションこのオプション
列見出しが追加されます。

-待って このオプションは、アクセスロックを待機するようにAegisコマンドを要求するために使用できます。
すぐに入手することはできません。 デフォルトはユーザーのものです ロック待機設定
指定されていない場合は、を参照してください。 aeuconf（5）詳細については。

-いいえ_お待ちください
このオプションは、アクセス時に致命的なエラーを発行するようにAegisコマンドを要求するために使用できます
ロックをすぐに取得することはできません。 デフォルトはユーザーのものです
ロック待機設定 指定されていない場合は、を参照してください。 aeuconf（5）詳細については。

参照 イージス（1）すべてのaegisコマンドに共通のオプション。

すべてのオプションは省略できます。 略語は大文字として文書化されていますが、
すべての小文字とアンダースコア（_）はオプションです。 連続して使用する必要があります
オプションの文字のシーケンス。

すべてのオプションでは大文字と小文字が区別されません。大文字または小文字、あるいは
両方の組み合わせ、ケースは重要ではありません。

例：引数「-project」、「-PROJ」、「-p」はすべて、
-事業 オプション。 引数「-prj」は連続しているため理解できません
オプションの文字は提供されませんでした。

オプションおよびその他のコマンドライン引数は、コマンドラインで任意に混在させることができます。
関数セレクターの後。

GNUの長いオプション名は理解されています。 すべてのオプション名が イージス 長いです、
これは、余分な先頭の「-」を無視することを意味します。 NS "--オプション=値「コンベンションも
理解した。

推奨 ALIAS

このコマンドの推奨エイリアスは次のとおりです。
csh% エイリアス aent 'aegis -nt \!* -v'
sh$ aent(){aegis -nt "$@" -v}

エラー

変更が含まれていない場合はエラーです さ 発展した でのみ停止させることができます。
変更が現在のユーザーに割り当てられていない場合はエラーになります。

EXIT ステータス

この イージス コマンドは、エラーが発生するとステータス1で終了します。 NS イージス コマンドはのみ
エラーがない場合は、ステータス0で終了します。

ENVIRONMENT 変数

見る イージス（1）このコマンドに影響を与える可能性のある環境変数のリスト。 見る
aepconf（5）プロジェクト構成ファイルの場合 プロジェクト固有 設定方法のフィールド
Aegisによって実行されるすべてのコマンドの環境変数。

onworks.net サービスを使用してオンラインで aent を使用する