PyUnrunDoctestsBear: Detect doctests that are not actually run

[adtac]

    This will print "Hi"
    >>> print("Not hi")
    Hi

This will actually not fail tests because a linebreak is required between the english sentence and the doctest.

A nice security feature :)

[sils]

this should be using the AnnotationBear but not until it has been refactored by @abhsag24

[adtac]

@NiklasMM suggested PyIgnoredDoctestsBear, which I think is better :)

[aptrishu]

@sils How exactly are you suggesting to solve this with AnnotationBear ?

[sils]

@aptrishu annotationbear identifies comments right?

[aptrishu]

yup. It does.

[adtac]

@sils Still blocked?

[aptrishu]

review please :P #1332

[adtac]

Clicked on the link, it took a good 2-3 seconds to load. Immediately realized it's that PR :D

silently goes back to something else without reviewing

[jayvdb]

Another gotcha with doctest is that they are ignored in nested functions and maybe other similar obscure locations. See pyflakes tests for details.