57

In the documentation of pytest various examples for test cases are listed. Most of them show the test of functions. But I’m missing an example of how to test classes and class methods. Let’s say we have the following class in the module cool.py we like to test:

class SuperCool(object):

    def action(self, x):
        return x * x

How does the according test class in tests/test_cool.py have to look?

class TestSuperCool():

    def test_action(self, x):
        pass

How can test_action() be used to test action()?

3 Answers 3

53

All you need to do to test a class method is instantiate that class, and call the method on that instance:

def test_action(self):
    sc = SuperCool()
    assert sc.action(1) == 1
7
  • So, there is no kind of mapping involved in pytest?
    – laserbrain
    Sep 8, 2016 at 16:18
  • @laserbrain I am not sure what you mean by mapping in this case, but my example should work for you if you try it.
    – elethan
    Sep 8, 2016 at 16:19
  • I mean that the method test_action() is mapped on action(), so that no instantiation is necessary (like auto magic).
    – laserbrain
    Sep 8, 2016 at 16:21
  • 4
    @laserbrain and how this automagic would figure out what kind of assertions and checks you want to do? Explicit is better than implicit. Sep 8, 2016 at 16:22
  • @laserbrain I still don't really follow, but afaik in most cases pytest will treat a class method the same as a normal top-level function
    – elethan
    Sep 8, 2016 at 16:23
21

Well, one way is to just create your object within the test method and interact with it from there:

def test_action(self, x):
    o = SuperCool()
    assert o.action(2) == 4

You can apparently use something like the classic setup and teardown style unittest using the methods here: http://doc.pytest.org/en/latest/xunit_setup.html

I'm not 100% sure on how they are used because the documentation for pytest is terrible.

Edit: yeah so apparently if you do something like

class TestSuperCool():
    def setup(self):
        self.sc = SuperCool()

    ... 

    # test using self.sc down here
3
  • 1
    You're not wrong about the documentation; I thought I knew what I was doing until I tried writing a test suite from scratch. Sep 8, 2020 at 12:25
  • better link: docs.pytest.org/en/stable/xunit_setup.html
    – Ray Tayek
    Apr 17, 2021 at 20:12
  • how would i run this: https://github.com/diffeo/py-nilsimsa/blob/master/nilsimsa/test.py? i tried like above and got fixture self not found even tho i passed it into my test method
    – jsky
    Jul 3, 2021 at 15:39
17

I would use any fixtures only to create test environment (like database connection) or data parametrization.

If your data is relatively trivial, you can define it inside the testcase:

def test_action_without_fixtures():
    sc = SuperCool()
    sc.element = 'snow'
    sc.melt()
    assert sc.element == 'water'

Example with parametrization:

@pytest.mark.parametrize("element, expected", [('snow', 'water'), ('tin', 'solder')])
def test_action_with_parametrization(element, expected):
    sc = SuperCool()
    sc.element = element
    sc.melt()
    assert sc.element == expected

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.