PyQIR generator documentation is incomplete about pyqir HOT 3 CLOSED

I looked around but indeed found no way to generate docs from .pyi files with Sphinx.

But I feel like this is possible from "docstrings" included in the Rust source itself.

The Fastobo project seems to have achieved this.

For instance, with the load_graph() function:

• Rust source with docstring
• Doc generation
• Resulting doc

Their conf.py file is here.

from pyqir.

@SamarSha @cgranade - What @LaurentAjdnik shows here is pretty interesting. Do you have any thoughts on this? Might be a better option than hoping sphinx adds .pyi support.

from pyqir.

Rust doc comments will get attached as Python docstrings, but I think we'll still need to duplicate the types in both the docstring and the .pyi file. I'm also not sure how it will work when referring to Mypy type aliases defined in Python.

from pyqir.