Python 3: Sphinx, doğru şekilde ipuçları göstermiyor

Question

Sphinx (HTML yap) kullanarak, kendi işlevlerinin reStructuredText belgelerinden otomatik olarak bir Python 3 modülünün HTML belgelerini oluşturuyorum. Oluşturulan HTML belgeleri şu ana kadar iyi görünüyor, ancak kaynak kodunda PEP484 type hints olarak verilen işlev imzalarının parametre türleri doğru şekilde gösterilmiyor.

E.g.

static parse_from_file(filename: str) → list 
    Parses stuff from a text file. 

    Parameters: filename – the filepath of a textfile to be parsed 
    Returns:  list of parsed elements 

Bu ben gibi görünmek için ne beklenir: Bu benim işlevlerinden birinin Sfenks oluşturulan HTML doc alınan bazı örnek çıkışı

static parse_from_file(filename) 
    Parses stuff from a text file. 

    Parameters: filename (str) – the filepath of a textfile to be parsed 
    Returns:  list of parsed elements 
    Return type: list 

Bu nasıl Python kodu aslında

def parse_from_file(filename: str) -> list: 
    """Parses stuff from a text file. 

    :param filename: the filepath of a textfile to be parsed 
    :returns: list of parsed elements 
    """ 
    return [] 

nasıl Sfenks yapabilirsiniz Python 3 türü doğru ipuçlarını gösterir: benziyor?

Answer 1

sphinx-autodoc-typehints extension'u kullanarak kendi başıma hallettim.