grpcurl, gRPC hizmetlerini incelemek için başvurulan komut satırı aracıdır, ancak çok sayıda bayrak içeren bir terminal komutu, bir API'yi keşfetmenin, akış çağrılarını tekrarlamanın veya bir isteği ekip arkadaşınızla paylaşmanın her zaman en hızlı yolu değildir. Eğer görsel bir gRPC istemcisi veya aynı anda birden fazla metodu çalıştıran bir araç istiyorsanız, bu kılavuz, her birinin nerede uygun olduğuna dair dürüst notlarla birlikte altı grpcurl alternatifini (GUI ve CLI) inceliyor.
grpcurl nedir ve nerede yetersiz kalır
grpcurl, gRPC için curl'dür. Bir sunucuya işaret edersiniz, bir hizmet ve metot adı verirsiniz, bir JSON istek gövdesi gönderirsiniz ve yanıtı döndürür. Sunucu yansıtmasını destekler, bu sayede bir .proto dosyası vermeden hizmetleri ve metotları listeleyebilir ve yansıtma kapalıyken TLS, meta veri başlıkları ve .proto veya protoset tanımlayıcıları ile çalışır.
Bu, birçok şeyi kapsar. Hızlı bir sağlık kontrolü veya CI'da betiklenmiş bir çağrı için grpcurl'ü geçmek zordur. İşte zorlaştığı noktalar:
- Sadece CLI'dir. Her çağrı bir komuttur ve bilmediğiniz bir API'yi keşfetmek, terminalinizde metot listelerini okumak ve JSON'u elle yazmak anlamına gelir.
- Akış hantaldır. grpcurl istemci, sunucu ve çift yönlü akış yapabilir, ancak mesajları stdin üzerinden bir JSON akışı olarak beslersiniz. Bir sunucu akışının mesaj mesaj geldiğini görsel olarak izlemenin bir yolu yoktur.
- İstekler kaydedilmez. Yerleşik bir koleksiyon, geçmiş veya ortam değiştirme yoktur. Bunu kendi başınıza kabuk betikleri veya bir not dosyası ile yönetirsiniz.
- Paylaşmak, bir komut dizesini paylaşmak demektir. Paylaşılan bir çalışma alanı, bir ekip arkadaşının açıp çalıştırabileceği kaydedilmiş örnekler yoktur.
Bunların hiçbiri grpcurl'ü kötü yapmaz. Onu dar kapsamlı bir araç yapar. İşiniz tek betiklenmiş çağrıların ötesine geçtiyse, aşağıdaki seçeneklerden biri daha iyi uyacaktır.
grpcurl alternatiflerine bir bakış
| Araç | Arayüz | Akış desteği | Yansıtma | En iyisi |
|---|---|---|---|---|
| Apidog | GUI (masaüstü) | Tekli + sunucu, istemci, çift yönlü | Evet | REST, GraphQL ve belgelerle birlikte görsel gRPC testi |
| grpcui | Web UI | Tekli + akış | Evet | grpcurl için bir tarayıcı ön ucu, aynı yazar |
| Postman | GUI (masaüstü/web) | Tekli + akış | Evet | Zaten Postman'a standartlaşmış ekipler |
| Kreya | GUI (masaüstü) | Tekli + akış | Evet | Odaklanmış bir gRPC ve REST masaüstü istemcisi |
| Evans | Etkileşimli CLI | Tekli + akış | Evet | REPL tarzı bir terminal iş akışı |
| BloomRPC | GUI (masaüstü) | Tekli + akış | Sınırlı | Sadece eski projeler (bakımı yapılmıyor) |
1. Apidog (görsel gRPC istemcisi)
Apidog, REST, GraphQL, WebSocket, SOAP ve gRPC'yi tek bir masaüstü uygulamasında ele alan bir API platformudur, böylece gRPC, ayrı bir terminalde olmak yerine diğer API işlerinizin yanında yer alır. Özellikle gRPC için, bir .proto dosyası içe aktarabilir veya sunucu yansıtması aracılığıyla bağlanabilir ve Apidog sizin için hizmet ve metot tanımlarını okur.
Buradan sonra form tabanlı bir istek oluşturucuya sahip olursunuz. Metotlar tıklanabilir bir listede görünür, istek mesajları proto şemasına dayalı düzenlenebilir alanlar olarak işlenir ve yanıtlar biçimlendirilmiş olarak geri döner. Dört gRPC çağrı türünün tamamı çalışır: tekli, sunucu akışı, istemci akışı ve çift yönlü akış. Sunucu akışı için, mesajların yanıt panelinde geldikçe belirdiğini izlersiniz ki bu, grpcurl'ün stdout'ta gözlerinizi kısmanıza neden olan kısımdır.
Dürüst kapsam: Apidog bir GUI gRPC istemcisidir, grpcurl için birebir bir CLI yedeği değildir. Gerçek ihtiyacınız bir kabuk ardışık düzenine bırakacağınız betiklenebilir bir ikili dosya ise, grpcurl veya Evans bu şekle daha yakın durur. Apidog'un kazandığı yerler keşif, kaydedilmiş istekler, uç noktalar ve meta veriler için ortam değişkenleri ve gRPC'yi diğer protokollerinizle aynı çalışma alanında tutmaktır. Birden çok protokol arasında hizmetler geliştiriyorsanız, çoklu protokol API iş akışı, tek bir araç hepsini kapsadığında daha sorunsuz olur.
Bir .proto dosyasını içe aktarmak ve ilk akış çağrınızı bir GUI'de çalıştırmak için Apidog'u indirin.
2. grpcui
grpcui, grpcurl'ün aynı yazarı olan fullstorydev'den gelir ve grpcurl'ü beğeniyor ancak görsel bir arayüz istiyorsanız doğal bir sonraki adımdır. gRPC metotlarını çağırmak için size bir tarayıcı formu sunan yerel bir web sunucusu başlatır. Hizmetler ve metotlar için açılır menüler, istek mesajları için oluşturulmuş form alanları ve meta veri girişleri elde edersiniz, hepsi sunucu yansıtması veya proto tanımlayıcıları tarafından desteklenir.
Akışı destekler ve grpcurl ailesinden bekleyeceğiniz gRPC özellik setini yansıtır. Dezavantajı, grpcui'nin tek amaçlı olmasıdır. Bir gRPC gezginidir ve başka hiçbir şey değildir, bu nedenle REST testi, oturumlar arası kaydedilmiş koleksiyonlar ve ekip çalışma alanı yoktur. Tek bir sunucunun üzerinde hızlı bir tarayıcı UI'sı istiyorsanız, bu temiz bir uyumdur. grpcui deposunda kurulum detayları bulunmaktadır.
3. Postman
Postman, gRPC desteği ekledi ve ekibiniz zaten Postman kullanıyorsa, başka bir araç eklemeden önce onu kullanmaya değer. Bir gRPC isteği oluşturursunuz, bir sunucuya işaret edersiniz, bir .proto yükler (veya yansıtmayı destekleyen bir sunucu kullanırsınız) ve Postman'ın UI'si aracılığıyla metotları çağırırsınız. Tekli ve akış çağrılarını yönetir, meta veri ve yetkilendirme ayarlamanıza olanak tanır ve istekleri diğer Postman çalışmalarınız gibi koleksiyonlara kaydeder.
Güçlü yönleri gerçek: koleksiyonlar, ortamlar ve ekibinizin zaten bildiği bir çalışma alanı. Ancak Postman'daki gRPC, tarihsel olarak REST deneyiminin cilalı seviyesinin gerisinde kalmıştır ve daha yoğun Postman hesapları, bazı ekiplerin kaçınmayı tercih edeceği bulut senkronizasyonu ve fiyatlandırma düşünceleriyle birlikte gelir. Daha geniş bir aracı düşünüyorsanız, API testi için Postman alternatifleri özetimize bakın. Postman'ın kendi gRPC dokümantasyonu mevcut özellik setini kapsar.
4. Kreya
Kreya, gRPC ve REST'e odaklanmış bir masaüstü istemcisidir. .proto dosyalarını okur ve sunucu yansıtmasını destekler, şemanızdan istek formları oluşturur ve tüm akış modlarını yönetir. Çağrıları organize ettiğiniz, ortamları ayarladığınız ve değişkenleri yeniden kullandığınız temiz, proje tabanlı bir düzene eğilir, bu da onu etrafında tam bir platform olmadan özel bir gRPC GUI istiyorsanız sağlam bir seçim yapar.
Tam bir API platformundan daha hafif bir kapsama sahiptir, bu nedenle sahte yanıtlama (mocking), dokümantasyon oluşturma veya tasarım araçları bulamazsınız. Çoğunlukla düzenli bir arayüzle gRPC hizmetlerini keşfetmesi ve test etmesi gereken geliştiriciler için bu odak, bir özellik, bir eksiklik değildir.
5. Evans
Evans, terminalinizde çalışan ancak tek seferlik bir komut yerine daha çok bir REPL gibi davranan etkileşimli bir gRPC istemcisidir. Bir oturum başlatırsınız ve Evans size paketleri, hizmetleri ve metotları gözden geçirmenize, ardından istekleri etkileşimli olarak oluşturup göndermenize olanak tanır. Sunucu yansıtmasını ve .proto dosyalarını destekler, akışı yönetir ve her bayrağı hatırlamanıza zorlamak yerine size rehberli bir istemde tutar.
grpcurl'ün terminale özgü hissini istiyor ancak uzun çağrıları tekrar yazmaktan nefret ediyorsanız, Evans bir orta yol sunar. Hala bir CLI aracıdır, bu nedenle görsel akış görünümü veya paylaşılan bir çalışma alanı yoktur, ancak etkileşimli mod grpcurl'ün birçok sürtüşmesini ortadan kaldırır. Evans GitHub deposunda kurulum talimatları bulunmaktadır.
6. BloomRPC (sadece eski projeler için)
BloomRPC bir zamanlar popüler açık kaynaklı gRPC GUI'siydi, metot gezgini ve istek düzenleyicisi olan bir masaüstü uygulamasıydı. Hala eski kılavuzlarda adı geçiyor, bu yüzden bahsetmeye değer, ancak proje artık aktif olarak sürdürülmüyor. Bu, yeni gRPC özelliklerinin, bağımlılık güncellemelerinin ve işletim sistemi uyumluluk düzeltmelerinin gelmediği anlamına gelir.
Yeni bir proje için BloomRPC'yi seçmeyin. Eğer onun etrafında inşa edilmiş bir iş akışını devraldıysanız, yukarıdaki bakımı yapılan seçeneklerden birine geçmeyi planlayın. Buraya sadece ne olduğunu ve neden artık güncel bir tavsiye olmadığını bilmeniz için ekliyoruz.
Nasıl seçilir
Aracı, çalışma şeklinize göre eşleştirin:
- İzleyebileceğiniz akışa sahip, istekleri kaydedip paylaşabileceğiniz görsel bir gRPC istemcisi istiyorsanız: Apidog.
- grpcurl'ü seviyor ve üzerine bir tarayıcı formu istiyorsanız: grpcui.
- Ekibiniz zaten Postman'a standartlaştıysa: Postman'ın gRPC desteği.
- Odaklanmış bir gRPC ve REST masaüstü istemcisi istiyorsanız: Kreya.
- Terminalde kalmak ama bayrak yorgunluğunu gidermek istiyorsanız: Evans.
- Eski bir kurulumu sürdürüyorsanız: BloomRPC'nin bakımsız olduğunu bilin ve geçiş yapmayı planlayın.
gRPC'yi uçtan uca test ediyor ve metot metot tam bir inceleme istiyorsanız, gRPC API'lerini verimli bir şekilde nasıl test edeceğinize dair kılavuzumuz iş akışını derinlemesine ele alır ve komut satırına bağlıysanız orijinal grpc-curl incelemesi doğru başlangıç noktası olmaya devam eder.
Sıkça sorulan sorular
grpcurl'ün GUI versiyonu var mı?
Aynı yazardan gelen grpcui, en yakın doğrudan GUI'dir: grpcurl'ün kullandığı aynı yansıtma ve proto işlemeyi bir tarayıcı formu üzerine yerleştirir. Kaydedilmiş istekler, ortamlar ve görsel olarak izleyebileceğiniz akış ile tam bir masaüstü uygulaması istiyorsanız, Apidog, gRPC'yi REST ve GraphQL ile birlikte tek bir istemcide kapsar.
Komut satırı olmadan gRPC akışını test edebilir miyim?
Evet. Apidog, Postman, Kreya ve grpcui'nin tümü, mesajların geldikçe işlendiği sunucu akışı dahil olmak üzere, bir UI aracılığıyla gRPC akışını destekler. grpcurl ve Evans da akış yapabilir, ancak mesajları görsel bir panel yerine terminal metni olarak besler ve görüntülerler.
Bu araçların bir .proto dosyasına ihtiyacı var mı?
Her zaman değil. Buradaki her araç gRPC sunucu yansıtmasını destekler, bu nedenle sunucunuz yansıtmayı açmışsa, istemci hizmetleri ve metotları kendi başına keşfedebilir. Yansıtma kapalıyken, bir .proto dosyası veya derlenmiş bir protoset sağlarsınız ve bu araçların çoğu her ikisini de kabul eder. Daha geniş test resmine bakıldığında, API testi nihai kılavuzu, gRPC'nin REST ve diğer protokoller arasındaki yerini açıklar.
grpcurl hala kullanmaya değer mi?
Kesinlikle, doğru iş için. grpcurl, betiklenmiş çağrılar, CI kontrolleri ve terminalden hızlı, tek seferlik çağrılar için mükemmeldir. Buradaki alternatifler, tek komutları aşıp görsel keşif, kaydedilmiş koleksiyonlar, izlenebilir akış veya paylaşılan bir ekip çalışma alanı istediğinizde önem kazanır.
Sonuç
grpcurl, komut satırı gRPC için keskin bir araçtır ve betiklenmiş, terminale özgü çağrılar için hiçbir şey onun yerini tutmaz. Değişen şey iştir. Bilmediğiniz hizmetleri keşfederken, akışları izlerken veya istekleri bir ekiple paylaşırken, görsel bir istemci size gerçek zaman kazandırır. GUI seçenekleri arasında Apidog öne çıkar çünkü gRPC, REST, GraphQL, mocking ve belgeleri tek bir yerde birleştirerek gRPC testlerinizin izole kalmamasını sağlar.
Tek bir bayrak bile yazmadan bir gRPC hizmetini test etmek ister misiniz? Apidog'u ücretsiz deneyin, .proto dosyanızı içe aktarın veya yansıtma aracılığıyla bağlanın ve tekli ve akış çağrılarını dakikalar içinde bir GUI'de çalıştırın.