Maintenance. Planio will be undergoing a scheduled maintenance this weekend. Between Saturday, July 24 at 9:00 UTC and Sunday, July 25, 22:00 UTC your account might observe occasional downtimes which may last up to several minutes in some cases.
Install drf_openapi when installing pulp3
Right now, in order to have access to auto generated docs, it is necessary an extra step to install drf_openapi
pip3 install -e git+https://github.com/limdauto/drf_openapi.git@54d24fb#egg=drf_openapi
I would like to suggest this extra step to be removed, and drf_openapi be installed together with pulp.
#1 Updated by bizhang over 3 years ago
I suggest we use setuptools' extra_requires module 
Users can then install pulp like: pip install pulpcore['autodocs'] if they wish for pulpcore with autodocs, and pip install pulpcore if they do not
#7 Updated by daviddavis over 3 years ago
I also want to hear feedback on this question: should all Pulp installations ship with local API docs by default?
Seems easier to just have a central place for users to see their api schema for their particular set up rather than having to hunt down the docs online for core, plugins, etc; and then have to look up what versions of things that are being used, etc.
Are there any downsides?
#9 Updated by bizhang over 3 years ago
When I think of dependencies I think of things that pulp must have in order to run.
Tools like drf_openapi/drf_yawg is nice to have but not necessary; the schema is still available to the user when they GET /api/v3/; all this optional dependencies provide is a nice UI wrapper on top.
Please register to edit this issue