Skip to main content

Generate swagger from a Cornice application

Project description

Cornice Swagger

pypi docs slack travis master-coverage

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

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

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cornice_swagger-1.0.1.tar.gz (40.1 kB view hashes)

Uploaded Source

Built Distribution

cornice_swagger-1.0.1-py3-none-any.whl (32.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page