openapi-parser 0.1.5

OpenAPI 3.0 specs parser and client/server generator

OpenAPI 3.0 Parser

This package provides functionality to analyze OpenAPI 3.0 Specification files and build clients and servers from that specification.

For more details, please refer the Project Documentation

Example Usage

import yaml

from openapi_parser.exporter import PackageWriter
from openapi_parser.parser.loader import *

def main():
    with open('data/petstore.yaml') as f:
        schema = yaml.safe_load(f)

    parser = OpenApiParser(schema)
    parser.load_all()

    package_writer = PackageWriter('.code-gen/petstore')
    package_writer.write_package(parser)

    return 0

if (__name__ == '__main__'):
    exit_code = main()
    exit(exit_code)

TODOs:

• Model generator:
  • Core functionality
  • Class inheritance support
  • Enums support
  • Required properties in combination with readOnly/writeOnly
  • Discriminator property support
  • Cyclic refs resolution
  • Support of additionalProperties inside class
• Client generator
  • Core functionality
  • Smart body encoding
  • Smart response decoding
  • style-encoding
  • schema and content inside parameters conflict support
  • Enums for parameters support
  • Cookies parameters support
  • Methods descriptions
• Metadata extractor
  • Version
  • Licence
  • Description
  • Servers
• Server generator
• Test coverage
• Documentation
• Command-line interface

See Also:

• Project Documentation
• OpenAPI 3.0 Specification
• JSON Schema Standard