Technical Tutorials

Modern yazılım geliştirme ortamında, birden fazla geliştiricinin aynı kod tabanı üzerinde eş zamanlı çalışabilmesi artık bir lüks değil, standart bir beklentidir. Google Docs gibi araçlar belge düzenlemeyi devrim niteliğinde değiştirdi ve şimdi GitHub Codespaces ve Replit gibi platformlar bu işbirlikçi gücü kodlamaya da taşıyor. Peki böyle bir sistemi sıfırdan nasıl inşa ederiz? Bu kılavuzda, Python kullanarak gerçek zamanlı bir işbirlikli kod editörünün mimarisini keşfedeceğiz ve temel teknoloji olan WebSockets'a odaklanacağız.

Mimariyi Anlamak

Geleneksel web uygulamaları, durum bilgisi taşımayan (stateless) ve doğası gereği gerçek zamanlı senkronizasyon için uygun olmayan HTTP istek-yanıt döngüsüne dayanır. Eş zamanlı düzenlemeyi gerçekleştirmek için kalıcı, çift yönlü bir iletişim kanalına ihtiyacımız vardır. İşte WebSockets'ın burada parladığı yerdir. HTTP'nin aksine, bir WebSocket bağlantısı açık kalır ve sunucunun ile istemcinin verileri anında birbirine göndermesine olanak tanır.

İşbirlikçi düzenlemenin temel zorluğu, çakışma çözümüdür. İki kullanıcı aynı kod satırını tam olarak aynı anda düzenlediğinde, belgenin bozulmamasını nasıl sağlarız? Endüstri standardı çözüm, Operasyonel Dönüşüm (OT) veya Çakışmasız Dağıtılmış Veri Tipleri (CRDTs) kullanmaktır. Bu uygulamada, Python'un asyncio kütüphanesini kullanarak basitleştirilmiş bir OT yaklaşımı özetleyeceğiz.

Python Arka Uç Kurulumu

Python'da WebSocket sunucuları oluşturmak için popüler bir kütüphane olan websockets kullanacağız. Sunucumuz, bağlı istemcileri yönetmeli, odadaki diğer herkese bu istemcilerin eylemlerini yayınlamalı ve paylaşılan belge durumuna işlemleri uygulamalıdır.

WebSocket sunucumuz için temel bir yapı aşağıdadır:

import asyncio
import websockets
import json

# Paylaşılan belge durumunu sakla
document_content = ""
# WebSocket bağlantılarını kullanıcı kimliklerine eşleyen sözlük
clients = {}

async def handle_client(websocket, path):
    """Yeni bir WebSocket bağlantısını işle."""
    global document_content, clients
    
    # İstemciyi kaydet
    user_id = len(clients) + 1
    clients[websocket] = user_id
    print(f"Client {user_id} bağlandı.")
    
    # Yeni katılan kullanıcıya mevcut belge durumunu gönder
    await websocket.send(json.dumps({
        "type": "init",
        "content": document_content
    }))
    
    # Diğerlerine yeni bağlantıyı yayınla
    for client in clients:
        if client != websocket:
            await client.send(json.dumps({
                "type": "user_joined",
                "user_id": user_id
            }))

    try:
        async for message in websocket:
            data = json.loads(message)
            
            if data["type"] == "edit":
                # İşlemi belgeye uygula
                # Not: Üretim ortamında burada sağlam bir OT kütüphanesi kullanın
                document_content = apply_operation(document_content, data)
                
                # Değişikliği diğer tüm istemcilere yayınla
                for client in clients:
                    if client != websocket:
                        await client.send(json.dumps({
                            "type": "update",
                            "content": document_content
                        }))
                        
    except websockets.exceptions.ConnectionClosed:
        print(f"Client {clients[websocket]} bağlantısını kesti.")
        del clients[websocket]

def apply_operation(document, operation):
    # Gösterim için basitleştirilmiş işlem mantığı
    # Gerçek OT algoritması ile değiştirin
    return document

async def main():
    async with websockets.serve(handle_client, "localhost", 8765):
        print("Sunucu ws://localhost:8765 adresinde başlatıldı")
        await asyncio.Future()  # sonsuza kadar çalış

if __name__ == "__main__":
    asyncio.run(main())

Üretim İçin Önemli Hususlar

Yukarıdaki kod temel akışı gösterse de, üretim ortamına hazır bir editör oluşturmak birkaç kritik alanda ele alınması gereken hususlar gerektirir:

Gecikme ve Performans: Kod editörleri düşük gecikme süresi gerektirir. Her tuş vuruşundan sonra tüm belgeyi göndermek yerine, yalnızca farkları (deltas) göndermek için WebSocket mesajlarını optimize etmeliyiz.
Çakışma Çözümü: apply_operation fonksiyonu sistemin kalbidir. ot.py gibi bir kütüphane kullanmak veya CRDT'leri uygulamak, eşzamanlı düzenlemelerin kullanıcı girdisini ezmeden sorunsuz bir şekilde birleşmesini sağlar.
Güvenlik: WebSockets, site arası WebSocket hırsızlığına karşı savunmasızdır. Bir istemcinin bir işbirliği oturumuna katılmasına izin vermeden önce, el sıkışma sürecinde kimlik doğrulama belirteçlerini (JWT gibi) her zaman uygulayın ve bunları doğrulayın.
Ölçeklenebilirlik: Standart WebSocket sunucuları, bellek içi duruma dayandıkları için yatay olarak kolayca ölçeklendirilemez. Daha büyük uygulamalar için, birden fazla sunucu örneği arasında durumu senkronize etmek için Redis Pub/Sub gibi bir mesaj kuyruğu kullanmanız gerekecektir.

Sonuç

Gerçek zamanlı bir işbirlikli kod editörü oluşturmak karmaşık ancak ödüllendirici bir mühendislik meydan okumasıdır. Python ve WebSockets'tan yararlanarak, kullanıcılar arasında doğrudan bir iletişim hattı oluştururuz ve bu da modern geliştirme araçlarının ihtiyaç duyduğu akıcı, anlık güncellemeleri mümkün kılar. Yayın yapma ve durum yönetimi gibi temel kavramlar basit olsa da, gerçek güç çakışma çözümü için kullanılan karmaşık algoritmalar ve ölçeklendirme için gereken mimari kararlar yatar.

İleri adımlarda, zengin metin düzenleme deneyimini yönetmek için Monaco Editor (VS Code'da kullanılan) veya CodeMirror gibi bir ön uç kütüphanesi entegre etmeyi, Python arka ucunuzun ise senkronizasyon ve mantığın ağır işlerini üstlenmesini düşünün. İyi kodlamalar!