84 lines
2.4 KiB
Plaintext
84 lines
2.4 KiB
Plaintext
|
|
..
|
|
Doctest integration for modules and test files
|
|
=========================================================
|
|
|
|
モジュールやテストファイルの doctest
|
|
====================================
|
|
|
|
..
|
|
By default all files matching the ``test*.txt`` pattern will
|
|
be run through the python standard ``doctest`` module. You
|
|
can change the pattern by issuing::
|
|
|
|
デフォルトで ``test*.txt`` のパターンに一致する全てのファイルは、Python 標準の ``doctest`` モジュールで実行されます。次のようにコマンドラインでこのパターンを変更できます::
|
|
|
|
py.test --doctest-glob='*.rst'
|
|
|
|
..
|
|
on the command line. You can also trigger running of doctests
|
|
from docstrings in all python modules (including regular
|
|
python test modules)::
|
|
|
|
Python モジュール (通常 python テストモジュールを含む) の docstring からも doctest を実行できます::
|
|
|
|
py.test --doctest-modules
|
|
|
|
..
|
|
You can make these changes permanent in your project by
|
|
putting them into a pytest.ini file like this::
|
|
|
|
次のように pytest.ini にその設定を追加することで、自分のプロジェクトでそういった変更を永続化できます::
|
|
|
|
# pytest.ini の内容
|
|
[pytest]
|
|
addopts = --doctest-modules
|
|
|
|
..
|
|
If you then have a text file like this::
|
|
|
|
次のようなテキストファイルが存在して::
|
|
|
|
# example.rst の内容
|
|
|
|
hello this is a doctest
|
|
>>> x = 3
|
|
>>> x
|
|
3
|
|
|
|
..
|
|
and another like this::
|
|
|
|
他にも次のようなファイルも存在するとします::
|
|
|
|
# mymodule.py の内容
|
|
def something():
|
|
""" a doctest in a docstring
|
|
>>> something()
|
|
42
|
|
"""
|
|
return 42
|
|
|
|
..
|
|
then you can just invoke ``py.test`` without command line options::
|
|
|
|
コマンドラインオプションを指定せず ``py.test`` を実行するだけです::
|
|
|
|
$ py.test
|
|
=========================== test session starts ============================
|
|
platform linux2 -- Python 2.7.1 -- pytest-2.2.4
|
|
collecting ... collected 1 items
|
|
|
|
mymodule.py .
|
|
|
|
========================= 1 passed in 0.02 seconds =========================
|
|
|
|
..
|
|
It is possible to use fixtures using the ``getfixture`` helper::
|
|
|
|
それは ``getfixture`` ヘルパーを使ってフィクスチャを使用することが可能である::
|
|
|
|
# content of example.rst
|
|
>>> tmp = getfixture('tmpdir')
|
|
>>> ...
|