Documentation: `setup` and `teardown` aren't mentioned

While browsing the current release docs on “xunit-style” support, specifically the usage of setup and tearing down (cleanup) of tests, I was surprised not to see setup() and teardown() mentioned. Instead, the documentation points out that for methods, one must use setup_method() and teardown_method().

I’ve always used setup() and teardown() methods for setting up and cleaning up before and after each test method in a class for production code as well as teaching Pytest.

Are those methods deprecated and shouldn’t be used? Supported by mistake? Or is it an omission in the docs? Either way the docs need to be rectified for correctness. I’m happy to provide a PR with the right path.

[nicoddemus]

Hi @alfredodeza,

Fair question.

setup and teardown work because of the nose-style support.

For example, the example below works when executing pytest, but fails with pytest -p no:nose:

class Test:

    def setup(self):
        self.x = 1

    def test_foo(self):
        assert self.x == 1

So this is a nose-idiom, not a pytest-idiom.

Perhaps we need to document setup() and teardown() more explicitly in the nose page? 🤔

[nicoddemus]

but would like to have something to correlate to Nose (couldn’t find a reference)

Not sure either, I’m not familiar with nose’s docs myself, but it certainly is supported:

# test_foo.py
class Test:

    def setup(self):
        self.x = 1

    def test_foo(self):
        assert self.x == 1

λ pip list
Package    Version
---------- -------
nose       1.3.7
pip        21.3.1
setuptools 59.6.0
wheel      0.37.1

λ nosetests test_foo.py
.
----------------------------------------------------------------------
Ran 1 test in 0.000s

OK