Add 'how to run a specific test' to the docs

Supposedly this runs a specific test:

import ipytest
ipytest.autoconfig()

def test1():
    assert 2*2 == 5
    
ipytest.config(defopts=False)
ipytest.run('{MODULE}::test1')

(btw, is there any way to pass defopts to run directly?)

and this runs a subset of tests with a certain substring in the name:

import ipytest
ipytest.autoconfig()

def test_this1():
    assert 2*2 == 11

def test_this2():
    assert 2*2 == 12
    
def test_that1():
    assert 2*2 == 21
    
def test_that2():
    assert 2*2 == 22    
    
ipytest.run('-k', 'this')

It was not obvious to figure it out 😃

I would suggest adding it to the docs.

[chmp]

Damn. Every time I think, but surely now I have seen all there is to see for IPython, there so something new. I was completely unware, that there are these hooks (for future ref: the docs). Thanks for making me aware. That would indeed be an option.

[chmp]

Hey @axil,

Thanks for these suggestions. You’re right the pytest command line arguments are definitely not obvious. Maybe something for a “tips and tricks” section with pointer into the pytest docs (my favs are “-x --pdb” or “–ff”).

Re giving the options directly: at the moment it is not possible, but I like it. Maybe having some way to specify them also via the magics would be cool. This way there is feature parity between the two ways of using ipytest.