Короче ссылки между сфинксами? - PullRequest
0 голосов
/ 15 ноября 2018

Я стараюсь, чтобы мои строки документов были читаемыми, и мне тяжело с интерсфинксом и Наполеоном. У меня есть такой класс:

from long_import_path_one.long_import_path_two import Bar
from long_import_path_one.long_import_path_three import Baz
from long_import_path_one.long_import_path_four import Qux
from long_import_path_five.long_import_path_six import FooBar

class FooWithHorribleDocstrings(object):
    """
    Data flows out through the :py:class:`long_import_path_one.long_import_path_two.Bar`
    which owns a collection of :py:class:`long_import_path_one.long_import_path_three.Baz`
    objects that read from a :py:class:`long_import_path_one.long_import_path_four.Qux` 
    and post to the backend using the :py:class:`long_import_path_five.long_import_path_six.FooBar` 
    """

class FooWithCleanDocstrings(object):
    """
    Data flows out through the ``Bar`` which owns a collection of ``Baz`` objects
    that read from a ``Qux`` and post to the backend using the ``FooBar`` 
    """

Кажется глупым, что мне нужно полное имя, если я уже импортирую модули, но я не нашел способа заставить это работать. Есть предложения?

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...