Technical Tutorials

Python web geliştirme alanında hızla değişen manzarada, FastAPI yüksek performanslı ve öğrenmesi kolay API'ler oluşturmak için öne çıkan bir çerçeve olarak ortaya çıkmıştır. Sebastián Ramírez tarafından tasarlanan FastAPI, otomatik veri doğrulaması, serileştirme ve etkileşimli dokümantasyon sağlamak için modern Python tür ipuçlarından (type hints) yararlanır. Orta ve ileri düzey geliştiriciler için FastAPI'nin mimari güçlü yönlerini anlamak, ölçeklenebilir, sürdürülebilir ve sağlam arka uç hizmetleri oluşturmak açısından hayati önem taşır.

Neden FastAPI Seçmelisiniz?

FastAPI, web kısımları için Starlette ve veri doğrulaması için Pydantic üzerine inşa edilmiştir. Bu kombinasyon, Flask veya Django REST Framework gibi geleneksel çerçevelere kıyasla birkaç ayrıcalıklı avantaj sunar: 1. **Yüksek Performans**: Starlette ve Pydantic'in verimli uygulaması sayesinde NodeJS ve Go ile karşılaştırılabilir düzeydedir. 2. **Asenkron Destek**: Yüksek eşzamanlılık isteklerini işlemek için gerekli olan engelleme dışı (non-blocking) I/O işlemlerine olanak tanıyan, asenkron kod için yerel destek sağlar. 3. **Otomatik Dokümantasyon**: Swagger UI (OpenAPI 3.0) ve ReDoc'ı kutudan çıkar çıkmaz entegre eder; API testi ve dokümantasyonu için kullanıcı dostu bir arayüz sağlar. 4. **Tür Güvenliği (Type Safety)**: Python'un tür ipuçlarını kullanarak FastAPI, hataları erken aşamada yakalayabilir ve mükemmel IDE desteği sunarak çalışma zamanı hatalarını önemli ölçüde azaltabilir.

Çevrenizi Hazırlama

Koda dalmadan önce Python 3.7 veya daha yüksek bir sürümün yüklü olduğundan emin olun. Bağımlılıkları yönetmek için sanal bir ortam oluşturun ve FastAPI ile Uvicorn (bir ASGI sunucusu) yükleyin:

pip install fastapi uvicorn

Kurulum tamamlandıktan sonra ilk uç noktanızı (endpoint) oluşturmaya hazırsınız. İşte temel yönlendirme ve yanıt modellemeyi gösteren minimal bir örnek:

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):
    name: str
    price: float
    is_offer: bool = False

@app.get("/")
def read_root():
    return {"Hello": "World"}

@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

@app.post("/items/")
def create_item(item: Item):
    return {"item_name": item.name, "message": "Item created"}

Bu kod parçasında, Item sınıfı istek gövdesinin beklenen yapısını tanımlamak için Pydantic'i kullanır. FastAPI, gelen JSON verilerini bu şemaya karşı otomatik olarak doğrular. Veriler eşleşmezse (örneğin, bir float beklenen yerde bir dize sağlanırsa), FastAPI otomatik olarak detaylı bir doğrulama hatası döndürür.

Bağımlılık Enjeksiyonu: FastAPI'nin Kalbi

FastAPI'nin en güçlü özelliklerinden biri Bağımlılık Enjeksiyonu (Dependency Injection) sistemidir. Bu özellik, iş mantığınızı API uç noktalarından ayırmanıza olanak tanır; bu da daha temiz ve yeniden kullanılabilir kod yazmanızı teşvik eder. Bağımlılıklar veritabanı oturumları, kimlik doğrulama kontrolleri veya yapılandırma ayarları için kullanılabilir. Belirli kaynaklara erişmeden önce kullanıcı kimlik doğrulamasını doğrulamanız gerektiği bir senaryoyu düşünün. Kullanıcı belirtecini (token) ayıklayan ve doğrulayan bir bağımlılık fonksiyonu oluşturabilirsiniz:

from fastapi import Depends, HTTPException, status

def get_current_user(token: str = Depends(oauth2_scheme)):
    user = decode_token(token)
    if not user:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="Invalid authentication credentials",
            headers={"WWW-Authenticate": "Bearer"},
        )
    return user

@app.get("/secure-data")
def read_secure_data(current_user: User = Depends(get_current_user)):
    return {"message": f"Access granted for {current_user.username}"}

Yol işlemi (path operation) fonksiyonunda current_user: User = Depends(get_current_user) beyan ederek, FastAPI otomatik olarak get_current_user fonksiyonunu çağırır, sonucu uç noktaya iletir ve süreç sırasında ortaya çıkan herhangi bir istisnayı yönetir. Bu sayede uç nokta mantığı, temel iş gereksinimine odaklanmış kalır.

Asenkron Programlama

FastAPI hem standart hem de asenkron fonksiyonları destekler. Veritabanı sorguları veya harici API çağrıları gibi G/Ç (I/O) yoğun görevler için async def kullanılması şiddetle tavsiye edilir. Bu, sunucunun olay döngüsünü (event loop) engellemeden birden fazla isteği eşzamanlı olarak işlemesine olanak tanır.

import httpx
from fastapi import FastAPI

app = FastAPI()

@app.get("/fetch-data")
async def fetch_data():
    async with httpx.AsyncClient() as client:
        response = await client.get("https://api.example.com/data")
    return response.json()

Bu örnekte, async with bloğu HTTP istemcisinin düzgün şekilde kapatılmasını sağlarken, await yanıt beklenirken iş parçacığının engellenmesini önler.

Sonuç

FastAPI, Python web geliştirme alanında önemli bir sıçrama temsil etmektedir. Hız, kullanım kolaylığı ve otomatik doğrulama ile bağımlılık enjeksiyonu gibi güçlü özelliklerin birleşimi, onu modern REST API geliştirme için ideal bir seçenek haline getirir. Tür ipuçlarından ve asenkron programlamadan yararlanarak geliştiriciler, sadece sağlam ve güvenli olmakla kalmayan, aynı zamanda yüksek performanslı uygulamalar oluşturabilirler. İster küçük bir mikro servis ister karmaşık bir kurumsal arka uç oluşturuyor olun, FastAPI verimli bir şekilde ölçeklendirmeniz için gerekli araçları sağlar. Python projelerinizin tam potansiyelini ortaya çıkarmak için bugün tür ipuçları ve bağımlılık enjeksiyonu ile denemeler yapmaya başlayın.