TST: Test no-file for source

numpydoc/tests/test_validate.py

@@ -41,6 +41,33 @@ def test_get_validation_checks_validity(checks):
         _ = validate.get_validation_checks(checks)
 
 
+class _DummyList(list):
+    """Dummy list class to test validation."""
+
+
+def test_no_file():
+    """Test that validation can be done on functions made on the fly."""
+    # Just a smoke test for now, <list> will have a None filename
+    validate.validate("numpydoc.tests.test_validate._DummyList.clear")
+    # This does something like decorator.FunctionMaker.make
+    src = """\
+def func():
+    '''Do something.'''
+    return 1
+"""
+    evaldict = {}
+    exec(compile(src, "<string>", "single"), evaldict)
+    func = evaldict["func"]
+    func.__source__ = src
+    func.__module__ = "numpydoc.tests.test_validate"
+    assert func() == 1
+    # This should get past the comment reading at least. A properly
+    # wrapped function *would* have source code, too. We could add such
+    # a test later
+    with pytest.raises(OSError, match="could not get source code"):
+        validate.validate(validate.get_doc_object(func))
+
+
 @pytest.mark.parametrize(
     ["file_contents", "expected"],
     [

numpydoc/validate.py

@@ -7,7 +7,7 @@
 """
 
 from copy import deepcopy
-from typing import Dict, List, Set
+from typing import Dict, List, Set, Optional
 import ast
 import collections
 import importlib
@@ -111,7 +111,9 @@
 IGNORE_COMMENT_PATTERN = re.compile("(?:.* numpydoc ignore[=|:] ?)(.+)")
 
 
-def extract_ignore_validation_comments(filepath: os.PathLike) -> Dict[int, List[str]]:
+def extract_ignore_validation_comments(
+    filepath: Optional[os.PathLike],
+) -> Dict[int, List[str]]:
     """
     Extract inline comments indicating certain validation checks should be ignored.
 
@@ -125,8 +127,12 @@ def extract_ignore_validation_comments(filepath: os.PathLike) -> Dict[int, List[
     dict[int, list[str]]
         Mapping of line number to a list of checks to ignore.
     """
-    with open(filepath) as file:
-        numpydoc_ignore_comments = {}
+    numpydoc_ignore_comments = {}
+    try:
+        file = open(filepath)
+    except (OSError, TypeError):  # can be None, nonexistent, or unreadable
+        return numpydoc_ignore_comments
+    with file:
         last_declaration = 1
         declarations = ["def", "class"]
         for token in tokenize.generate_tokens(file.readline):