"Have a look at this function that I'm writing... I'm sure someone else has already written it." - @kr1

Test-Driven no-Development plugin for pytest. The development status of this project is Alpha.

• Runs a set of tests over all objects contained in a list of modules.

• TODO

You can install "pytest-wish" via pip from PyPI:

$ pip install pytest-wish

The plugin adds the following options to pytest:

wish:
  --wish-dists=WISH_DISTS=[WISH_DISTS=...]
                        Space separated list of distribution specs, 'Python'
                        or 'all'.
  --wish-modules=WISH_MODULES=[WISH_MODULES=...]
                        Space separated list of module names.
  --wish-includes=WISH_INCLUDES=[WISH_INCLUDES=...]
                        Space separated list of regexs matching full object
                        names to include.
  --wish-excludes=WISH_EXCLUDES=[WISH_EXCLUDES=...]
                        Space separated list of regexs matching full object
                        names to exclude.
  --wish-predicate=WISH_PREDICATE
                        getmembers predicate full name, defaults to
                        'builtins:callable'.
  --wish-objects=WISH_OBJECTS
                        File of full object names to include.
  --wish-fail           Show wish failures.

Example usage, find a function that returns the factorial of a number:

$ py.test -vv examples/test_factorial.py --wish-modules math | grep -v xfail$
[...]
examples/test_factorial.py::test_factorial[math:factorial] XPASS
[...]

the function factorial in the module math passes the test_factorial test.

Another example, find a function that decomposes a URL into individual rfc3986 components:

$ py.test -vv examples/test_rfc3986_parse.py --wish-modules urllib.parse | grep -v xfail$
[...]
examples/test_rfc3986_parse.py::test_rfc3986_parse_basic[urllib.parse:urlparse] XPASS
examples/test_rfc3986_parse.py::test_rfc3986_parse_basic[urllib.parse:urlsplit] XPASS
[...]

the two functions urlparse and urlsplit pass the basic rfc3986 parsing test, but do not pass the more complex test_rfc3986_parse_full test.

More advanced functions are available on PyPI:

$ pip install urllib3
$ py.test -vv examples/test_rfc3986_parse.py --wish-modules urllib3 | grep -v xfail$
[...]
examples/test_rfc3986_parse.py::test_rfc3986_parse_basic[urllib3.util.url:parse_url] XPASS
examples/test_rfc3986_parse.py::test_rfc3986_parse_full[urllib3.util.url:parse_url] XPASS
[...]

now the function parse_url in the module urllib3.util.url passes both tests.

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

Distributed under the terms of the MIT license, "pytest-wish" is free and open source software

If you encounter any problems, please file an issue along with a detailed description.