DEPS: unpin numpydoc pandas-dev#39688

Author: fangchenli

environment.yml

@@ -34,7 +34,7 @@ dependencies:
   - gitdb
   - sphinx
   - sphinx-panels
-  - numpydoc < 1.2  # 2021-02-09 1.2dev breaking CI
+  - numpydoc
   - pydata-sphinx-theme
   - types-python-dateutil
   - types-PyMySQL

requirements-dev.txt

@@ -20,7 +20,7 @@ gitpython
 gitdb
 sphinx
 sphinx-panels
-numpydoc < 1.2
+numpydoc
 pydata-sphinx-theme
 types-python-dateutil
 types-PyMySQL

scripts/validate_docstrings.py

@@ -29,8 +29,9 @@
 import matplotlib
 import matplotlib.pyplot as plt
 import numpy
+from numpydoc.docscrape import get_doc_object
 from numpydoc.validate import (
-    Docstring,
+    Validator,
     validate,
 )
 
@@ -134,7 +135,15 @@ def get_api_items(api_doc_fd):
         previous_line = line
 
 
-class PandasDocstring(Docstring):
+class PandasDocstring(Validator):
+    def __init__(self, func_name: str, doc_obj):
+        self.func_name = func_name
+        super().__init__(doc_obj)
+
+    @property
+    def name(self):
+        return self.func_name
+
     @property
     def mentioned_private_classes(self):
         return [klass for klass in PRIVATE_CLASSES if klass in self.raw_doc]
@@ -218,8 +227,10 @@ def pandas_validate(func_name: str):
     dict
         Information about the docstring and the errors found.
     """
-    doc = PandasDocstring(func_name)
-    result = validate(func_name)
+    func_obj = Validator._load_obj(func_name)
+    doc_obj = get_doc_object(func_obj)
+    doc = PandasDocstring(func_name, doc_obj)
+    result = validate(doc_obj)
 
     mentioned_errs = doc.mentioned_private_classes
     if mentioned_errs: