René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Consider adding `doctest.skip_if` decorator","articleBody":"# Feature or enhancement\n\nRight now there's no way to skip the whole test / class doctest. You can only skip individual statements with `# doctest: +SKIP`\n\nThis causes problems in several use-cases:\n- You have a doctest that should be skipped based on the platform\n- We have doctests that should be skipped based on a resource availability\n- Libraries might want to skip some doctests based on the Python version / any other lib version\n\nRight now we have this hack: \n\nhttps://github.com/python/cpython/blob/2e9be80c99f635c2f7761e8356b0260922d6e7a6/Lib/test/test_doctest/test_doctest.py#L727-L730\n\nhttps://github.com/python/cpython/blob/2e9be80c99f635c2f7761e8356b0260922d6e7a6/Lib/test/test_doctest/test_doctest.py#L1999-L2003\n\nhttps://github.com/python/cpython/blob/2e9be80c99f635c2f7761e8356b0260922d6e7a6/Lib/test/test_doctest/test_doctest.py#L2938-L2943\n\nHowever, this is just test functions. For library functions it would be much harder to do.\nYou have to jiggle `__doc__` attribute around.\n\nSince https://github.com/python/cpython/pull/117297 we now have correct skipped count for `doctest` + `unittest` integration.\n\nSo, I propose adding this decorator to `doctest.py`\n\n```python\ndef skip_if(condition):\n    def decorator(func):\n        if condition and HAVE_DOCSTRINGS:\n            func.__doc__ = \"\u003e\u003e\u003e pass  # doctest: +SKIP\"\n        return func\n    return decorator\n```\n\nIt will allow us skipping some tests conditionally with the proper reported results.\n\nRefs https://github.com/python/cpython/pull/116758\nCC @serhiy-storchaka and @furkanonder \n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-122935\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/sobolevn","@type":"Person","name":"sobolevn"},"datePublished":"2024-03-29T09:59:25.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":4},"url":"https://github.com/117364/cpython/issues/117364"}