Support generating HTML files for the source code

[not-my-profile]

Currently Pydoctor only supports linking the source code externally via --html-viewsource-base=URL.

It would be convenient if Pydoctor could also generate HTML files for the source code, especially for the following scenarios:

• private projects where the source code is not published online (yes you could of course set up a password protected web server or just a web server on localhost / your intranet but all of this is more effort than just having pydoctor generate the HTML)

• even if projects are planned to be published as open source, authors might want to wait with that until the alpha is finished, until that point having pydoctor generate HTML files for the source code could be useful for development

[tristanlatr]

Yes that’s a great feature to have.

[adiroiban]

Isn't there already a shared tool that can do that? Just asking.

I know that python code coverage generates annotated HTML files for the python source code :)

[tristanlatr]

Just found this: https://pydocbrowser.github.io/twisted/latest/twisted.python.htmlizer.html

[adiroiban]

what a coincidence :)