pdoc
pdoc copied to clipboard
:snake: :arrow_right: :scroll: Auto-generate API documentation for Python projects
### Expected Behavior pdoc3 ignores .py files without docstrings. ### Actual Behavior pdoc3 throws a UserWarning exception "Couldn't read PEP-224 variable docstrings from ..." ### Steps to Reproduce 1. run...
### Expected Behavior Markdown is parsed properly ### Actual Behavior Weird behavior happens or wrong language gets parsed ### Steps to Reproduce 1. Have a `!!! note` with a codeblock...
Pdoc3's homepage indicates the argument checking works. I took this function: ``` def mdy_to_ymd_str(mdy): """ Convert from mm/dd/yyyy datetime date string to a yyyy-mm-dd string. Args: mdy: The DateTime date...
This issue is probably the same as #30 which was closed "invalid". Here are steps to reproduce. It looks like an interaction (name collision) between "pdoc" and "pdoc3" packages. Both...
### Expected Behavior When dealing with docstrings at the module level and the class level, `pdoc3` should include the valid source code for the class in the rendered HTML, regardless...
### Expected Behavior  ### Actual Behavior  ### Steps to Reproduce Example code: ``` import documentation_test.submod1.submod1 as submod1 import documentation_test.submod2.submod2 as submod2 __all__ = ['testFunction', 'testClass'] class testClass(object): """Summary...
### Expected Behavior As per #91. It's not immediately obvious how one could generate a list of modules programmatically. It looks like your mako template changes format based on context:...