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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2d17eb56e678aa2e1438561c3e83dffbed8e92fc60f0b4ae5d4f1e5fb355948c |
|
MD5 | ded40d024d6c8afd8a705b390bd196de |
|
BLAKE2b-256 | 045f5c2003677d943a00f9fe229002b219404a31b5d214cae78bb0aa1310070f |
Hashes for api_client_pydantic-2.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 43e510d2bce8d054145a99d39896c48247caebaa633d3095bbd86de86938e39a |
|
MD5 | 7b9d5dcf67e59ee7d4288ccad6a12d67 |
|
BLAKE2b-256 | 5e5df81d55b950204b3155de670baabfff64e2bcda682025d4ad6568048ab54f |