namestests-2.7 - クラウドでオンライン

プログラム：

NAME

nodestests - Python のより良いテスト

ナイサー TESTING FOR パイソン

SYNOPSIS
ノーズテスト [オプション] [名前]

DESCRIPTION
鼻は、見つかったpythonソースファイル、ディレクトリ、およびパッケージから自動的にテストを収集します
その作業ディレクトリ (デフォルトは現在の作業ディレクトリ)。 任意のパイソン
testMatch 正規表現に一致するソース ファイル、ディレクトリ、またはパッケージ (
デフォルト： (?:^|[b_.-])[Tt]est) テスト（または収集のソース）として収集されます
テスト）。 さらに、作業ディレクトリにある他のすべてのパッケージが検査されます
testMatch に一致する Python ソース ファイルまたはディレクトリの場合。 パッケージの発見が下降
ツリーのずっと下にあるので、package.tests と package.sub.tests と
package.sub.sub2.tests はすべて収集されます。

テスト ディレクトリまたはパッケージ内で、testMatch に一致するすべての Python ソース ファイルが
テストケースを調べました。 テスト モジュール内で、名前が一致する関数とクラス
任意の名前の testMatch および TestCase サブクラスがロードされ、テストとして実行されます。
テストでは assert キーワードを使用するか、AssertionErrors を発生させてテストの失敗を示します。
TestCase サブクラスは、同じことを行ったり、利用可能なさまざまな TestCase メソッドを使用したりできます。

It is 重要 〜へ 注意 それ 　 デフォルト 行動 of 鼻 is 〜へ include テスト from
ファイル which 　 実行可能ファイル。 そのようなファイルからテストを含めるには、実行可能ビットを削除します
または --exe フラグを使用します (以下の「オプション」セクションを参照)。

選択 テスト
実行するテストを指定するには、コマンド ラインでテスト名を渡します。

ノーズテスト only_test_this.py

指定されたテスト名は、ファイル名またはモジュール名である場合があり、オプションでテストを示す場合があります
モジュールまたはファイル名をテストケース名からコロンで区切って実行するケース。
ファイル名は相対または絶対です。 例:

ノーズテスト test.module
ノーズテストanother.test:TestCase.test_method
ノーズテスト a.test:TestCase
ノーズテスト /path/to/test/file.py:test_function

-w オプションを使用して、nose がテストを探す作業ディレクトリを変更することもできます。
スイッチ：

ノーズテスト -w /path/to/tests

ただし、複数の -w 引数のサポートは現在非推奨であり、
将来のリリースで削除されます。 ノーズ 0.10 以降、次のように指定することで同じ動作を得ることができます。
ターゲットディレクトリ 無し -w スイッチ:

ノーズテスト /path/to/tests /another/path/to/tests

を使用して、テストの選択とロードをさらにカスタマイズできます。
プラグイン。

テスト結果の出力は、追加機能を除いて unittest と同じです
(エラークラス、および出力キャプチャやアサートなどのプラグイン提供の機能
以下のオプションで詳しく説明します。

　
コマンドライン オプションを渡すだけでなく、構成オプションを指定することもできます。
あなたのプロジェクトの セットアップ.cfg ファイル、またはホーム ディレクトリにある .noserc ファイルまたは noise.cfg ファイル。 の
これらの標準的な ini スタイルの構成ファイルのいずれかで、nosetests 構成を
[ノーズテスト] セクション。 オプションはコマンド ラインと同じで、 -- 接頭辞が付いています。
削除されました。 単純なスイッチであるオプションの場合、値を指定する必要があります。

[ノーズテスト]
詳細度=3
with-doctest=1

見つかったすべての構成ファイルがロードされ、それらのオプションが結合されます。 あなたはできる
標準の設定ファイルの読み込みを上書きします -c オプションを選択します。

使い方 プラグイン
easy_install や他の場所で利用できる多数のノーズ プラグインがあります。 プラグインを使用するには、
インストールするだけです。 プラグインは、コマンド ライン オプションを NOSETEST に追加します。 確認するには、
プラグインがインストールされたら、次を実行します。

ノーズテスト --プラグイン

そのコマンドに -v または -vv を追加して、各プラグインに関する詳細情報を表示できます。

スクリプトからnose.main()またはnose.run()を実行している場合、次のリストを指定できます
plugins キーワード引数でプラグインのリストを渡すことにより、使用するプラグイン。

0.9 プラグイン
ノーズ 1.0 は、ノーズ 0.9 用に作成されたいくつかのプラグインを使用できます。 デフォルトのプラグイン マネージャー
変更されたプラグイン API を適応させる 0.9 プラグインの周りに互換性ラッパーを挿入します
呼び出します。 ただし、鼻の内部にアクセスするプラグインは失敗する可能性があります。
テスト ケースまたはテスト スイート クラスへのアクセスを試みます。 たとえば、
startTest に渡されたテストが個別のテストであるか、スイートが部分的に失敗するかを判断する
スイートは startTest に渡されなくなり、部分的には
プラグインは、テストが存在しないクラスのインスタンスであるかどうかを調べようとしています。

0.10 と 0.11 プラグイン
ノーズ 0.10 および 0.11 用に作成されたすべてのプラグインは、ノーズ 1.0 で動作するはずです。

オプション
-V、 - バージョン
ノーズバージョンを出力して終了

-NS、 -プラグイン
利用可能なプラグインのリストを出力して終了します。 より高い冗長性と組み合わせる
詳細

-v=デフォルト、 --verbose=デフォルト
もっと冗長に。 [NOSE_VERBOSE]

--verbosity=冗長性
冗長性を設定します。 --verbosity=2 は -v と同じです

-q=デフォルト、 --quiet=デフォルト
あまり冗長にしない

-c=ファイル、 --config=ファイル
構成ファイルから構成をロードします。 複数回指定できます。 その中で
この場合、すべての構成ファイルがロードされて結合されます

-w=どこで、 --どこ=どこ
このディレクトリでテストを探します。 複数回指定できます。 最初
渡されたディレクトリは、現在のディレクトリの代わりに作業ディレクトリとして使用されます
デフォルトの作業ディレクトリ。 その他はテストのリストに追加されます
実行します。 [NOSE_WHERE]

--py3where=PY3WHERE
Python 3.x の下のこのディレクトリでテストを探します。 'where' と同じように機能します。
ただし、Python 3.x 以降で実行している場合にのみ適用されます。 以下に存在する場合は、
3.x では、このオプションは「where」で指定されたすべてのディレクトリを完全に置き換えます。
'where' オプションは無効になります。 [NOSE_PY3WHERE]

-m=正規表現、 --マッチ=正規表現、 --testmatch=REGEX
この規則に一致するファイル、ディレクトリ、関数名、およびクラス名
式はテストと見なされます。 デフォルト: (?:^|[b_./-])[Tt]est [NOSE_TESTMATCH]

--tests=名前
これらのテストを実行します (カンマ区切りのリスト)。 この引数は、主に次の場合に役立ちます。
構成ファイル; コマンドラインで、追加として実行するテストを渡すだけです
スイッチなしの引数。

-l=デフォルト、 --debug=デフォルト
XNUMX つ以上のシステムのデバッグ ロギングを有効にします。 利用可能なデバッグロガー: 鼻、
ノーズインポーター、ノーズインスペクター、ノーズプラグイン、ノーズリザルト、ノーズセレクター。
複数の名前はカンマで区切ります。

--debug-log=ファイル
デバッグ メッセージをこのファイルに記録します (デフォルト: sys.stderr)

--logging-config=ファイル, --log-config=ファイル
このファイルからログ構成をロード -- 他のすべてのログ構成設定をバイパスします。

-I=正規表現、 --ignore-files=REGEX
この正規表現に一致するファイルを完全に無視します。 優先する
他の設定やプラグインよりも優先されます。 このオプションを指定すると、デフォルトが置き換えられます
設定。 正規表現を追加するには、このオプションを複数回指定します
[NOSE_IGNORE_FILES]

-e=正規表現、 --exclude=正規表現
正規表現に一致するテストを実行しない [NOSE_EXCLUDE]

-i=正規表現、 --include=正規表現
この正規表現は、ファイル、ディレクトリ、関数名、および
TESTMATCH に一致しない追加のテストを含める機会のためのクラス名。
正規表現を追加するには、このオプションを複数回指定します [NOSE_INCLUDE]

-NS、 - ストップ
最初のエラーまたは失敗の後、テストの実行を停止します

-NS、 --パス調整なし
テストのロード時に sys.path を変更しない [NOSE_NOPATH]

- EXE 実行可能な Python モジュールでテストを探します。 通常の動作は除外することです
実行可能モジュール (インポートしても安全ではない可能性があるため) [NOSE_INCLUDE_EXE]

--noexe
実行可能な Python モジュール内のテストを探してはいけません。 (
Windows プラットフォームでそうする必要があります)。

--traverse-名前空間
名前空間パッケージのすべてのパス エントリをトラバースする

--最初のパッケージの勝利、 --first-pkg-wins、 --1st-pkg-wins
鼻のインポーターは、通常、パッケージが見つかった場合、sys.modules からパッケージを削除します。
別の場所に同じ名前で。 このオプションを設定して無効にします
行動。

--バイトコンパイルなし
鼻がスキャンしている間、鼻がソースを.pycファイルにバイトコンパイルするのを防ぎます
および実行中のテスト。

-a=ATTR、 --attr=ATTR
ATTR [NOSE_ATTR] で指定された属性を持つテストのみを実行します

-A=経験値、 --eval-attr=EXPR
Python 式 EXPR が True と評価される属性のテストのみを実行します
[NOSE_EVAL_ATTR]

-s、 --nocapture
stdout をキャプチャしない (stdout 出力はすぐに印刷されます)
[NOSE_NOCAPTURE]

--nologcapture
ロギング キャプチャ プラグインを無効にします。 ロギング構成はそのまま残ります。
[NOSE_NOLOGCAPTURE]

--logging-format=フォーマット
ステートメントを印刷するためのカスタム形式を指定します。 標準で使用されているものと同じフォーマットを使用
ロギング ハンドラ。 [NOSE_LOGFORMAT]

--logging-datefmt=フォーマット
ステートメントを印刷するカスタムの日付/時刻形式を指定します。 使用されているものと同じフォーマットを使用
標準のロギング ハンドラによって。 [NOSE_LOGDATEFMT]

--logging-filter=フィルター
フィルターイン/フィルターアウトするステートメントを指定します。 デフォルトでは、すべてがキャプチャされます。 もしも
出力が冗長すぎる場合は、このオプションを使用して不要な出力を除外します。 例：
filter=foo は、発行されたステートメントのみをキャプチャします
foo または foo.what.ever.sub ですが、foobar やその他のロガーではありません。 複数のロガーを指定する
カンマ付き: filter=foo,bar,baz. ロガー名の前にマイナスが付いている場合、たとえば
filter=-foo の場合、含まれるのではなく除外されます。 デフォルト: ロギングを除外
ノーズ自体からのメッセージ (-nose)。 [NOSE_LOGFILTER]

--logging-clear-handlers
他のすべてのロギング ハンドラをクリアします

--ロギングレベル=デフォルト
キャプチャするログ レベルを設定する

--補償あり
プラグイン カバレッジを有効にする: Ned Batchelder のカバレッジを使用してカバレッジ レポートを有効にします。
モジュールを開きます。
[NOSE_WITH_COVERAGE]

--cover-package=パッケージ
カバレッジ出力を選択したパッケージに制限する [NOSE_COVER_PACKAGE]

--カバー消去
実行前に以前に収集されたカバレッジ統計を消去する

--カバーテスト
カバレッジ レポートにテスト モジュールを含める [NOSE_COVER_TESTS]

--cover-min-percentage=デフォルト
テストに合格するためのカバレッジの最小パーセンテージ [NOSE_COVER_MIN_PERCENTAGE]

--カバー込み
作業ディレクトリの下にあるすべての python ファイルをカバレッジ レポートに含めます。 に便利
すべてのファイルがテスト スイートによってインポートされない場合、テスト カバレッジの穴を発見します。
[NOSE_COVER_INCLUSIVE]

--カバー-html
HTML カバレッジ情報を生成する

--cover-html-dir=DIR
dir に HTML カバレッジ情報を生成する

--カバーブランチ
カバレッジ レポートにブランチ カバレッジを含める [NOSE_COVER_BRANCHES]

--cover-xml
XML カバレッジ情報を生成する

--cover-xml-file=ファイル
XML カバレッジ情報をファイルに生成する

--pdb 失敗またはエラー時にデバッガーにドロップする

--pdb-失敗
失敗時にデバッガーにドロップ

--pdb-エラー
エラー時にデバッガーにドロップ

-- 非推奨
DeprecatedTest 例外の特別な処理を無効にします。

--with-doctest
プラグイン Doctest を有効にする: doctest プラグインを有効にして、非テストで doctest を見つけて実行します
モジュール。
[NOSE_WITH_DOCTEST]

--doctest-テスト
また、テスト モジュールで doctest を探します。 クラス、メソッド、および関数に注意してください
doctest または非 doctest テストのいずれかを含める必要があります。両方を含めることはできません。 [NOSE_DOCTEST_TESTS]

--doctest-extension=EXT
また、この拡張子 [NOSE_DOCTEST_EXTENSION] を持つファイルで doctest を探します。

--doctest-結果変数=VAR
変数名セットを、最後のインタープリター コマンドの結果に変更します。
デフォルト '_'。 テキストに使用される _() 関数との競合を回避するために使用できます
翻訳。 [NOSE_DOCTEST_RESULT_VAR]

--doctest-fixtures=サフィックス
この名前がベース名に追加されたモジュール内の doctest ファイルのフィクスチャを検索します
doctest ファイルの

--doctest-options=オプション
doctest に渡すオプションを指定します。 例えば。 '+省略記号,+NORMALIZE_WHITESPACE'

--分離あり
プラグインを有効にする IsolationPlugin: 分離プラグインを有効にして、変更を分離します。
外部モジュールを単一のテスト モジュールまたはパッケージに。 分離プラグインがリセットされます
各テスト モジュールまたはパッケージがその状態まで実行された後の sys.modules の内容
テスト前。 このプラグインはカバレッジで使用しないでください。
プラグイン、またはモジュールのリロードが望ましくない結果をもたらす可能性があるその他の場合
副作用。
[NOSE_WITH_ISOLATION]

-NS、 -- 詳細なエラー、 --失敗詳細
失敗したアサーションの評価を試みて、エラー出力に詳細を追加します
[NOSE_DETAILED_ERRORS]

--プロファイル付き
プラグイン プロファイルを有効にする: このプラグインを使用して、hotshot プロファイラーを使用してテストを実行します。
[NOSE_WITH_PROFILE]

--profile-sort=SORT
プロファイラー出力の並べ替え順序を設定する

--profile-stats-file=ファイル
プロファイラー統計ファイル。 デフォルトは、実行ごとに新しい一時ファイルです

--profile-restrict=制限
プロファイラーの出力を制限します。 詳細については、pstats.Stats のヘルプを参照してください

-スキップしない
SkipTest 例外の特別な処理を無効にします。

--id付き
プラグイン TestId を有効にする: アクティブ化して、テスト ID (#1 など) を各テスト名出力に追加します。
--failed を指定してアクティブ化すると、失敗したテストのみが再実行されます。
[NOSE_WITH_ID]

--id-file=ファイル
テスト実行で見つかったテスト ID をこのファイルに保存します。 デフォルトは、
作業ディレクトリ。

- 失敗した
前回のテスト実行で失敗したテストを実行します。

--プロセス=NUM
この多数のプロセス間でテスト実行を広げます。 の数に等しい数を設定します
最良の結果を得るには、マシンのプロセッサまたはコア。 に負の数を渡す
プロセス数がコア数に自動的に設定されます。 0を渡す
並列テストを無効にすることを意味します。 NOSE_PROCESSES が設定されていない限り、デフォルトは 0 です。
[NOSE_PROCESSES]

--プロセスタイムアウト=秒
各テスト ランナー プロセスから結果が返されるまでのタイムアウトを設定します。 デフォルトは 10 です。
[NOSE_PROCESS_TIMEOUT]

--プロセス再起動ワーカー
設定されている場合、テストが完了すると各ワーカー プロセスが再起動されます。
システムを強制終了することによるメモリリークを制御します。 [NOSE_PROCESS_RESTARTWORKER]

--with-xunit
プラグイン Xunit を有効にする: このプラグインは、標準の XUnit XML でテスト結果を提供します
フォーマット。 [NOSE_WITH_XUNIT]

--xunit-file=ファイル
xunit レポートを格納する xml ファイルへのパス。デフォルトは、
作業ディレクトリ [NOSE_XUNIT_FILE]

--xunit-testsuite-name=パッケージ
プラグインによって生成された xunit xml 内のテストスイートの名前。 デフォルトのテスト スイート
名前はノーズテストです。

--all-モジュール
プラグイン AllModules を有効にする: すべての Python モジュールからテストを収集します。
[NOSE_ALL_MODULES]

-収集のみ
収集のみを有効にする: テスト名のみを収集して出力し、テストを実行しません。
[収集のみ]

onworks.net サービスを使用して、nosetests-2.7 をオンラインで使用する