Generate markdown docs for a Python package composed only of bindings

[ChristopherRabotin]

Hi there,

I am trying to generate the markdown of the documentation of anise, a Rust project which has Python bindings and is available to install on pip. The Python bindings are generate via PyO3.

When I run pydoc-markdown, after installing it in the same virtual environment as the one I develop anise in, it just reports an empty page:

╰─(.venv) ⠠⠵ pydoc-markdown -m anise --render-toc          of Contents

* [anise](#anise)

<a id="anise"></a>

# anise

However, some basic Python documentation should be available, and is available within the Python interpreter:

╰─(.venv) ⠠⠵ python
Python 3.11.4 (main, Jun 28 2023, 19:51:46) [GCC] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import anise
>>> anise.__doc__
'A Python module implemented in Rust.'
>>> dir(anise)
['Aberration', 'Almanac', 'MetaAlmanac', 'MetaFile', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__', '_anise.astro', '_anise.time', '_anise.utils', 'anise']
>>> anise.Almanac.__doc__
'An Almanac contains all of the loaded SPICE and ANISE data.\n\n# Limitations\nThe stack space required depends on the maximum number of each type that can be loaded.'
>>> 

That documentation seems to also be available to Python's pydoc but it's in HTML (and my website uses mkdocs).

Is there a way for pydoc-markdown to generate to markdown for that documentation by importing all of the submodules and calling __doc__ on it instead of parsing the Python files (which is what I'm guessing it does)?

Thanks