cornice-swagger 1.0.1

Generate swagger from a Cornice application

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.

• Documentation

• Tutorial

• Issue tracker

• Live chat

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