clientele 0.2.0

Typed API Clients from OpenAPI specs

⚜️ Clientele

Typed API Clients from OpenAPI specs

Clientele lets you generate fully-typed, functional, API Clients from OpenAPI specs.

It uses modern tools to be blazing fast and type safe.

Plus - there is no complex boilerplate and the generated code is very small.

Features

• Fully typed API Client using Pydantic.
• Minimalist and easy to use - the generated code is tiny.
• Choose either sync (default) or async - we support both.
• Generates authentication code for you (curently only supports HTTP Bearer auth)
• Written entirely in Python - no need to install other languages to use OpenAPI.

We're built on:

• Pydantic 2.0
• httpx
• openapi-core

Install

poetry add clientele

Usage

From URLs

clientele generate -u http://URL_TO_OPEN_API.json -o output/

From files

clientele generate -f path/to/file.json -o output/

Async Client

clientele generate -f path/to/file.json -o output/ --asyncio t

Authentication

If your OpenAPI spec provides security information for the following authentication methods:

• HTTP Bearer

Then clientele will provide you information on the environment variables you need to set to make this work during the generation. For example:

Please set
* MY_CLIENT_AUTH_USER_KEY
* MY_CLIENT_AUTH_PASS_KEY
environment variable to use basic authentication