asyncio është framework-u i Python-it për I/O të njëkohshëm duke përdorur async/await. Ai ekzekuton shumë operacione I/O në mënyrë kooperative në një fije të vetme përmes një event loop — efikase për punë I/O-bound me të lartë konkurencë (thirrje rrjeti, shërbime web) pa overhead-in e fijeve.
import asyncio
async def fetch_data(id): # an async function = a coroutine
print(f"start {id}")
await asyncio.sleep(1) # await a non-blocking I/O operation (yields control)
print(f"done {id}")
return id
asyncio.run(fetch_data(1)) # run a coroutine from sync code
Një funksion async def është një korutinë; await e ndal atë në një pikë I/O, duke lejuar event loop-in të ekzekutojë korutina të tjera ndërkohë — pastaj vazhdon kur operacioni i pritur përfundohet.
# ❌ sequential — total time ≈ 3 seconds
async def slow():
await fetch_data(1) # wait 1s
await fetch_data(2) # then wait 1s
await fetch_data(3) # then wait 1s
# ✅ concurrent — total time ≈ 1 second (all run together)
async def fast():
await asyncio.gather(fetch_data(1), fetch_data(2), fetch_data(3))
asyncio.gather ekzekuton korutina në mënyrë të njëkohshme — ndërsa njëra pret I/O, të tjerat vazhdojnë. Tre pritje 1-sekondëshe mbivendosen në ~1 sekondë gjithsej. Kjo është vlera bërthamë: mbivendosja e shumë pritjeve I/O në një fije.
Threading: OS-managed, preemptive, real threads (GIL-limited for CPU)
asyncio: single thread, COOPERATIVE — coroutines yield at `await` points
→ lighter weight (handle thousands of connections), no thread overhead,
but one CPU-heavy coroutine blocks everything (no preemption)
async def bad():
time.sleep(5) # ❌ BLOCKS the whole event loop (sync sleep)
result = heavy_compute() # ❌ CPU work freezes all coroutines
async def good():
await asyncio.sleep(5) # ✅ non-blocking
# offload CPU work to a thread/process pool
await loop.run_in_executor(None, heavy_compute)
Sepse është kooperativ dhe njëfijësh, çdo thirrje bllokuese/CPU-e rëndë ngrij të gjitha korutinën. Përdor API-t async të kapshme me await, dhe delego punën bllokuese/CPU te një ekzekutues.
✓ High-concurrency I/O: web servers (FastAPI), web scraping, many API/DB calls,
websockets, real-time apps — thousands of concurrent connections efficiently
✗ CPU-bound work — use multiprocessing instead (asyncio doesn't help)
asyncio është qasja moderne për I/O të lartë konkurence në Python, që drejton framework-ët si FastAPI dhe mundëson trajtimin efikase të mijëra lidhjesh të njëkohshme në një fije të vetme — shumë më e lehtë sesa fije-për-lidhje.
Kuptimi i korutinave, await, ekzekutimit të njëkohshëm me gather, dhe veçanërisht i rregullit kardinal (asnjëherë mos blloku event loop-in; delego punën CPU/bllokuese) është thelbësor për shkrim të Python-it asinkron përfitueshem.
Dija se kur përshtatet (I/O-bound concurrency) versus kur nuk përshtatet (CPU-bound → multiprocessing) është çelësi i përdorimit të tij efikase.