⚡ Asynchronous Server Gateway (ASGI)¶

Duck comes with built-in asynchronous support right out of the box.
From custom sockets (xsockets) to full async handling, everything is designed for speed, scalability, and modern protocols 🚀

🔧 Enabling Async Handling¶

Simply add the following setting in your settings.py:

ASYNC_HANDLING = True

This single flag turns on asynchronous request handling in your app.

📝 Notes¶

✅ The default ASGI handles everything automatically – no need to modify unless you want custom behavior.
🌐 Async environment supports protocols like WebSockets and HTTP/2 natively.
🌀 While it’s recommended to define your views as async, non-async views will still work (they’re automatically converted).
⚙️ Want a different event loop? Set ASYNC_LOOP (e.g. uvloop) in your settings.

👨‍💻 Defining Async Views¶

You can define async views in two main ways:

1️⃣ Async Views as Functions¶

# views.py

async def myview(request):
    # Some async code to return HttpResponse
    ...

2️⃣ Async Views as Classes¶

# views.py

from duck.views import View

class MyView(View):
    def strictly_async(self):
        # Return True to force this view to always use async
        # (disables automatic sync → async conversion).
        ...
        
    async def run(self):
        # Some async code to return HttpResponse
        ...

✨ With Duck’s ASGI, you get true async support, seamless integration with modern protocols, and the flexibility to use function-based or class-based async views.
Start writing async today and unlock maximum performance! 🚀