Skip to main content

OpenAPI Python client generator that follows the KISS principle.

Project description

Simple Open API Client generator

This project was made to generate a simple client (async or not) from an openapi specifications (unlike other client generators, which typically produce code that is difficult for python beginners to use). It aims to produce a single file that contains the Client class.

Notes

This project is in alpha and has probably bugs. Issues/bugfixes/additions are welcome.

Installation

$ pip install simple-openapi-client

Usage

This package is usage from a Python script. Simply load the openapi file (from local file or url) and make the client.

For instance:

from simple_openapi_client import parse_openapi, make_client, Config

config = Config(client_name='Orthanc', package_name='client')
document = parse_openapi(url_or_path='https://api.orthanc-server.com/orthanc-openapi.json')
client_str = make_client(document, config, use_black=True)

with open(f'./{config.package_name}.py', 'w') as file:
    file.write(client_str)

Or, for an async client:

from simple_openapi_client import parse_openapi, make_client, Config

config = Config(client_name='AsyncOrthanc', package_name='async_client')
document = parse_openapi(url_or_path='https://api.orthanc-server.com/orthanc-openapi.json')
client_str = make_client(document, config, async_mode=True, use_black=True)

with open(f'./{config.package_name}.py', 'w') as file:
    file.write(client_str)

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

simple_openapi_client-0.5.2.tar.gz (7.4 kB view details)

Uploaded Source

Built Distribution

simple_openapi_client-0.5.2-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file simple_openapi_client-0.5.2.tar.gz.

File metadata

  • Download URL: simple_openapi_client-0.5.2.tar.gz
  • Upload date:
  • Size: 7.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.11.4 Linux/6.4.12-200.fc38.x86_64

File hashes

Hashes for simple_openapi_client-0.5.2.tar.gz
Algorithm Hash digest
SHA256 981659149f381c538225ca153175e964829f75ecd524f7a0ea358fe9afa55b03
MD5 80ac41fa57639a66a4bbb0e81460a5c4
BLAKE2b-256 5d3adf48446226cddbc47eb8f8c0d9a820e2d49825dc1f0b06e3a07e18437685

See more details on using hashes here.

File details

Details for the file simple_openapi_client-0.5.2-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_openapi_client-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d08bc6c4005cbcf2a417f9fb0bd499e008ce68bd7bdac159f2331440ce2f0040
MD5 aedc41dd86c8671b18bce44ac9e15bda
BLAKE2b-256 6c9cac449c78793abd00c50ee157c046292a423093610be87e925049fd7615df

See more details on using hashes here.

Supported by

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