Repository navigation
0.19.0
Features:
-
Backwards-incompatible: Refactor automatic documentation generation. At
import time, each decorator stores information under its own namespace in
the view function's_apidocattribute. Then at app init time, the
information is used to generate the docs. This allows access to init time
parameters, such as OpenAPI version or application parameters like feature
toggle flags, when generating the doc. Custom decorators storing doc in
_apidocmust adapt by storing doc under their own name (e.g.:
_apidoc['custom']), creating a doc preparation callback (e.g.:
_prepare_custom_docand appending this callback to
Blueprint._prepare_doc_cbks. (:pr:123). -
Define all possible HTTP responses as response components and automatically
document "error" responses:"Default Error"when@responseis used,
response returned by@argumentson client input error, and responses for
304, 412 and 428 when@etagis used. Also document pagination header.
(:pr:125). -
Document error response in
@paginatedecorator (:pr:126).
Bug fixes:
- Backwards-incompatible: Ensure pagination arguments are in query string.
'page'and'page_size'arguments passed in any other location are
ignored by@paginatedecorator. (:pr:127)