🚀 Feature: Native Asyncio Support for Python SDK

Aperta
#1,456 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

  • #1529 di @bhardwajparth51 — chiusa senza merge

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
38/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
python
Ambito
tooling

Direzione di ricerca

Inizia tracciando il generatore dell’SDK Python e i relativi percorsi esistenti di generazione di Client e Service, quindi esamina PR #453 e il riferimento parameterDispatchBlock di Twig menzionato nell’issue. Il lavoro è completo quando un Client espone metodi di Service sincroni e asincroni abbinati, utilizza la transizione proposta a httpx e preserva il comportamento sincrono esistente.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

🔖 Feature description

I propose implementing native asyncio support for the Python SDK using a Unified Client architecture. Instead of introducing a separate AsyncClient or a package.aio submodule (which stalled previous attempts like PR #453), asynchronous capabilities should be integrated directly into the existing Client and Service classes.

Core Implementation:

  1. A single Client object handles both workflows.
  2. Every service method is generated in a "Dual-Mode" pair directly alongside each other:
    • Synchronous: def list(self, ...):
    • Asynchronous: async def list_async(self, ...):
  3. We transition the underlying HTTP engine from requests to httpx, which natively supports both synchronous and asynchronous operations using an identical API shape, making the dual-mode generator templates trivial to maintain.
🎤 Pitch

The community has requested native Python async support for over two years (Issue #26). Implementing a unified "Dual-Mode" pattern solves the architectural friction that halted previous PRs:

  1. Maintainer Alignment: It addresses the exact feedback provided by core contributors in PR #453, who requested that async methods live alongside sync methods without requiring users to instantiate a whole new AsyncClient class.
  2. Modern Developer Experience: Frameworks like FastAPI, Starlette, and Sanic are now standard. Developers must be able to await client.users.list_async() natively without blocking the event loop or hacking together ThreadPoolExecutors.
  3. Zero Maintenance Drift: By utilizing Twig parameterDispatchBlock filters in the generator (similar to the new dual-mode C++ SDK), the synchronous and asynchronous methods are generated from the exact same spec source. They will never fall out of sync as the API evolves.
  4. 100% Backwards Compatible: Existing code using requests semantics remains totally unaffected since standard def methods will work exactly as they did before.
👀 Have you spent some time to check if this issue has been raised before?
  • I checked and didn't find similar issue
🏢 Have you read the Code of Conduct?
Lingua principale
Twig
Stelle
330
Fork
212
Merge medio
12h 3m
PR unite (30g)
131

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di appwrite/sdk-generator

Tutte le issue di appwrite/sdk-generator

Issue simili

Altre issue su DevTools

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.