Comments (2)
- Could pdoc3 have the same behavior as pdoc 0.3.2 to render the documentation for all available modules if no argument provided?
This was disabled intentionally and should remain thus at least for non---http
modes (e.g. text, HTML out and PDF modes). If you'd like to look into making specifying the module optional for --http
mode, welcome. But I suppose this won't work so well in complex Python environments as all modules will have to be loaded to fetch the docstrings (slow, error prone) and the caching mechanics have been purged (slower).
- Could pdoc3 use the default
localhost:8000
if no arguments are provided to --http?
I don't think it can be made optional for as long as the type is set to the checking function:
Lines 93 to 109 in 24a561c
There simply is no way of knowing whether the user intended a switch parameter or the next argument. That said, pdoc uses the default if simply
:
is passed to --http
, as documented.
This was introduced in stead of a flood of separate switches for as little used a feature. At the time, I thought --http :
was not too bad to type out, particularly as most command-line shells today offer readline/history (↑).
- If a module name is always required, could pdoc3 return the full URL to the specified module (see below)
More than one module can be specified. What then? It isn't that hard to click through another hyperlink. Or even just leave the tab in development open.
from pdoc.
Thanks for the feedback. I missed the shortcut on just passing :
. I think you answered all my questions and I'll close this
from pdoc.
Related Issues (20)
- Upgrade code reference warnings to errors. HOT 1
- --skip-errors flag does not work
- feature request: support for headings to organize functions
- Include html containing javascript
- Using a - in folder names prevents linking
- missing docstrings of methods HOT 3
- syntax error with match-case function HOT 1
- Incorrectly rendered Args section HOT 1
- Add GitHub Flavor Markdown support HOT 2
- Remove indentation in text template for markdown files HOT 1
- Deprecation warning for PEP224 class variable docstrings
- "x | y" does not work but "Union[x, y]" does HOT 4
- pdoc3 0.11.0 installation regression vs 0.10.0. HOT 3
- version 0.11 is not compatible with python 3.7 HOT 2
- Search function HOT 3
- Links not generated in Markdown tables HOT 1
- Cannot get search to work HOT 2
- Make it possible to ignore class members based on wildcard strings HOT 1
- setting `git_link_template` causes failures on `property` and `cached_property`
- submodule containing a function or class of the same name as the submodule won't be identified
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from pdoc.