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.1.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for simple_openapi_client-0.5.1.tar.gz
Algorithm Hash digest
SHA256 e210f37e502806148422de3dc4879710200a3637e9a27adb341c45a5ef080f9b
MD5 866dad6441acbd355e74dd5f34aeb618
BLAKE2b-256 365dc7bc24df0f16dedbb129d843c53f9cf328a90bc58d519e654d83c9718e52

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for simple_openapi_client-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 805074d5c377f53329957e32c160a0fab075516bf9e76392028bbe04314c5cb2
MD5 e1136a2620a405e4a21d9b007add35be
BLAKE2b-256 88bc0110f4d63a861e040ba1380909a6e2d7ecaa757c3710ee1fa3ddf9ba2411

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