ENH: Add doctest_skip_parser
allowing conditional skipping of doctests
#821
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This framework is based on a DiPy pull request: dipy/dipy#105
Our first conditional doctests are needed if neither PyQt nor PySide were available in skimage.viewer, reported by @cdeil. However, both instances were actually class docstrings rather than function docstrings, which was not supported by the DiPy decorator.
Here I have generalized the framework slightly (along with updated tests for both classes and functions) and it appears now to work transparently for either case.
I believe this resolves the problem noted after the merge of #811, but @cdeil should test this to make sure.
@ahojnnes, @stefanv and other devs might want to check over current and future skipped doctests; some can probably be converted into conditionals rather than outright skips.