1 new commit in pytest: https://bitbucket.org/hpk42/pytest/commits/cb8998b708a6/ Changeset: cb8998b708a6 User: hpk42 Date: 2014-07-29 12:43:04 Summary: Merged in nicoddemus/pytest/cx_freeze-docs (pull request #188)
Documentation example on how to integrate pytest and cx_freeze Affected #: 1 file diff -r 1189057a5a525222c98ceaf8d91a3e9614316409 -r cb8998b708a6ee9645a7dbc4255d7f6395623ff3 doc/en/example/simple.txt --- a/doc/en/example/simple.txt +++ b/doc/en/example/simple.txt @@ -681,3 +681,59 @@ You'll see that the fixture finalizers could use the precise reporting information. +Integrating pytest runner and cx_freeze +----------------------------------------------------------- + +If you freeze your application using a tool like +`cx_freeze <http://cx-freeze.readthedocs.org>`_ in order to distribute it +to your end-users, it is a good idea to also package your test runner and run +your tests using the frozen application. + +This way packaging errors such as dependencies not being +included into the executable can be detected early while also allowing you to +send test files to users so they can run them in their machines, which can be +invaluable to obtain more information about a hard to reproduce bug. + +Unfortunately embedding the ``pytest`` runner into a frozen executable using +``cx_freeze`` is not as straightforward as one would like, +because ``pytest`` makes heavy use of dynamic module loading which +``cx_freeze`` can't resolve by itself. + +To solve this, you have to manually include ``pytest`` and ``py`` +modules by using the ``build_exe`` option in your ``setup.py`` script, like this:: + + # contents of setup.py + from cx_Freeze import setup, Executable + + includes = [ + '_pytest.doctest', + '_pytest.unittest', + # ... lots more + ] + setup( + name="runtests", + options={"build_exe": {'includes': includes}}, + # ... other options + ) + +(For the complete list, check out the modules under ``_pytest`` in your +site-packages). + +With that, you can make your program check for a certain flag and pass control +over to ``pytest``:: + + # contents of app_main.py + import sys + + if len(sys.argv) > 1 and sys.argv[1] == '--pytest': + import pytest + sys.exit(pytest.main(sys.argv[2:])) + else: + # normal application execution: at this point argv can be parsed + # by your argument-parsing library of choice as usual + ... + +This makes it convenient to execute your tests from within your frozen +application, using standard ``py.test`` command-line:: + + $ ./app_main --pytest --verbose --tb=long --junit-xml=results.xml test-suite/ \ No newline at end of file Repository URL: https://bitbucket.org/hpk42/pytest/ -- This is a commit notification from bitbucket.org. You are receiving this because you have the service enabled, addressing the recipient of this email. _______________________________________________ pytest-commit mailing list pytest-commit@python.org https://mail.python.org/mailman/listinfo/pytest-commit
