openapi icon indicating copy to clipboard operation
openapi copied to clipboard

Support OpenAPI v3 parameters content

Open dpgaspar opened this issue 5 years ago • 1 comments

document generation crashes with:

Exception occurred:
  File ".../venv_sphinx/lib/python3.6/site-packages/sphinxcontrib/openapi/openapi30.py", line 281, in _httpresource
    type=param['schema']['type'],
KeyError: 'schema'

since it does not seem to support parameters with content

https://swagger.io/docs/specification/describing-parameters/

dpgaspar avatar Jun 04 '20 16:06 dpgaspar

This issue does not exist in experimental new renderer.

https://github.com/sphinx-contrib/openapi/blob/227ef532eef5e8d21003ce0a77afc687c92944c3/sphinxcontrib/openapi/renderers/_httpdomain.py#L246-L250

Since current renderer is so hard to maintain and, I believe, this is not the only issue it has with following OpenAPI 3 spec, I simply luck any desire to work on this. Sorry. :(

I'll try my best to finish new renderer as soon as possible and enable it by default on next release.

ikalnytskyi avatar Jul 31 '20 18:07 ikalnytskyi