sphinx-contrib / openapi

OpenAPI (fka Swagger) spec renderer for Sphinx.
https://sphinxcontrib-openapi.readthedocs.io
BSD 2-Clause "Simplified" License
111 stars 80 forks source link

openapi 3.0.0 improvements #125

Open CastixGitHub opened 2 years ago

CastixGitHub commented 2 years ago

openapi 3.0.0 improvements:

sommerlilie commented 2 years ago

Hey @CastixGitHub!

I would like to use your improvements in my project, but can't get it included in the conf.py properly. Could you explain how to substitute the extension with your version?

Thank you in advance, Sue

CastixGitHub commented 2 years ago

hi @sommerlilie there's no need to tweak conf.py just add 'sphinxcontrib.openapi', to the extensions.

did you set up the options from the rst source file? eg:

.. openapi:: ../specs/main.yml
   :request:
   :group:
   :examples:
CastixGitHub commented 2 years ago

also tell me if you need other authentication methods, i'll be happy to add them too

stephenfin commented 1 year ago

@CastixGitHub would you be able to rebase this and resolve the conflicts? I'd be happy to get this merged for you.