paiohttpclient 0.0.1

Easy to use python http client based on aiohttp and pydantic.

paiohttpclient

Easy to use python http client based on aiohttp and pydantic.

Examples

REST

import asyncio

import pydantic

from paiohttpclient import HttpClient


class RequestPostModel(pydantic.BaseModel):
    title: str
    body: str
    userId: int


class ResponsePostModel(pydantic.BaseModel):
    id: int
    title: str
    body: str
    userId: int


class ListOfPostsResponseModel(pydantic.BaseModel):
    __root__: list[ResponsePostModel] = []


async def main():
    api_client = HttpClient(
        "https://jsonplaceholder.typicode.com",
        common_headers={
            "Content-Type": 'application/json'
        }
    )

    request_body = RequestPostModel(title="Foo", body="Bar", userId=1)
    new_post = await api_client.post("/posts", body=request_body, response_model=ResponsePostModel)
    print(new_post.json())
    # {"id": 101, "title": "Foo", "body": "Bar", "userId": 1}

    all_posts = await api_client.get("/posts", response_model=ListOfPostsResponseModel)
    print(all_posts.json(indent=4))
    # [
    #     {
    #         "id": 1,
    #         "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
    #         "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto",
    #         "userId": 1
    #     },
    #     {
    #         "id": 2,
    #         "title": "qui est esse",
    #         "body": "est rerum tempore vitae\nsequi sint nihil reprehenderit dolor beatae ea dolores neque\nfugiat blanditiis voluptate porro vel nihil molestiae ut reiciendis\nqui aperiam non debitis possimus qui neque nisi nulla",
    #         "userId": 1
    #     },
    #     <...>
    #     {
    #         "id": 100,
    #         "title": "at nam consequatur ea labore ea harum",
    #         "body": "cupiditate quo est a modi nesciunt soluta\nipsa voluptas error itaque dicta in\nautem qui minus magnam et distinctio eum\naccusamus ratione error aut",
    #         "userId": 10
    #     }
    # ]


if __name__ == '__main__':
    asyncio.run(main())

GraphQL

import asyncio

import pydantic

from paiohttpclient import HttpClient


class Post(pydantic.BaseModel):
    id: int
    title: str
    body: str


class Posts(pydantic.BaseModel):
    __root__: list[Post] = []


class PostsData(pydantic.BaseModel):
    data: Posts


class PostsResponseData(pydantic.BaseModel):
    posts: PostsData


async def main():
    api_client = HttpClient(
        'https://graphqlzero.almansi.me',
        common_headers={
            'ContentType': 'application/json'
        }
    )

    query = """
    {
      posts {
        data {
          id
          title
          body
        }
      }
    }
    """

    response = await api_client.graphql_request(query, path='/api', data_model=PostsResponseData)
    print(response.json(indent=4))
    # {
    #   "data": {
    #     "posts": {
    #       "data": [
    #         {
    #           "id": 1,
    #           "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
    #           "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
    #         },
    #         {
    #           "id": 2,
    #           "title": "qui est esse",
    #           "body": "est rerum tempore vitae\nsequi sint nihil reprehenderit dolor beatae ea dolores neque\nfugiat blanditiis voluptate porro vel nihil molestiae ut reiciendis\nqui aperiam non debitis possimus qui neque nisi nulla"
    #         },
    #         <...>
    #         {
    #           "id": 100,
    #           "title": "at nam consequatur ea labore ea harum",
    #           "body": "cupiditate quo est a modi nesciunt soluta\nipsa voluptas error itaque dicta in\nautem qui minus magnam et distinctio eum\naccusamus ratione error aut"
    #         }
    #       ]
    #     }
    #   },
    #   "error": null
    # }


if __name__ == '__main__':
    asyncio.run(main())