search

NiklasRosenstein / pydoc-markdown

Create Python API documentation in Markdown format.
http://niklasrosenstein.github.io/pydoc-markdown/
Other
460 stars 105 forks source link

custom plugins support without setup: resolve by FQN #131

Closed casperdcl closed 4 years ago

casperdcl commented 4 years ago

From https://github.com/NiklasRosenstein/pydoc-markdown/issues/70#issuecomment-658705072:

Currently all plugins need to be registered as a Python entrypoint.

Afaik entrypoints can only be registered via a setup script. If that doesn't fit in your workflow now, we could maybe add a command-line option or additionally support resolving plugins by their FQN additionally to the entrypoint name. Please do open a new issue in that case though :)

While this approch is occasionally seen in other projects, I personally view "using setup.py as a plugin/extension interface" to be a hack rather than an API.

NiklasRosenstein commented 4 years ago

Hey @casperdcl can you give it a try from the develop branch? You may still need to set PYTHONPATH if your custom class can not be otherwise imported.

casperdcl commented 4 years ago

yes works