Посилання на метод класу в текстовій документації python

Я хочу додати посилання на метод у своєму класі з документації іншого методу того ж класу. Я хочу, щоб посилання працювало у сфінксі, переважно також у Spyder та інших середовищах розробки Python.

Я спробував кілька варіантів і знайшов лише один, який працює, але він громіздкий.

Нехай наступна структура в mymodule.py

def class MyClass():
    def foo(self):
        print 'foo'
    def bar(self):
        """This method does the same as <link to foo>"""
        print 'foo'

Я спробував такі варіанти для <link to foo>:

• : func: `foo`
• : func: `self.foo`
• : func: `MyClass.foo`
• : func: `mymodule.MyClass.foo`

Єдиним, хто ефективно створює посилання, є: func: `mymodule.MyClass.foo`, але посилання відображається як, mymodule.MyClass.foo()і я хочу посилання, яке відображається як foo()або foo.
Жоден з наведених вище варіантів не дає посилання в Spyder.

Спасибі за вашу допомогу.

Рішення, яке працює для Sphinx, полягає у додаванні до префікса посилання ~.

Відповідно до документації Sphinx щодо синтаксису перехресних посилань ,

Якщо ви додасте до вмісту префікс ~, текст посилання буде лише останнім компонентом цілі. Наприклад ~Queue.Queue.get,: py: meth: буде посилатися на Queue.Queue.get, але відображатиме лише get як текст посилання.

Тож відповідь така:

class MyClass():
    def foo(self):
        print 'foo'
    def bar(self):
        """This method does the same as :func:`~mymodule.MyClass.foo`"""
        print 'foo'

Це призводить до html, який виглядає так:, This method does the same as foo()і foo()є посиланням.

Однак зверніть увагу, що це може не відображатися в Spyder як посилання.

Якщо ви хочете вручну вказати текст посилання, ви можете використовувати:

:func:`my text <mymodule.MyClass.foo>`

Для отримання додаткової інформації перевірте перехресне посилання на об’єкти Python .

Мені здається, що вам просто потрібно додати __name__або __doc__до виразу, щоб отримати бажане.
Я все ще не впевнений, що правильно зрозумів мету

class MyClass():
    def foo(self):
        """I am the docstring of foo"""
        print 'foo'
    def bar(self):
        """This method does the same as <link to foo>"""
        print 'foo'

print
print MyClass.foo
print MyClass.foo.__name__
print MyClass.foo.__doc__
print
print MyClass.__dict__['foo']
print MyClass.__dict__['foo'].__name__
print MyClass.__dict__['foo'].__doc__

результат

<unbound method MyClass.foo>
foo
I am the docstring of foo

<function foo at 0x011C27B0>
foo
I am the docstring of foo