トライアル - クラウドでオンライン

プログラム：

NAME

トライアル-単体テストを実行します

SYNOPSIS

トライアル [ オプション ] [ file | パッケージ | モジュール | テストケース | 試験方法 ]..。

トライアル - 助けて | -h

DESCRIPTION

トライアルは、モジュール、パッケージ、ファイルから取得した一連の単体テストをロードして実行します
コマンドラインにリストされています。

トライアルは、ファイル名または完全修飾Python名のいずれかを引数として取ります。 したがって
`trial myproject / foo.py'、`trial myproject.foo'、 `trial
myproject.foo.SomeTestCase.test_method'はすべて、試行を呼び出すための有効な方法です。 そのような複数
引数も受け入れられ、それらの順序によって、
対応するテストが実行されます。

指定されたテストスイートを実行した後、デフォルトのテストレポーターはテストの概要を出力します
走る。 これは、「PASSED」（すべてのテストが期待どおりに実行された場合）または「FAILED」（存在する場合）という単語で構成されます。
テストが予期しない動作をした）、その後にさまざまな種類のテスト結果のカウントが続く
遭遇した。 可能なテスト結果の種類は次のとおりです。

成功
すべてのアサーションに合格し、エラーなしで完了したテスト。 これらは
通常のテスト出力で「合格」とマークされています。

障害
self.fail（）と呼ばれる、または明示的に発生したアサーションに失敗したテスト
何らかの理由でself.failureException。 これらは通常のテストで「失敗」とマークされています
出力。

エラー予期しない例外（AssertionErrorを含む）を発生させたテスト、
tearDown（）メソッドが例外を発生させ、テストがより長く実行された
タイムアウト間隔、twisted.python.log.err（）を呼び出す原因となったテスト
その後self.flushLoggedErrors（）を呼び出さずに、reactorを離れるテスト
これらは、通常のテスト出力で「エラー」とマークされています。

実際のテストメソッドが戻った後にエラーが発生する可能性があるため、
単一のテストがエラーと失敗の両方として報告される可能性があるため、
テスト結果の総数は、テストの総数よりも多くなる可能性があります
実行されました。

スキップします。通常、依存関係が欠落しているためにスキップされたテスト。 これらはマークされています
通常のテスト出力の「SKIPPED」。

予想される失敗
失敗したが、失敗すると予想されたテスト。通常、テストは
まだ実装されていない機能。 これらは通常「TODO」とマークされています
テスト出力。

予期しない成功
一部のテストを除いて、expectedFailuresの下にリストされているはずのテスト
テストが成功した理由。 これらは「SUCCESS！？！」とマークされています通常のテスト出力で。

OPTIONS

-j, -ジョブ 数
実行するプロセスワーカーの数を設定します。 デバッグと競合します、exitfirst
およびプロファイルオプション。

-b, - デバッグ
デバッガーでテストを実行します。 そのデバッガーが「pdb」の場合（これはデフォルトです
指定なし）、 `.pdbrc'が存在する場合は、現在のディレクトリからロードされます。
また、例外の事後デバッグも行います。

-B, --debug-スタックトレース
遅延作成とコールバックスタックトレースを報告します。

- カバレッジ
トライアル臨時雇用者の`coverage'サブディレクトリにカバレッジ情報を生成します
ディレクトリ（デフォルトでは `_trial_temp'）。 が触れたPythonモジュールごとに
指定されたテストを実行すると、カバレッジディレクトリにファイルが作成されます
接尾辞`.cover'が付いたモジュールの完全修飾名にちなんで名付けられました。 例えば、
トライアルテストランナーはPythonで記述されているため、カバレッジディレクトリは
ほとんどの場合、`twisted.trial.runner.cover'という名前のファイルが含まれています。

各`.cover'ファイルには、問題のモジュールのPythonソースのコピーが含まれています。
カバレッジ情報を含む各行の先頭にプレフィックスが付いています。 にとって
実行可能でない行（空白行、コメントなど）は、プレフィックスが空白です。
テストスイートの過程で実行された実行可能行の場合、プレフィックスは
その行が実行された回数を示す数値。 文字列`>>>>>> '
テストスイートの過程で実行されなかった実行可能行のプレフィックス。

この機能はPythonのsys.settrace（）関数を使用するため、次のことをテストすることに注意してください。
sys.settrace（）を呼び出すこと自体が、トライアルのカバレッジ機能を損なう可能性があります。

- デバッガ
--debugオプションが渡されたときに使用するデバッガーを指定します。 議論
同じインターフェースを実装するオブジェクトの完全修飾名である必要があります
標準ライブラリの`pdb'として。

--disablegc
テストの実行中は、ガベージコレクタを無効にします。 各テストは
run、trialはTestResultオブジェクトを保存します。これは、Pythonのガベージを意味します
コレクターには、より多くの非ガベージオブジェクトがあり、各ガベージを作成します-
コレクションの実行が少し遅くなります。 ガベージコレクションを完全に無効にすると、
一部のテストスイートは、より速く完了します（以下のコントラスト--force-gc）。
メモリ消費量が（おそらく大幅に）増加します。 このオプションはテストも行います
少し決定論的で、極端な状況でのデバッグに役立つ場合があります。

-e, --rterrors
トレースバックが発生したらすぐに標準出力に出力します。

--force-gc
各テストケースの前後にgc.collect（）を実行します。 これを使用して分離できます
オブジェクトが収集されるときに発生するエラー。 このオプションがデフォルトになりますが、
ただし、テストの実行が約XNUMX倍遅くなります。

-h, - 助けて
使用法メッセージを標準出力に出力してから終了します。

--ヘルプオーダー
TestCaseテストメソッドを実行できる可能性のある注文のリストを印刷してから
出口。 注文は、以下で説明する--orderオプションで使用できます。

--help-レポーター
有効なレポーターのリストを標準出力に出力してから終了します。 記者はすることができます
以下で説明する--reporterオプションで選択します。

--ヘルプリアクター
可能なリアクタのリストを標準出力に出力してから終了します。 すべてがリストされているわけではありません
リアクターはすべてのプラットフォームで利用できます。 リアクターは、
--reactorオプションについては以下で説明します。

-l, --ログファイル ログファイル
ログを別のファイルに転送します。 デフォルトのファイルは`test.log'です。 ログファイル is
_trial_tempを基準にしています。

-n, -ドライラン
すべてのテストを通過し、実行せずに合格させます。

-N, --再帰なし
デフォルトでは、試行はパッケージを繰り返して、すべてのモジュール内のすべてのモジュールを検索します
サブパッケージ。 つまり、このオプションを指定しない限り。

--nopm 例外の事後分析のためにデバッガーに自動的にジャンプしないでください。
--debugと組み合わせてのみ使用できます。

- 注文 注文
指定されたTestCase内で個々のテストメソッドを実行する順序を指定します。
デフォルトでは、アルファベット順に実行されます。 その他の有効なリストについては、-help-orderを参照してください
値。

- プロフィール
Pythonプロファイラーでテストを実行します。

-r, -原子炉 原子炉
使用するリアクターを選択します。 リストについては、-help-reactorsを参照してください。

--recursionlimit 制限
Pythonの再帰制限を設定します。 sys.setrecursionlimit（）を参照してください。

-レポーター レポーター
トライアルの出力に使用するレポーターを選択します。 --help-reportersオプションを使用して
有効なレポーターのリストを参照してください。

-x, --最初に終了
成功しなかった最初のテストの後で、テストの実行を停止します。 これも
失敗、エラー、または予期しない成功。 --jobsオプションでは機能しません
現在。

- 吐く 発生したすべての非常に詳細なログを印刷します。 デバッグ時に役立ちます
複雑なコードをフリーズまたはロックします。

--tbformat 形式でアーカイブしたプロジェクトを保存します．
トレースバックを表示するためのフォーマット。 許容値は、 `default'、` brief'、および
「詳細」。 `brief'は、EmacsのGUDとうまく連携するトレースバックを生成します。

--temp-ディレクトリ ディレクトリにジョブを開始します。
警告：何をしているのかわからない場合は、このオプションを使用しないでください。 デフォルトでは、
トライアルは、現在の作業ディレクトリの下に_trial_tempというディレクトリを作成します。
トライアルを実行するとき、それは最初に 削除する このディレクトリを作成し、変更します
テストを実行するディレクトリに移動します。 ログファイルとカバレッジファイルが保存されます
ここ。 以外のディレクトリで試用を実行する場合は、このオプションを使用します
_trial_temp。 注意してください、裁判は 削除 再作成する前のディレクトリ。

--testmodule ファイル名
調査するために裁判を依頼する ファイル名 Emacsスタイルを使用して指定されたテストを実行します
バッファ変数`test-case-name'。

--汚れた-警告
Twisted 8.0以降、リアクターが汚れたままになっていると、トライアルでエラーが報告されます。
テストの終わり。 このオプションは、Twisted2.5からTwistedXNUMXへの移行を支援するために提供されています
8.0以降をツイストしました。 このオプションを有効にすると、エラーが警告に変わります。

-u, --失敗するまで
テストのXNUMXつでエラーまたは失敗が発生するまで、テストをループし続けます。 これは
断続的な障害を再現するのに特に役立ちます。

- バージョン
ツイストバージョン番号を出力して終了します。

--モジュールなし モジュール名
モジュールの指定されたコンマ区切りリストの欠如をシミュレートします。 これはそれを作ります
モジュールがシステムに存在しないように見えるため、テストで
その構成の動作。

-z, - ランダム シード
指定されたシードを使用して、ランダムな順序でテストを実行します。 次の場合はこのオプションを渡さないでください
また、-orderを渡します。

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