sphinx icon indicating copy to clipboard operation
sphinx copied to clipboard

Option for display mode of Optional[Union].

Open Sangwon91 opened this issue 2 years ago • 1 comments

Is your feature request related to a problem? Please describe. If I use typehints like this, I get the same result as expected from the documentation.

in code:

def func(value: int | str)
    pass

in documentation:

value (int | str) - description about value.

But adding None converts it to a hard-to-read form. in code:

def func(value: int | str | None = None)
    pass

in documentation:

value (Optional[Union[int, str]]) - description about value.

I think the output should look like this.

value (int | str | None) - description about value.

Does Sphinx already have these features? If not, it would be nice if Sphinx implemented such a feature.

Sangwon91 avatar Aug 17 '22 05:08 Sangwon91

This has been implemented in the sphinx-immaterial theme:

https://jbms.github.io/sphinx-immaterial/apidoc/python/index.html#confval-python_transform_type_annotations_pep604

You might consider creating a pr to upstream that feature into sphinx itself.

jbms avatar Sep 06 '22 10:09 jbms