API Client extension for validate and transform requests / responses using pydantic.
Project description
Python API Client Pydantic Extension
Installation
pip install api-client-pydantic
Usage
The following decorators have been provided to validate request data and converting json straight to pydantic class.
from apiclient_pydantic import params_serializer, response_serializer, serialize, serialize_all_methods
# serialize incoming kwargs
@params_serializer(by_alias: bool = True, exclude_unset: bool = False, exclude_defaults: bool = False, exclude_none: bool = True)
# serialize response in pydantic class
@response_serializer(response: Optional[Type[BaseModel]] = None)
# serialize request and response data
@serialize(response: Optional[Type[BaseModel]] = None, by_alias: bool = True, exclude_unset: bool = False, exclude_defaults: bool = False, exclude_none: bool = True)
# wraps all local methods of a class with a specified decorator. default 'serialize'
@serialize_all_methods(decorator=serialize)
Usage:
-
Define the schema for your api in pydantic classes.
from pydantic import BaseModel, Field class Account(BaseModel): account_number: int = Field(alias='accountNumber') sort_code: int = Field(alias='sortCode') date_opened: datetime = Field(alias='dateOpened')
-
Add the
@response_serializer
decorator to the api client method to transform the response directly into your defined schema.@response_serializer(List[Account]) def get_accounts(): ... # or @response_serializer() def get_accounts() -> List[Account]: ...
-
Add the
@params_serializer
decorator to the api client method to translate the incoming kwargs into the required dict for the endpoint:@params_serializer(AccountHolder) def create_account(data: dict): ... # or @params_serializer() def create_account(data: AccountHolder): # data will be exactly a dict ... create_account(last_name='Smith', first_name='John') # data will be a dict {"last_name": "Smith", "first_name": "John"}
-
@serialize
- It is a combination of the two decorators@response_serializer
and@params_serializer
. -
For more convenient use, you can wrap all APIClient methods with
@serialize_all_methods
.from apiclient import APIClient from apiclient_pydantic import serialize_all_methods from typing import List from .models import Account, AccountHolder @serialize_all_methods() class MyApiClient(APIClient): def decorated_func(self, data: Account) -> Account: ... def decorated_func_holder(self, data: AccountHolder) -> List[Account]: ...
Related projects
apiclient-pydantic-generator
This code generator creates a ApiClient app from an openapi file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for api-client-pydantic-2.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2a56e09e17af6c497bebc96e336a097b887f787e652e84bfeffb1c6b9288be54 |
|
MD5 | aea85171284ab7ac2dbb20f7a137d354 |
|
BLAKE2b-256 | 0fbf4024ab85c9889932e78d81f0c4811fdff22ec60c73ef5383928c6ed371ae |
Hashes for api_client_pydantic-2.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6ac2fb04325fc8518177581487e49b669463af5bda300012b7986162304cf9b0 |
|
MD5 | a002cf5bce6c47333562a9de688b7a3b |
|
BLAKE2b-256 | d648548f13485b605b74088b1be3607b4a637d2e0b03667df349731513b0f199 |