Skip to main content

Swagger/OpenAPI 2.0 Parser

Project description

Build Status PyPI Docs

Prance provides parsers for Swagger/OpenAPI 2.0 API specifications in Python. It uses swagger_spec_validator to validate specifications, but additionally resolves JSON references in accordance with the Swagger spec.

Mostly the latter involves handling non-URI references; Swagger is fine with providing relative file paths, whereas JSON references require URIs at this point in time.

Usage

Command Line Interface

After installing prance, a CLI is available for validating (and resolving external references in) specs:

# Validates with resolving
$ prance validate path/to/swagger.yml

# Validates without resolving
$ prance validate --no-resolve path/to/swagger.yml

# Validates and resolves, and writes the results to output.yaml
$ prance validate -o output.yaml path/to/swagger.yml

# Fetch URL, validate and resolve.
$ prance validate http://petstore.swagger.io/v2/swagger.json
Processing "http://petstore.swagger.io/v2/swagger.json"...
 -> Resolving external references.
Validates OK as Swagger/OpenAPI 2.0!

Code

Most likely you have spec file and want to parse it:

from prance import ResolvingParser
parser = ResolvingParser('path/to/my/swagger.yaml')
parser.specification  # contains fully resolved specs as a dict

Prance also includes a non-resolving parser that does not follow JSON references, in case you prefer that.

from prance import BaseParser
parser = BaseParser('path/to/my/swagger.yaml')
parser.specification  # contains specs as a dict still containing JSON references

URLs can also be parsed:

parser = ResolvingParser('http://petstore.swagger.io/v2/swagger.json')

Largely, that’s it. There is a whole slew of utility code that you may or may not find useful, too. Look at the full documentation for details.

Setup

Use virtualenv to create a virtual environment and change to it or not, as you see fit.

Then install the requirements:

$ pip install -r requirements.txt

Documentation

After setup, run the following to generate documentation:

$ python setup.py build_sphinx

Development

Test Execution

Run the whole test suite:

$ python setup.py test

Run a single test scenario:

$ pytest tests/test_resolving_parser.py::test_basics

Run tests on multiple Python versions:

$ tox

Run tests on Python 2.7:

$ tox -e py27

A simple test coverage report is automatically generated.

License

Licensed under MITNFA (MIT +no-false-attribs) License. See the LICENSE.txt file for details.

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

prance-0.5.1.tar.gz (30.1 kB view details)

Uploaded Source

Built Distribution

prance-0.5.1-py2.py3-none-any.whl (19.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file prance-0.5.1.tar.gz.

File metadata

  • Download URL: prance-0.5.1.tar.gz
  • Upload date:
  • Size: 30.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for prance-0.5.1.tar.gz
Algorithm Hash digest
SHA256 331fb8c02a08d04fc8f89b913540075fc93b397203e4201bfbab898d65736b34
MD5 a9f902bee572f2d7dd7781ea382f6df5
BLAKE2b-256 ef6f15f2b37a6e1f83a21b276273bc80eb1b71ef2c800aa5f49b28474865801d

See more details on using hashes here.

File details

Details for the file prance-0.5.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for prance-0.5.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 20c944f13a409a182308ef4ca62d1b00ee8b28a34fd08ce4dc96addac7dbf6d1
MD5 a0b4128b94bfc13bcc6987219a6f0291
BLAKE2b-256 8bcc05999aed0a6fd00e5bf22d60cdfd20faa84caf82d62f236bc59793817f32

See more details on using hashes here.

Supported by

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