GitHub CLI ile PR Olaylarını Dinlemek: gh event listen
GitHub CLI’ın yeni olay dinleme komutu, PR durumunu tekrar tekrar sorgulayan betiklere alternatif getiriyor. Ön izleme erişimini, doğru komut biçimini ve kaçırılan olaylara karşı durum doğrulamasını ele alıyorum.
Bir pull request’in inceleme alıp almadığını öğrenmek için her birkaç saniyede bir API isteği gönderen bir betik yazdıysanız, polling yaklaşımını zaten kullanıyorsunuz. GitHub’ın 18 Kasım 2026 tarihli duyurusu, CLI tarafında bunun için yeni bir yol sunuyor: gh event listen ile olay beklemek. Özellik GitHub CLI 2.105.0 ile duyuruldu. Resmî CLI duyurusu.
İlk önemli koşul şu: Bu özellik ön izleme ve Event Streams erişimi gerektiriyor. Yalnızca CLI’ı güncellemek herkese erişim açıldığı anlamına gelmiyor. Duyuru bekleme listesine başvurulmasını istiyor.
Polling ile olay dinleme arasındaki fark
Polling’de uygulamanız düzenli aralıklarla “bir şey değişti mi?” diye sorar. Olay dinlemede bağlantı değişikliği bekler. Bu, gereksiz durum sorgularını azaltabilecek bir tasarım seçeneğidir; fakat olayın gelmesi işin başarıyla tamamlandığını tek başına kanıtlamaz.
Yeni CLI; inceleme gönderilmesi, PR durum veya head değişikliği, merge çakışması ve check suite tamamlanması gibi olayları izleyebiliyor. Varsayılan davranış ilk olaydan sonra çıkmak; --follow sürekli dinlemeyi, --count belirli sayıda olayı beklemeyi sağlıyor. Komut ailesi belgesi.

Bir inceleme olayını bekleyin
Önce sürümü ve bu ortamda kullanılan hesabı kontrol edin:
gh --version
gh auth status
Ardından kendi erişebildiğiniz deneme PR adresiyle:
gh event listen --resource https://github.com/OWNER/REPO/pull/123 --event com.github.pull_request.review.submitted.v1 --timeout 10m
OWNER/REPO ve PR numarası yer tutucudur. Komut bir inceleme geldiğinde JSON olayını standart çıktıya yazar. Süre dolarsa belgede 8 çıkış kodu tanımlanıyor. Bunu “inceleme reddedildi” şeklinde yorumlamayın; yalnızca bekleme süresi dolmuş olabilir. gh event listen kullanım belgesi.
Bu örnek, ön izleme erişimi gerektirdiği için burada canlı bir PR üzerinde çalıştırılmadı. Sözdizimi resmî CLI belgesine dayanıyor.
İnceleme geldi, ama onay geldi mi?
Bir incelemenin gönderilmesi; onay, değişiklik isteği veya yalnızca yorum gibi farklı anlamlar taşıyabilir. Dolayısıyla olaydan hemen sonra merge yapmak hatalı bir otomasyon tasarımı olur. Olayı, güncel durumu tekrar okuma işareti olarak kullanın.
Aynı ayrım testler için de geçerli. Bir PR’ın birkaç check suite’i olabilir. Bir tanesinin başarılı tamamlanması diğerlerinin bittiğini göstermez. Güncel kontrolleri ayrıca sorgulayın:
gh pr checks https://github.com/OWNER/REPO/pull/123
İşlemi gerçekleştirecek otomasyon, branch korumalarını ve zorunlu incelemeleri de dikkate almalı. Bir olay mesajı, bu kuralları aşma izni vermez.
Bağlantı kesildiğinde aradaki olaylar ne olacak?
Resmî kullanım belgesi, dinleyici bağlanmadan önceki olayların yeniden oynatılmadığını ve bağlantı kesikken oluşan olayların da teslim edilmediğini belirtiyor. Bu yüzden bir olay akışını kalıcı ve eksiksiz işlem günlüğü gibi kullanmayın.
Daha sağlam yaklaşım şu olur: dinleyiciyi bağlayın, bağlantı kurulduktan sonra PR’ın mevcut durumunu okuyun, ardından gelen olaylarla yeniden değerlendirin. Bağlantı tekrar kurulursa mevcut durumu yine uzlaştırın. Son kontrol ettiğiniz head SHA ile güncel SHA farklıysa eski test veya inceleme sonucuna dayanarak karar vermeyin.
Bu tasarım önerisi yalnızca GitHub’a özgü değil. Olaylar hızlı tepki sağlar; mevcut durum sorgusu ise kaçırılan değişikliklerden sonra doğru sonuca ulaşmaya yardım eder.
Sürekli çalışan ajanlarda sınır koyun
Dinleyiciyi sonsuza kadar açık bırakmak yerine görev için anlamlı bir zaman aşımı belirleyin. Hata tekrarlarında sınırlı yeniden deneme kullanın. Aynı PR için gereksiz sayıda abonelik açılmasını önleyin ve iş tamamlandığında kaynak kullanımını takip edin.
Gelen JSON’u loglarken ihtiyacınız olmayan verileri saklamayın. Olay türü, PR adresi, işlem zamanı ve uygulamanızın verdiği karar çoğu hata incelemesinde başlangıç için yeterlidir. Bir araç adresinden veri çekerken de kimlik bilgilerini rastgele hedeflere göndermeyin; beklenen GitHub kaynağını doğrulayın.
Yeni komut ailesi GitHub.com için ön izleme kapsamında. GitHub Enterprise Server veya GHE.com’da aynı erişimi varsaymayın. PR kavramını ve inceleme akışını yeni öğreniyorsanız önce pull request başlangıç rehberini okuyabilirsiniz.
Bu yenilik, “sürekli sor” yaklaşımından “olayı bekle, durumu doğrula” yaklaşımına geçiş için kullanışlı. Güvenilir otomasyonun son adımı yine sizin uygulamanızın güncel duruma dayanarak doğru kararı vermesi.
BİRLİKTE ÖĞRENELİM
Yorumlar
Henüz yorum yok. Düşünceni paylaşarak sohbeti başlatabilirsin.
Bir Yorum Bırak.
Katkılarını ve deneyimlerini duymak isterim. Yorumlar yayınlanmadan önce incelenir.