pythogen 0.0.31

Generator of python HTTP-clients from OpenApi specification.

Pythogen

Generator of python HTTP-clients from OpenApi specification based on httpx and pydantic.

---

Features

• Discriminator
• Sync and async clients
• Tracing
• Metrics

Examples

• Petstore OpenAPI: client_sync.py | client_async.py

Installation

pip install pythogen

Usage

Generate ordinary clients

• Asynchronous client

  pythogen path/to/input/openapi.yaml path/to/output/client.py
  

• Asynchronous client with integration for metrics

  pythogen path/to/input/openapi.yaml path/to/output/client.py --metrics
  

• Synchronous client

  pythogen path/to/input/openapi.yaml path/to/output/client.py --sync
  

• Synchronous client with integration for metrics

  pythogen path/to/input/openapi.yaml path/to/output/client.py --sync --metrics
  

Generate client as python-package

pythogen path/to/input/openapi.yaml path/to/package/output --package-version=0.0.1 --package-authors="Rick, Morty"

• --package-version — required;
• --package-authors — optional;
• path/to/package/output — path to the directory where package will be saved.

Usage client

from petstore.client_async import Client
from petstore.client_async import Pet
from petstore.client_async import EmptyBody

client = Client(base_url="http://your.base.url")
pets: list[Pet] | EmptyBody = await client.findPetsByStatus(status="available")

Development

• Activate environment

  rm -rf venv || true
  python3 -m venv venv
  source venv/bin/activate
  make requirements
  

• Make changes
• Execute make clients-for-tests && make test-clients
• Execute make clients-for-examples