kernc

Results 397 comments of kernc

I uploaded a [wheel of the current release](https://pypi.org/project/pdoc3/#files). I guess we should consider doing packaging from CI. :+1:

Ah, I see. `localhost:1234/my_module` doesn't update until `localhost:1234/my_module/file1.html` itself is visited. I investigated Python bytecode caching via [`sys.dont_write_bytecode`](https://docs.python.org/3/library/sys.html#sys.dont_write_bytecode), and that did nothing. I imagine the issue is thus: the requested...

The test tries to ensure that only the identifiers in [`__all__`](https://docs.python.org/3/tutorial/modules.html#importing-from-a-package) are exposed. Interestingly, I'm not sure where the value [`'B.B.C'`](https://github.com/pdoc3/pdoc/runs/5848844773?check_suite_focus=true#step:10:120) comes from. I'd understand `'B.C'` since that's what's nested....

What's wrong with invoking `mv` as above?

pdoc CLI usage allows for more than one module/package specified: ```bash pdoc --html mypackage1 mypackage2 ... ``` 1. Are functions returning `Union[T, List[T]]` really such a good idea?

> Generating all modules/packages to a single landing page at index.html (that then point to package_1/index.html, package_2/index.html) Then you'd have another doorway page (like the `--http` one) exhibiting a single...

I'm not convinced that running `mv`, explicitly, hopefully scripted, represents a hassle. Let's maybe leave this open for a while and see how many votes it accrues.

> Not sure I understand a use case case with multiple modules for a project, can you point to examples? One may want to specify multiple modules for various reasons...

> pdoc will create documentation in `docs/my_project`, no way to specify a direct output folder. You can create and commit the [meta-refresh file as **@rirze** recommends](https://github.com/pdoc3/pdoc/issues/55#issuecomment-614247015). You need to commit...

> Used to find subpackages, not different packages in a single project. @epogrebnyak This is [what the docs say](https://packaging.python.org/tutorials/packaging-projects/#creating-setup-py): > `packages` is a list of all Python [import packages](https://packaging.python.org/glossary/#term-import-package) that...