Skip to content

gracy

247 2 1 MIT
1.34.0 (27 Nov 2024) Feb 05 2023 13.0 thousand (month)

Gracy is an API client library based on httpx that provides an extra stability layer with:

  • Retry logic
  • Logging
  • Connection throttling
  • Tracking/Middleware

In web scraping, Gracy can be a convenient tool for creating scraper based API clients.

Example Use


# 0. Import
import asyncio
from typing import Awaitable
from gracy import BaseEndpoint, Gracy, GracyConfig, LogEvent, LogLevel

# 1. Define your endpoints
class PokeApiEndpoint(BaseEndpoint):
    GET_POKEMON = "/pokemon/{NAME}" # 👈 Put placeholders as needed

# 2. Define your Graceful API
class GracefulPokeAPI(Gracy[str]):
    class Config:  # type: ignore
        BASE_URL = "https://pokeapi.co/api/v2/" # 👈 Optional BASE_URL
        # 👇 Define settings to apply for every request
        SETTINGS = GracyConfig(
          log_request=LogEvent(LogLevel.DEBUG),
          log_response=LogEvent(LogLevel.INFO, "{URL} took {ELAPSED}"),
          parser={
            "default": lambda r: r.json()
          }
        )

    async def get_pokemon(self, name: str) -> Awaitable[dict]:
        return await self.get(PokeApiEndpoint.GET_POKEMON, {"NAME": name})

    # Note: since Gracy is based on httpx we can customized the used client with custom headers etc"
    def _create_client(self) -> httpx.AsyncClient:
        client = super()._create_client()
        client.headers = {"User-Agent": f"My Scraper"} 
        return client

pokeapi = GracefulPokeAPI()

async def main():
    try:
      pokemon = await pokeapi.get_pokemon("pikachu")
      print(pokemon)

    finally:
        pokeapi.report_status("rich")


asyncio.run(main())

Alternatives / Similar


201,818 4.57.0 (2026-11-12 15:19:02 ago) Apr 01 2024 compare
65,141 2.19.0 (2026-09-10 11:14:18 ago) Jul 26 2019 compare
87,360 0.9.5 (2026-10-14 10:25:32 ago) May 01 2024 compare
102,927 0.5.1 (2026-11-04 20:29:38 ago) Aug 01 2024 compare
5,842 4.0.97 (2026-01-06 07:45:54 ago) Oct 01 2023 compare
3,099 1.6.0 (2025-07-22 06:00:53 ago) Sep 04 2013 compare
32,783 2.3.1 (2026-10-06 08:27:56 ago) Jan 15 2024 compare
8,090 1.1.14 (2022-07-17 17:20:09 ago) Jul 26 2019 compare
13,346 1.1.9 (2018-10-21 03:39:17 ago) Aug 24 2018 compare
3,411 1.6.0 (2025-02-16 13:18:50 ago) Sep 30 2018 compare
1,738 0.8.5 (2022-09-06 08:54:56 ago) Oct 17 2018 compare
3,517 0.9.13 (2023-07-19 18:53:46 ago) Jul 04 2017 compare
428 0.1.3 (2023-08-01 20:28:33 ago) Feb 20 2022 compare

Other Languages

25,597 v2.2.0 (2025-03-27 10:47:28 ago) May 14 2018 compare
17,845 v1.8.0 (2026-10-05 13:28:18 ago) Nov 07 2022 compare
7,584 v1.4.0 (2026-03-03 03:58:32 ago) Feb 15 2020 compare
2,783 2026-11-13 (2026-11-13 06:19:33 ago) Jun 06 2019 compare
716 2026-11-10 (2026-11-10 11:36:17 ago) Feb 09 2017 compare
26,447 3.18.2 (2026-11-13 21:59:55 ago) Apr 22 2022 compare
1,525 1.0.5 (2026-07-09 06:54:00 ago) Nov 22 2014 compare
4,444 2.14.2 (2026-10-26 20:34:30 ago) Jul 25 2009 compare
2,052 (2021-05-19 15:14:49 ago) Nov 20 2016 compare
6,024 v2.0.0-alpha.62 (2026-11-02 17:33:11 ago) Jul 15 compare
3,072 v2.4.0 (2026-01-08 05:29:21 ago) Jul 17 2018 compare
6,798 2.1.1 (2026-10-24 07:58:18 ago) Sep 10 2012 compare
9,168 v4.0.3 (2023-04-01 09:05:33 ago) Dec 02 2012 compare
- 2.2.0 (2026-01-27 17:36:19 ago) Aug 23 2018 compare
836 0.7.2 (2025-02-03 07:58:27 ago) Jul 25 2009 compare
1,361 3.4.0 (2026-10-27 16:48:25 ago) Dec 27 2011 compare
1,456 v3.2.1 (2025-03-21 06:53:36 ago) Dec 27 2021 compare
165 2.3.0 (2026-07-09 06:48:00 ago) Dec 22 2019 compare
589 3.0.0 (2024-04-09 15:34:59 ago) May 04 2020 compare
215 1.0.0-beta8.4 (2023-06-29 12:37:12 ago) Apr 18 2019 compare
1,339 v0.7.7 (2026-08-04 16:21:12 ago) Mar 16 2013 compare
374 v3.5.8 (2026-05-03 06:50:54 ago) Apr 18 2022 compare
Was this page helpful?