0.15.0 (2023-07-23)

Breaking Changes

Minimum httpx version raised to 0.20

Some features of generated clients already failed at runtime when using httpx < 0.20, but now the minimum version is enforced at generation time.

Connections from clients no longer automatically close (PR #775)

Client and AuthenticatedClient now reuse an internal httpx.Client (or AsyncClient)—keeping connections open between requests. This will improve performance overall, but may cause resource leaking if clients are not closed properly. The new clients are intended to be used via context managers—though for compatibility they don't have to be used with context managers. If not using a context manager, connections will probably leak. Note that once a client is closed (by leaving the context manager), it can no longer be used—and attempting to do so will raise an exception.

APIs should now be called like:

with client as client:
    my_api.sync(client)
    another_api.sync(client)
# client is closed here and can no longer be used

Generated READMEs reflect the new syntax, but READMEs for existing generated clients should be updated manually. See this diff for inspiration.

Generated clients and models now use the newer attrs @define and field APIs

See the attrs docs for more information on how these may affect you.

Removed public attributes for Client and AuthenticatedClient

The following attributes have been removed from Client and AuthenticatedClient:

• base_url—this can now only be set via the initializer
• cookies—set at initialization or use .with_cookies()
• headers—set at initialization or use .with_headers()
• timeout—set at initialization or use .with_timeout()
• verify_ssl—this can now only be set via the initializer
• follow_redirects—this can now only be set via the initializer

The timeout param and with_timeout now take an httpx.Timeout instead of a float

AuthenticatedClient no longer inherits from Client

The API of AuthenticatedClient is still a superset of Client, but the two classes no longer share a common base class.

Features

Allow customizing the underlying httpx clients

There are many use-cases where customizing the underlying httpx client directly is necessary. Some examples are:

• Event hooks
• Proxies
• Custom authentication
• Retries

The new Client and AuthenticatedClient classes come with several methods to customize underlying clients. You can pass arbitrary arguments to httpx.Client or httpx.AsyncClient when they are constructed:

client = Client(base_url="https://api.example.com", httpx_args={"proxies": {"https://": "https://proxy.example.com"}})

The underlying clients are constructed lazily, only when needed. httpx_args are stored internally in a dictionary until the first request is made.

You can force immediate construction of an underlying client in order to edit it directly:

import httpx
from my_api import Client

client = Client(base_url="https://api.example.com")
sync_client: httpx.Client = client.get_httpx_client()
sync_client.timeout = 10
async_client = client.get_async_httpx_client()
async_client.timeout = 15

You can also completely override the underlying clients:

import httpx
from my_api import Client

client = Client(base_url="https://api.example.com")
# The params you put in here ^ are discarded when you call set_httpx_client or set_async_httpx_client
sync_client = httpx.Client(base_url="https://api.example.com", timeout=10)
client.set_httpx_client(sync_client)
async_client = httpx.AsyncClient(base_url="https://api.example.com", timeout=15)
client.set_async_httpx_client(async_client)

Clients now reuse connections between requests

This happens every time you use the same Client or AuthenticatedClient instance for multiple requests, however it is best to use a context manager (e.g., with client as client:) to ensure the client is closed properly.

Fixes

Stop showing Poetry instructions in generated READMEs when not appropriate

0.14.1

0.14.1

Fixes

• Allow parameters named "client" and "url" [#758, #762, #765]. Thanks @truenicoco & @juanber84!

0.14.0

0.14.0

Breaking Changes

• Drop support for Python 3.7, put minimum version limit on Black (#754)

Features

• Better typing (mypy) support for Unset (e.g., using if statements to check type) [#714, #752]. Thanks @taasan & @mcclurem!
• pyproject_no_poetry.toml.jinja template can be used to configure black and isort [#750, #751]. Thanks @machinehead!

0.13.4

0.13.4

Features

• support httpx 0.24 (#746)

0.13.3

0.13.3

Features

• Extend the UnexpectedStatus exception to include the response's content (#729). Thanks @expobrain!
• Added support of follow HTTP redirects (#724). Thanks @expobrain & @emann!

Fixes

• Parsing endpoint content types with semicolon separator (#727). Thanks @expobrain!
• Remove Response[] from docstring of non-detailed functions (#741). Thanks @robertschweizer!

0.13.2

0.13.2

Features

• Always generate enums with sorted members (#728). Thanks @expobrain!

Fixes

• Prevent backslashes in descriptions from breaking docstrings [#735]. Thanks @robertschweizer & @bryan-hunt! (#735)
• Respect required field in parameters included with $ref (#737). Thanks @robertschweizer!

0.13.1

0.13.1

Features

• Add http_timeout config to set timeout getting document via --url [#718]. Thanks @Kircheneer!

0.13.0

0.13.0

Breaking Changes

• run post_hooks in package directory instead of current directory if meta=none [#696, #697]. Thanks @brenmous and @wallagib!
• Treat leading underscore as a sign of invalid identifier [#703]. Thanks @maxkomarychev!

Fixes

• generated docstring for Client.get_headers function [#713]. Thanks @rtaycher!

0.12.3

0.12.3

Features

• Add raise_on_unexpected_status flag to generated Client [#593]. Thanks @JamesHinshelwood, @ramnes, @gwenshap, @theFong!
• add use_path_prefixes_for_title_model_names config option for simpler model names [#559, #560]. Thanks @rtaycher!
• Support any content type ending in +json [#706, #709]. Thanks @XioNoX and @mtovt!

0.12.2

0.12.2

Fixes

• Support Python 3.11.0 (#701)