Merge pull request #3517 from CheViana/fix/issue-3226-typing-completeness

Fix/issue 3226 typing completeness

Author: CoolCat467

src/trio/_tests/_check_type_completeness.json

@@ -1,44 +1,24 @@
 {
     "Darwin": [
-        "No docstring found for function \"trio._unix_pipes.FdStream.send_all\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.wait_send_all_might_not_block\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.receive_some\"",
         "No docstring found for function \"trio._unix_pipes.FdStream.close\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.aclose\"",
         "No docstring found for function \"trio._unix_pipes.FdStream.fileno\""
     ],
     "Linux": [
         "No docstring found for class \"trio._core._io_epoll._EpollStatistics\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.send_all\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.wait_send_all_might_not_block\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.receive_some\"",
         "No docstring found for function \"trio._unix_pipes.FdStream.close\"",
-        "No docstring found for function \"trio._unix_pipes.FdStream.aclose\"",
         "No docstring found for function \"trio._unix_pipes.FdStream.fileno\""
     ],
     "Windows": [],
     "all": [
         "No docstring found for class \"trio._core._run.Task\"",
         "No docstring found for class \"trio._socket.SocketType\"",
-        "No docstring found for function \"trio._highlevel_socket.SocketStream.send_all\"",
-        "No docstring found for function \"trio._highlevel_socket.SocketStream.wait_send_all_might_not_block\"",
-        "No docstring found for function \"trio._highlevel_socket.SocketStream.send_eof\"",
-        "No docstring found for function \"trio._highlevel_socket.SocketStream.receive_some\"",
-        "No docstring found for function \"trio._highlevel_socket.SocketStream.aclose\"",
         "No docstring found for function \"trio._subprocess.HasFileno.fileno\"",
         "No docstring found for class \"trio._sync.AsyncContextManagerMixin\"",
         "No docstring found for function \"trio._sync._HasAcquireRelease.acquire\"",
         "No docstring found for function \"trio._sync._HasAcquireRelease.release\"",
         "No docstring found for class \"trio._sync._LockImpl\"",
         "No docstring found for class \"trio._core._local._NoValue\"",
-        "No docstring found for class \"trio._core._local.RunVarToken\"",
-        "No docstring found for class \"trio.lowlevel.RunVarToken\"",
         "No docstring found for class \"trio.lowlevel.Task\"",
-        "No docstring found for class \"trio.socket.SocketType\"",
-        "No docstring found for class \"trio.socket.gaierror\"",
-        "No docstring found for class \"trio.socket.herror\"",
-        "No docstring found for function \"trio._core._mock_clock.MockClock.start_clock\"",
-        "No docstring found for function \"trio._core._mock_clock.MockClock.current_time\"",
-        "No docstring found for function \"trio._core._mock_clock.MockClock.deadline_to_sleep_time\""
+        "No docstring found for class \"trio.socket.SocketType\""
     ]
 }

src/trio/_tests/check_type_completeness.py

@@ -12,6 +12,7 @@
 
 # this file is not run as part of the tests, instead it's run standalone from check.sh
 import argparse
+import inspect
 import json
 import subprocess
 import sys
@@ -108,7 +109,8 @@ def has_docstring_at_runtime(name: str) -> bool:
                 file=sys.stderr,
             )
             return False
-    return bool(obj.__doc__)
+    doc = inspect.getdoc(obj)
+    return bool(doc)
 
 
 def check_type(