<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>拡張された xUnit スタイルのセットアップフィクスチャ</title>
<link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '2.2.4.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/translations.js"></script>
<link rel="top" title="None" href="index.html" />
<link rel="up" title="py.test リファレンスドキュメント" href="apiref.html" />
<link rel="next" title="標準出力/標準エラーのキャプチャ" href="capture.html" />
<link rel="prev" title="テスト関数 (funcargs) にオブジェクトを注入" href="funcargs.html" />
</head>
<body>
<div class="related">
<h3>ナビゲーション</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="py-modindex.html" title="Pythonモジュール索引"
>モジュール</a></li>
<li class="right" >
<a href="capture.html" title="標準出力/標準エラーのキャプチャ"
accesskey="N">次へ</a> |</li>
<li class="right" >
<a href="funcargs.html" title="テスト関数 (funcargs) にオブジェクトを注入"
accesskey="P">前へ</a> |</li>
<li><a href="contents.html">pytest-2.2.4.0</a> »</li>
<li><a href="apiref.html" accesskey="U">py.test リファレンスドキュメント</a> »</li>
</ul>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="contents.html">目次</a></h3>
<ul>
<li><a class="reference internal" href="#">拡張された xUnit スタイルのセットアップフィクスチャ</a><ul>
<li><a class="reference internal" href="#setup-teardown">モジュールレベルの setup/teardown</a></li>
<li><a class="reference internal" href="#id2">クラスレベルの setup/teardown</a></li>
<li><a class="reference internal" href="#id3">メソッドや関数レベルの setup/teardown</a></li>
</ul>
</li>
</ul>
<h4>前のトピックへ</h4>
<p class="topless"><a href="funcargs.html"
title="前の章へ">テスト関数 (funcargs) にオブジェクトを注入</a></p>
<h4>次のトピックへ</h4>
<p class="topless"><a href="capture.html"
title="次の章へ">標準出力/標準エラーのキャプチャ</a></p>
<div id="searchbox" style="display: none">
<h3>クイック検索</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="検索" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
モジュール、クラス、または関数名を入力してください
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="xunit">
<span id="xunitsetup"></span><h1>拡張された xUnit スタイルのセットアップフィクスチャ<a class="headerlink" href="#xunit" title="このヘッドラインへのパーマリンク">¶</a></h1>
<p>Python、Java および他の多くの言語は <a class="reference external" href="http://en.wikipedia.org/wiki/XUnit">xUnit</a> スタイルのテストに対応しています。これはテスト関数の実行前に <tt class="docutils literal"><span class="pre">setup</span></tt> (“フィクスチャ”) メソッドを、テスト関数の実行後に <tt class="docutils literal"><span class="pre">teardown</span></tt> メソッドを呼び出す典型的なスタイルです。 <tt class="docutils literal"><span class="pre">py.test</span></tt> は、モジュール単位やクラス単位のフックを必要に応じて呼び出して処理する、より細分化された setup/teardown のモデルに対応しています。</p>
<div class="section" id="setup-teardown">
<h2>モジュールレベルの setup/teardown<a class="headerlink" href="#setup-teardown" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>1つのモジュールに複数のテスト関数やテストクラスがある場合、必要に応じて、全ての関数に対して通常1度だけ呼び出されるフィクスチャメソッドを実装できます:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="k">def</span> <span class="nf">setup_module</span><span class="p">(</span><span class="n">module</span><span class="p">):</span>
<span class="sd">""" モジュールの実行に関して任意の状態をセットアップする """</span>
<span class="k">def</span> <span class="nf">teardown_module</span><span class="p">(</span><span class="n">module</span><span class="p">):</span>
<span class="sd">""" setup_module で事前にセットアップした状態を解体する """</span>
</pre></div>
</div>
</div>
<div class="section" id="id2">
<h2>クラスレベルの setup/teardown<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>同様に、クラスの全てのテストメソッドが呼び出される前後に、クラスレベルで次のメソッドが呼ばれます:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="nd">@classmethod</span>
<span class="k">def</span> <span class="nf">setup_class</span><span class="p">(</span><span class="n">cls</span><span class="p">):</span>
<span class="sd">""" (通常はテストを含む) クラスの実行に関して任意の状態をセットアップする """</span>
<span class="nd">@classmethod</span>
<span class="k">def</span> <span class="nf">teardown_class</span><span class="p">(</span><span class="n">cls</span><span class="p">):</span>
<span class="sd">""" setup_class で事前にセットアップした状態を解体する """</span>
</pre></div>
</div>
</div>
<div class="section" id="id3">
<h2>メソッドや関数レベルの setup/teardown<a class="headerlink" href="#id3" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>同様に、それぞれのメソッド呼び出しの前後で次のメソッドが呼ばれます:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="k">def</span> <span class="nf">setup_method</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
<span class="sd">""" クラス内のメソッドの実行に関して任意の状態をセットアップする</span>
<span class="sd"> setup_method はクラスのテストメソッド単位で実行される</span>
<span class="sd"> """</span>
<span class="k">def</span> <span class="nf">teardown_method</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
<span class="sd">""" setup_method で事前にセットアップした状態を解体する """</span>
</pre></div>
</div>
<p>モジュールレベルで直接的にテスト関数を定義したいなら、次の関数もフィクスチャを実装するのに使えます:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="k">def</span> <span class="nf">setup_function</span><span class="p">(</span><span class="n">function</span><span class="p">):</span>
<span class="sd">""" 関数の実行に関して任意の状態をセットアップする</span>
<span class="sd"> モジュール内の関数単位で実行される</span>
<span class="sd"> """</span>
<span class="k">def</span> <span class="nf">teardown_function</span><span class="p">(</span><span class="n">function</span><span class="p">):</span>
<span class="sd">""" setup_function で事前にセットアップした状態を解体する """</span>
</pre></div>
</div>
<p>テストプロセスにつき複数回実行される setup/teardown の組み合わせに使えることも覚えておいてください。</p>
</div>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>ナビゲーション</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="py-modindex.html" title="Pythonモジュール索引"
>モジュール</a></li>
<li class="right" >
<a href="capture.html" title="標準出力/標準エラーのキャプチャ"
>次へ</a> |</li>
<li class="right" >
<a href="funcargs.html" title="テスト関数 (funcargs) にオブジェクトを注入"
>前へ</a> |</li>
<li><a href="contents.html">pytest-2.2.4.0</a> »</li>
<li><a href="apiref.html" >py.test リファレンスドキュメント</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2011, holger krekel et alii.
このドキュメントは <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3 で生成しました。
</div>
</body>
</html>
