Модуль pydoc не отображает всю документацию для codecs.py

#python-3.x #python-2.7 #pydoc #python-3.9

#python-3.x #python-2.7 #pydoc #python-3.9

Вопрос:

Я изучал, как pydoc работает модуль в Python 3.9, и заметил, что если вы запустите сервер pydoc и перейдете к codecs.py документации модуля, там нет документации для BufferedIncrementalDecoder BufferedIncrementalEncoder классов and (см. Рисунок).

Я запускаю сервер документов со следующей командой:

 py -m pydoc -b
  

Я попытался найти онлайн-сервер pydoc для ясности, но нашел его только для Python 2.7.
Как вы можете видеть, BufferedIncrementalDecoder и BufferedIncrementalEncoder также отсутствуют, хотя они находятся в codecs.py модуль.

Чего мне здесь не хватает?

Ответ №1:

Эти два класса BufferedIncrementalDecoder и BufferedIncrementalEncoder не перечислены в __all__ последовательности в codecs.py

таким образом, pydoc он пропустит их (выбрав только для отображения документации для экспортированных имен)

Если эти два класса намеренно общедоступны, возможно, стоит отправить запрос на извлечение в cpython, чтобы добавить их в __all__ последовательность