Skip to main content
File added late

1 file was added to this release more than 14 days after its initial publication. Inspect the release files before installing.

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

Release files for cornice-swagger 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

File added late

1 file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.

We recommend inspecting the release files before installing.

Source distribution (sdist)

Source distribution for cornice-swagger 1.0.1
File Size Uploaded
cornice_swagger-1.0.1.tar.gz 40.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cornice-swagger 1.0.1
File Interpreter ABI Platform
cornice_swagger-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 72.4 kB

Release files / cornice_swagger-1.0.1.tar.gz

Download URL cornice_swagger-1.0.1.tar.gz
Size 40.1 kB
Tags Source
SHA-256 checksum
How to use checksums
98a63c139af8297e8494ffa4e9f3fe8226a55b8850abb3b65ca555b25105fc34
BLAKE2b-256 checksum
How to use checksums
6f07e55351195b4f7700c5c5eb22491c15a4c05b21cc3cd40ea7683a18ef3a9c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.25.1 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.10

Release files / cornice_swagger-1.0.1-py3-none-any.whl

File added late

This file was uploaded more than 14 days after the first file in this release.

While project maintainers occasionally add legitimate files to an existing release, late additions can also indicate a security compromise.

We recommend inspecting the release file before installing.

Download URL cornice_swagger-1.0.1-py3-none-any.whl
Size 32.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
94baebb818eb79a458497b3b924aacf340af85057abfdba7faa81e20c4d59b84
BLAKE2b-256 checksum
How to use checksums
418ff6aaa20e5352ff2fe6a16678280b79688461a05fd88884b1216ab0726769
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.12

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

1 release file

0.7.0

1 release file

0.6.0

1 release file

0.5.5

1 release file

0.5.4

1 release file

0.5.3

1 release file

0.5.2

1 release file

0.5.1

1 release file

0.5.0

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.1

1 release file

0.2

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page