Metadata-Version: 2.1
Name: openapi-parser
Version: 0.1.6
Summary: OpenAPI 3.0 specs parser and client/server generator
Home-page: https://gitlab.com/Hares-Lab/openapi-parser
License: BSD 2-Clause License
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: dataclasses-json (>=0.5.2)
Requires-Dist: functional-python (>=0.0.8)
Requires-Dist: http-server-base (>=1.8.0)
Requires-Dist: PyYAML (~=5.3.1)
Requires-Dist: stringcase (<2.0.0,==1.2.0)
Requires-Dist: tornado (>=6.0.4)
Requires-Dist: lazy-object-proxy (==1.5.1) ; python_version < "3.8"
Requires-Dist: dataclasses (>=0.7) ; python_version == "3.6"
Provides-Extra: all

# 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
```python
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:
 - [x] Model generator:
    - [x] Core functionality
    - [x] Class inheritance support
    - [x] Enums support
    - [ ] Required properties in combination with `readOnly`/`writeOnly`
    - [x] Discriminator property support
    - [ ] Cyclic refs resolution
    - [ ] Support of `additionalProperties` inside class
 - [x] Client generator
    - [x] Core functionality
    - [x] Smart body encoding
    - [x] Smart response decoding
    - [ ] `style`-encoding
    - [ ] `schema` and `content` inside parameters conflict support
    - [x] 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]

[Project Documentation]: https://hares-lab.gitlab.io/openapi-parser
[OpenAPI 3.0 Specification]: https://swagger.io/specification
[JSON Schema Standard]: https://tools.ietf.org/html/draft-wright-json-schema-validation-00


