Subscribed unsubscribe Subscribe Subscribe

oinume journal

Scratchpad of what I learned

複数バージョンのPythonでテストしてくれるtoxが便利すぎる

Testing

tomahawkPython 2.4/2.5/2.6/2.7 対応を謳っている。ただ、テストするたびに virtualenv で切り替え→テスト実行が非常に手間だった。そんなところにこのスライドtoxという複数のバージョンのPythonでテストできるツールがあることを知った。実際使ってみたところ、今までやっていた作業が完全に自動化されてウハウハになったので紹介したい。

 

toxの実行時の流れ

toxはvirtualenvを使って環境を作っては切り替えてくれる。実行時のログを見た限り、流れとしては下記のようになっているようだ。

 

 

  • テストしたいソフトウェアのディレクトリ上にtox.iniを作成

 

 

  • 該当ディレクトリで tox コマンドを実行

 

 

  • python setup.py sdist が実行される

 

 

  • tox.iniで定義された環境をvirtualenvで作成し、必要なライブラリをインストール

 

 

  • tox.ini内のcommandsでテストコマンドを実行

 

 

 

tox.ini

depsにはテストで必要なライブラリなどを書いておく。テスト対象のソフトウェアが依存しているライブラリはtoxがpipを使うので、setup.pyで依存をしっかり書いておけば自動でインストールされる。

 

[tox]

envlist = py25,py26,py27

 

[testenv]

deps=nose

commands = nosetests -sdv tests/internal

 

[testenv:py25]

basepython = /usr/local/pythonbrew/pythons/Python-2.5.6/bin/python2.5

 

[testenv:py26]

basepython = /usr/local/pythonbrew/pythons/Python-2.6.8/bin/python2.6

 

[testenv:py27]

basepython = /usr/local/pythonbrew/pythons/Python-2.7.3/bin/python2.7

 

 

toxを実行してみる

 

$ pwd

/Users/kazuhiro/work/tomahawk

$ tox

________________________________________ [tox sdist] ________________________________________

[TOX] ***creating sdist package

[TOX] /Users/kazuhiro/work/tomahawk$ /System/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python setup.py sdist --formats=zip --dist-dir .tox/dist >.tox/log/0.log

[TOX] ***copying new sdistfile to '/Users/kazuhiro/.tox/distshare/tomahawk-0.5.0.zip'

____________________________________ [tox testenv:py25] _____________________________________

[TOX] ***creating virtualenv py25

[TOX] /Users/kazuhiro/work/tomahawk/.tox$ /opt/local/pythonbrew/pythons/Python-2.5.6/bin/python2.5 /Library/Python/2.7/site-packages/virtualenv.py --distribute --no-site-packages py25 >py25/log/0.log

[TOX] ***installing dependencies: nose

[TOX] /Users/kazuhiro/work/tomahawk/.tox/py25/log$ ../bin/pip install --download-cache=/Users/kazuhiro/work/tomahawk/.tox/_download nose >1.log

[TOX] ***installing sdist

[TOX] /Users/kazuhiro/work/tomahawk/.tox/py25/log$ ../bin/pip install --download-cache=/Users/kazuhiro/work/tomahawk/.tox/_download /Users/kazuhiro/work/tomahawk/.tox/dist/tomahawk-0.5.0.zip >2.log

[TOX] /Users/kazuhiro/work/tomahawk$ .tox/py25/bin/nosetests -sdv tests/internal

test_command.test_01_execute ... ok

test_command.test_02_execute_error ... ok

test_command.test_03_execute_timeout ... ok

test_command.test_04_execute_option_host_files ... ok

test_command.test_05_execute_option_continue_on_error ... ok

test_command.test_06_execute_option_ssh_options ... ok

test_command.test_07_output_format ... ok

test_rsync.test_01_execute ... ok

test_rsync.test_02_execute_error ... ok

test_rsync.test_03_execute_timeout ... ok

test_rsync.test_04_execute_option_rsync_options ... ok

test_rsync.test_05_execute_option_mirror_mode_pull ... ok

test_rsync.test_06_execute_option_continue_on_error ... ok

 

----------------------------------------------------------------------

Ran 13 tests in 12.750s

 

OK

____________________________________ [tox testenv:py26] _____________________________________

[TOX] ***creating virtualenv py26

[TOX] /Users/kazuhiro/work/tomahawk/.tox$ /opt/local/pythonbrew/pythons/Python-2.6.8/bin/python2.6 /Library/Python/2.7/site-packages/virtualenv.py --distribute --no-site-packages py26 >py26/log/0.log

[TOX] ***installing dependencies: nose

[TOX] /Users/kazuhiro/work/tomahawk/.tox/py26/log$ ../bin/pip install --download-cache=/Users/kazuhiro/work/tomahawk/.tox/_download nose >1.log

[TOX] ***installing sdist

[TOX] /Users/kazuhiro/work/tomahawk/.tox/py26/log$ ../bin/pip install --download-cache=/Users/kazuhiro/work/tomahawk/.tox/_download /Users/kazuhiro/work/tomahawk/.tox/dist/tomahawk-0.5.0.zip >2.log

[TOX] /Users/kazuhiro/work/tomahawk$ .tox/py26/bin/nosetests -sdv tests/internal

(snip)

----------------------------------------------------------------------

Ran 13 tests in 13.355s

 

OK

____________________________________ [tox testenv:py27] _____________________________________

[TOX] ***creating virtualenv py27

[TOX] /Users/kazuhiro/work/tomahawk/.tox$ /opt/local/pythonbrew/pythons/Python-2.7.3/bin/python2.7 /Library/Python/2.7/site-packages/virtualenv.py --distribute --no-site-packages py27 >py27/log/0.log

[TOX] ***installing dependencies: nose

[TOX] /Users/kazuhiro/work/tomahawk/.tox/py27/log$ ../bin/pip install --download-cache=/Users/kazuhiro/work/tomahawk/.tox/_download nose >1.log

[TOX] ***installing sdist

[TOX] /Users/kazuhiro/work/tomahawk/.tox/py27/log$ ../bin/pip install --download-cache=/Users/kazuhiro/work/tomahawk/.tox/_download /Users/kazuhiro/work/tomahawk/.tox/dist/tomahawk-0.5.0.zip >2.log

[TOX] /Users/kazuhiro/work/tomahawk$ .tox/py27/bin/nosetests -sdv tests/internal

(snip)

----------------------------------------------------------------------

Ran 13 tests in 14.168s

 

OK

_______________________________________ [tox summary] _______________________________________

[TOX] py25: commands succeeded

[TOX] py26: commands succeeded

[TOX] py27: commands succeeded

[TOX] congratulations :)

 

 

というわけで、toxオススメです。

 

[tmkm-amazon]4798032948[/tmkm-amazon]