{{ project_name }}

{{ description }}

Usage

First, create a client:

from {{ package_name }} import Client

client = Client(base_url="https://api.example.com")

If the endpoints you're going to hit require authentication, use AuthenticatedClient instead:

from {{ package_name }} import AuthenticatedClient

client = AuthenticatedClient(base_url="https://api.example.com", token="SuperSecretToken")

Now call your endpoint and use your models:

from {{ package_name }}.models import MyDataModel
from {{ package_name }}.api.my_tag import get_my_data_model
from {{ package_name }}.types import Response

my_data: MyDataModel = get_my_data_model.sync(client=client)
# or if you need more info (e.g. status_code)
response: Response[MyDataModel] = get_my_data_model.sync_detailed(client=client)

Or do the same thing with an async version:

from {{ package_name }}.models import MyDataModel
from {{ package_name }}.async_api.my_tag import get_my_data_model
from {{ package_name }}.types import Response

my_data: MyDataModel = await get_my_data_model.asyncio(client=client)
response: Response[MyDataModel] = await get_my_data_model.asyncio_detailed(client=client)

Things to know:

Every path/method combo becomes a Python module with four functions:
1. sync: Blocking request that returns parsed data (if successful) or None
2. sync_detailed: Blocking request that always returns a Request, optionally with parsed set if the request was successful.
3. asyncio: Like sync but the async instead of blocking
4. asyncio_detailed: Like sync_detailed by async instead of blocking
All path/query params, and bodies become method arguments.
If your endpoint had any tags on it, the first tag will be used as a module name for the function (my_tag above)
Any endpoint which did not have a tag will be in {{ package_name }}.api.default

Building / publishing this Client

This project uses Poetry to manage dependencies and packaging. Here are the basics:

Update the metadata in pyproject.toml (e.g. authors, version)
If you're using a private repository, configure it with Poetry
1. poetry config repositories.<your-repository-name> <url-to-your-repository>
2. poetry config http-basic.<your-repository-name> <username> <password>
Publish the client with poetry publish --build -r <your-repository-name> or, if for public PyPI, just poetry publish --build

If you want to install this client into another project without publishing it (e.g. for development) then:

If that project is using Poetry, you can simply do poetry add <path-to-this-client> from that project
If that project is not using Poetry:
1. Build a wheel with poetry build -f wheel
2. Install that wheel from the other project pip install <path-to-wheel>