Reformat request handler docstring

This commit is contained in:
Correl Roush 2021-03-17 16:16:04 -04:00
parent 72cead3683
commit 98cbaec514

View file

@ -79,31 +79,31 @@ class OpenAPIRequestHandler(tornado.web.RequestHandler):
encountered while validating the request are translated to HTTP error encountered while validating the request are translated to HTTP error
codes: codes:
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|OpenAPI Errors |Error Code|Description | |OpenAPI Errors |Error Code|Description |
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|``PathNotFound`` |``404`` |Could not find the path for this request| |``PathNotFound`` |``404`` |Could not find the path for this |
| | |in the OpenAPI specification. | | | |request in the OpenAPI specification.|
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|``OperationNotFound`` |``405`` |Could not find the operation specified | |``OperationNotFound`` |``405`` |Could not find the operation |
| | |for this request in the OpenAPI | | | |specified for this request in the |
| | |specification. | | | |OpenAPI specification. |
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|``CastError``, |``400`` |The message body could not be decoded or| |``CastError``, |``400`` |The message body could not be decoded|
|``DeserializeError``, | |did not validate against the specified | |``DeserializeError``, | |or did not validate against the |
|``MissingRequiredParameter``,| |schema. | |``MissingRequiredParameter``,| |specified schema. |
|``MissingRequestBody``, | | | |``MissingRequestBody``, | | |
|``ValidateError`` | | | |``ValidateError`` | | |
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|``InvalidSecurity`` |``401`` |Required authorization was missing from | |``InvalidSecurity`` |``401`` |Required authorization was missing |
| | |the request. | | | |from the request. |
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|``InvalidContentType`` |``415`` |The content type of the request did not | |``InvalidContentType`` |``415`` |The content type of the request did |
| | |match any of the types in the OpenAPI | | | |not match any of the types in the |
| | |specification. | | | |OpenAPI specification. |
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
|Any other ``OpenAPIError`` |``500`` |An unexpected error occurred. | |Any other ``OpenAPIError`` |``500`` |An unexpected error occurred. |
+-----------------------------+----------+----------------------------------------+ +-----------------------------+----------+-------------------------------------+
To provide content in these error requests, you may override To provide content in these error requests, you may override
:meth:`on_openapi_error`. :meth:`on_openapi_error`.