openapi-parser 0.1.2

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 ModelWriter
from openapi_parser.parser.loader import *


def main():
    with open('data/petshop.yaml', 'rt', encoding='utf8') as f:
        schema = yaml.safe_load(f)

    parser = OpenApiParser(schema)
    parser.load_all()
    writer = ModelWriter()

    with open('.code-gen/petshop.py', 'wt', encoding='utf8') as output:
        writer.write_model(parser, file=output)
    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
• Server generator
• Test coverage
• Documentation
• Command-line interface

See Also:

• Project Documentation
• OpenAPI 3.0 Specification
• JSON Schema Standard