8.13. Döngü kontrolü#

Çoğu asyncio betiği olay döngüsüne hiç doğrudan dokunmaz – asyncio.run() yeterlidir. Bu sayfa, yeterli olmadığı durumlar için Loop yüzeyini kapsar: bir istisna işleyicisi kurmak, döngüyü run‘dan farklı bir yaşam döngüsüyle çalıştırmak veya araçlandırma amacıyla döngü nesnesini elde tutmak.

8.13.1. Döngüyü elde etme#

  • asyncio.get_event_loop() – Loop nesnesini döndürür. Bir eşyordamın içinden veya dışından çağrılması güvenlidir.

  • asyncio.new_event_loop() – MicroPython’da, yeni bir döngü oluşturmak yerine mevcut döngünün durumunu sıfırlar. Bu not tekrar edilmeyi hak ediyor: her programda tam olarak bir olay döngüsü vardır.

Loop üzerindeki metotlar ve asyncio.run() dışında döngüyü çalıştırmak için bir API yoktur.

8.13.2. Döngüyü doğrudan çalıştırma#

asyncio.run() neredeyse her uygulama için doğru giriş noktasıdır. Yeterli olmadığı durumlar için iki Loop metodu vardır.

  • run_until_complete() – bir await edilebilir verildiğinde, o await edilebilir bitene kadar döngüyü çalıştırır, ardından sonucunu döndürür. Döngü söküm işlemi dışarıda bırakılmış tek bir asyncio.run() çağrısına eşdeğerdir.

  • run_forever() – döngüyü, bir görevin içinden stop() çağrılana kadar çalıştırır. Üst düzey bir await edilebilir yoktur; uygulamanın run_forever çağrılmadan önce ihtiyaç duyduğu her şeyi asyncio.create_task() aracılığıyla zamanlaması beklenir.

Eşlik eden metotlar stop() (mevcut görev bittikten sonra döngünün durmasını ister) ve close() (döngünün kaynaklarını serbest bırakır) metotlarıdır.

8.13.3. Döngü tarafında görev oluşturma#

  • create_task() – asyncio.create_task() ile aynı işlem. Bağımsız fonksiyon, uygulama kodunun yaygın durum için bir döngü referansına ihtiyaç duymaması için vardır; metot ise zaten bir referansı olan araçlandırma için vardır.

8.13.4. İstisna işleyicileri#

Döngü, bir görev eşyordam çağrı zincirinde hiçbir yerin yakalamadığı bir istisna yükselttiğinde bir işleyiciyi çağırır – tipik bir durum, uygulamanın asyncio.create_task() ile oluşturduğu ve hiç await etmediği bir görevdir. Varsayılan işleyici sys.stderr üzerinden bir izleme yazdırır; istisnalar sayfası onu özel bir şeyle nasıl değiştireceğinizi göstermişti.

  • set_exception_handler() – özel bir işleyici kurar. İşleyici, context‘in en azından 'message' ve genellikle 'exception' ile 'future' içeren bir sözlük olduğu çağrılabilir bir handler(loop, context) öğesidir.

  • get_exception_handler() – o anda kurulu olan işleyiciyi döndürür veya varsayılan kullanılıyorsa None döndürür.

  • default_exception_handler() – yerleşik işleyici. Varsayılan davranışı da çalıştırmak isteyen özel bir işleyicinin içinde kullanışlıdır (örneğin, flash belleğe günlük tutmak ve bir izleme yazdırmak).

  • call_exception_handler() – o anda kurulu olan işleyiciyi elle oluşturulmuş bir context sözlüğüyle çalıştırır. Çoğunlukla döngünün kendisi tarafından kullanılır; bir uygulamanın buna nadiren ihtiyacı olur.