Generate swagger from a Cornice application
Project description
Cornice Swagger
Cornice extension to generate OpenAPI/Swagger Specification
Cornice Swagger creates an OpenAPI/Swagger 2.0 compliant specification from Cornice applications maximizing the extracted documentation data from functional code, while allowing users to override some parts of the generated document.
CHANGES
1.0.1 (2021-08-30)
Take default value from missing attribute (thanks @sp-schoen)
1.0.0 (2020-03-31)
Breaking Changes
Drop Python 2 support
Internal changes
bump swagger-ui files to 3.23.11
0.7.0 (2018-07-29)
Support swagger example field on colander SchemaNode custom kwarg:
def SomeSchema(colander.MappingSchema): name = colander.SchemaNode(colander.String(), example='Mr. IceCream')
The example field is returned in the swagger spec accordingly.
0.6.0 (2018-03-28)
Add cornice_enable_openapi_view() cornice_enable_openapi_explorer() Pyramid directives to serve the API Explorer and the spec information (#79)
0.5.5 (2018-03-19)
Prevent failure with non-colander schemas (#78, thanks @ergo!)
0.5.4 (2018-02-26)
Internals
Fix return types in docstrings (#77)
0.5.3 (2018-02-14)
Pyramid compliance
Handle callables for cornice.service.Service.content_type argument. For more details, see: http://cornice.readthedocs.io/en/latest/api.html#cornice.service.Service.
0.5.2 (2017-11-07)
Internals
Add classifiers to the Python package.
0.5.1 (2017-04-10)
Pyramid compliance
Support subpaths and regex when parsing paths (#68).
Api
_extract_path_from_service, now returns the path name along with the path swagger object (#68).
0.5.0 (2017-02-14)
Api
Allow implementing a custom generator by subclassing the CorniceSwagger class (#63).
Introduced a new method CorniceSwagger.generate to generate the spec (#63).
Deprecated CorniceSwagger call method. You should now use generate (#63).
Removed deprecated generate_swagger_spec call. (#64).
Allow defining custom type converters on the CorniceSwagger class. (#65)
Internals
Fixed coveralls repeated messages on PRs. (#62).
0.4.0 (2017-01-25)
Api
Summaries from docstrings are now not included by default. You can enable them by passing summary_docstrings = True to the generator.
Trying to document multiple views on same method now raises an exception. You should ignore the unwanted ones by content type.
Raw swagger items are now recursively merged (instead of replaced) with the extracted fields.
Add support for documenting operation ids via an operation_id argument on the view or by passing a default_op_ids callable to the generator.
Add a shortcut to the generator on cornice_swagger.CorniceSwagger.
Support Cornice schema synonyms (headers and GET are the same as header and querystring).
Add support for documenting security properties via a api_security list on the view or by passing a default_security list or callable to the generator.
OpenAPI compliance
Remove invalid title field from response headers and request parameters.
Support conversion of parameter validators.
Internals
Fix default tag generator.
Fix references when using declarative schemas.
Simplify parameter converter by properly isolating body.
0.3.0 (2017-01-17)
Api
Use cornice_swagger.swagger.CorniceSwagger class to generate the swagger document rather then generate_swagger_spec.
Allow overriding extractors in the application.
Schemas are now broken into JSON pointers only if specified.
Allow documenting responses via response_schemas view attribute.
Allow documenting tags via tags view attribute or using a default_tags parameter when calling the generator.
Internals
Decouples converters from path generators.
Make considerable changes in the package organisation.
Reach 100% coverage on tests.
Documentation
Create a Sphinx documentation hosted on https://cornices.github.io/cornice.ext.swagger.
0.2.1 (2016-12-10)
Check if schema is not instantiated.
Add support for query parameter description. [ridha]
0.2 (2016-11-08)
Pypi release.
Point scaffold doc to right url.
0.1 (2016-11-05)
First release for new cornice 2.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cornice_swagger-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94baebb818eb79a458497b3b924aacf340af85057abfdba7faa81e20c4d59b84 |
|
MD5 | ec3eb6ff67d7e354b24956a2e7f8c97a |
|
BLAKE2b-256 | 418ff6aaa20e5352ff2fe6a16678280b79688461a05fd88884b1216ab0726769 |