pdoc
pdoc copied to clipboard
:snake: :arrow_right: :scroll: Auto-generate API documentation for Python projects
### Expected Behavior Dataclass arguments/attributes should display as instance variables ### Actual Behavior Instead they appear as `static` variables ### Steps to Reproduce 1. Create a simple dataclass. e.g. ```python...
It would be nice to be able to include pages to the docs with the same menu as in the index. ### Expected Behavior ...
I am not a fluent Python programmer. I mostly use standalone .py scripts, which sometimes call functions from other .py scripts. But they are not structured into modules, projects or...
### Expected Behavior Would like to see private methods/variables in the documentation ### Actual Behavior Methods and variables that begin with "_" are excluded. ### Steps to Reproduce 1. Generate...
Hi kernc and all contributors, Addressing issues #110 and #273, I added support for reST-style docstrings, following your suggestions in #198. Additionally, in case the docformat is not explicitly specified,...
Hi! - I have a function `my_lib.my_module.my_function` - I do `from .my_module import my_function` in `my_lib/__init__.py` - I want users to access the function as `my_lib.my_function` As far as I...
I'm working on [calib3d python GitHub repository](https://github.com/ispgroupucl/calib3d) Documentation is generated with ``` pdoc calib3d -o docs/ -c latex_math=True --force --html ``` GitHub pages is configured so that documentation points to...
Where I work would like us developers to use the stricter installation protocol of only using wheels, they don't have to run arbitrary code on installation. I can't do a...
When using "from __future__ import annotations", linking of types stops working. I believe this is because the behaviour of inspect.signature changes to returning only the string form of the class...
Adapted from the pdocs [programmed recursive documentation generation](https://pdoc3.github.io/pdoc/doc/pdoc/#programmatic-usage) example, I have a script that runs the following methods: tl_util.py ```python import pdoc # documentation def pdoc_module_path(m:pdoc.Module, ext:str='.html', dir_path:str=DOCS_PATH): return os.path.join(...