GÜNDEMDE

DÜNYADAN TEKNOLOJİ HABERLERİ

→
Ruby 2.0: anahtar kelimeli parametrelerle daha açık API sözleşmeleri
Yazılım · 2013
Yazılım2013

Ruby 2.0: anahtar kelimeli parametrelerle daha açık API sözleşmeleri

Ruby 2.0, 24 Şubat 2013’te anahtar kelimeli parametreler, Module#prepend ve tembel koleksiyon işlemleri gibi yeniliklerle yayımlandı. Bu yazıda özellikle işlev çağrısındaki anlamın daha açık hale gelmesini ele alıyoruz.

Arşiv incelemesi · Konu yılı 2013

Yazılımcının GünlüğüYayımlanma: 18 Kas 20263 dk okuma
Okuma ilerlemesi0%

Ruby 2.0 ile arayüzün değişimi

Ruby 2.0, 24 Şubat 2013’te anahtar kelimeli parametreler, Module#prepend ve tembel koleksiyon işlemleri gibi yeniliklerle yayımlandı. Bu yazıda özellikle işlev çağrısındaki anlamın daha açık hale gelmesini ele alıyoruz. Birden çok isteğe bağlı parametresi bulunan API’lerde hangi değerin hangi anlama geldiğini yalnız sıraya bakarak tahmin etmek kırılgan bir yaklaşımdır. Rapor oluşturma örneğinde tarih aralığı karıştırıldığında çıktı geçerli bir dosya olarak üretilebilir ama yanlış dönemi kapsayabilir. Bu tür sessiz hatalar sözdizimi ne kadar zarif olursa olsun önemlidir. Anahtar parametreler niyeti görünür kılar, fakat başlangıç tarihinin bitişten sonra olmadığını ayrıca kontrol etmek gerekir.

Anahtar sözcüklü parametreler

Anahtar kelimeli parametreler, örneğin bir rapor üretiminde başlangıç tarihi, bitiş tarihi ve çıktı biçimini adlarıyla belirtmeyi mümkün kılar. Kod okunurken sayıların hangi ayara karşılık geldiği daha anlaşılır olur. Ancak uygun varsayılanların seçilmesi ve geçersiz parametrelerin ele alınması hâlâ geliştirici kararıdır. Açık adlandırma, çalışma zamanı davranışını doğru test etmenin yerini almaz. Bir işlevin parametre sayısı arttıkça hangi argümanın zorunlu olduğu ve hangi varsayılanın güvenli kabul edildiği açıklanmalıdır. Anahtar sözcükler çağıranı yönlendirir ama belirsiz varsayılanlar hâlâ yanlış karar üretebilir. API belgelerinde desteklenen değer aralıklarının bulunması, yalnız örnek çağrı göstermeden daha faydalıdır.

Servis mimarisiKavramsal şema · makalenin teknik akışını özetler

Genişletme sırası ve gecikmeli değerlendirme

Module#prepend ve Enumerable#lazy ayrı ihtiyaçlara karşılık verir. Birincisi yöntem arama zincirini etkilerken ikincisi işlemleri gerektikçe uygulamayı kolaylaştırabilir. Bunları aynı sorun için tek çözüm gibi kullanmak yanıltıcıdır. Özellikle eklenti ve genişletme yapılan bir uygulamada yöntem çağrılarının hangi sırayla çözüldüğü anlaşılmazsa bakım maliyeti yükselebilir. Bir modül yöntemi öne alındığında çağrı zincirinin değişmesi özellikle çerçeve genişletmeleri ve test yardımcılarında dikkat gerektirir. Bir özelliğin görünüşte düzgün çalışması, başka bir sınıfla karıştığında aynı davranacağı anlamına gelmez. Yöntem çözümleme sırası küçük kapsamlı testlerle gösterilmelidir.

Çağrı sözleşmesini test etmek

Bir API değişikliğini değerlendirirken önce mevcut çağrı yerlerini listeleyin. Yanlış parametre sırası, eksik zorunlu değer ve beklenmedik anahtar durumlarını test edin. Tembel işlem zinciri kullanılıyorsa ne zaman tüketildiğini ayrıca gözleyin. Böylece sözdiziminin daha anlaşılır olması ile gerçek sonuçların doğru üretilmesi birbirine karıştırılmaz. Tembel koleksiyonun henüz tüketilmediği anda hangi yan etkinin oluşmadığını gözlemek de yararlıdır. Örneğin dosyadan okuma gerçek tüketim başladığında gerçekleşiyorsa hata zamanı değişebilir. Testleri yalnız üretilen dizinin son haline indirgemeyin; kaynakların ne zaman açılıp kapandığını da inceleyin.

Kısa koddan okunabilir API’ye

Ruby 2.0’ın tarihsel dersi, arayüz tasarımının yalnız daha kısa kod yazmak olmadığıdır. Parametre adları, yöntem genişletme sırası ve koleksiyonların değerlendirilme zamanı sistem davranışını etkiler. Bu dönem yazısı bugün eski sürümü kurmayı önermiyor. Güncel sürüm ve kütüphanelerin uyumu ayrıca doğrulanmalıdır. Sürüm yükseltmelerinde önceki dil davranışına güvenen kodlar dikkatli ele alınmalıdır. Çağrı sözdizimi, yöntem arama sırası ve tembel değerlendirme farklı risk kategorileridir. Bunları tek bir geçiş kontrolü altında toplamak yerine her birine açık kabul testleri eklemek, beklenmedik regresyonları daha erken ortaya çıkarır.

İlk okuyan sen ol ✎ Yorum yaz

Yorumlar

Henüz yorum yok. İlk katkıyı sen yapabilirsin.

Yorum yaz

Adın ve soyadın yorumunla birlikte herkese açık görünecek.

Örnek yorumlar ve editör yanıtı

Tartışma örneği — gerçek kullanıcı yorumu değildir. Bu alandaki isimler ve konuşmalar örnek olarak hazırlanmıştır. Beğeniler ve yanıtlar kaydedilmez; gerçek etkileşim sayılarına eklenmez.

Örnek sayaçlar: 19.699 okunma · 419 beğeni — gerçek ölçüm değildir

Ayşe Yılmaz

“Ruby 2.0: anahtar kelimeli parametrelerle daha açık API sözleşmeleri” başlıklı makalede özellikle şu noktayı düşündüm: sürüm geçişi ve geri dönüş planının ayrıca açıklanması faydalı olur.

Editörün örnek yanıtı

Editörün notu: Kaynak bir duyuru olduğu için geleceğe dönük ifadeleri kesinleşmiş performans sonucu olarak aktarmıyoruz. Yeni veriler geldikçe değerlendirme güncellenebilir.

Fatma Demir

Bence öne çıkan sorulardan biri, kaynağın neyi kesin olarak doğruladığı. İleriye dönük beklentileri sonuç gibi okumamak lazım.

Mehmet Kaya

İzlemeye değer bir başlık. Bir sonraki sürümün ölçümleri geldiğinde bugünkü değerlendirmeyi güncellemeliyiz.

Burak Arslan

Bu konuyu bugün okurken dönem koşullarını da görmek isterim. “Ruby 2.0: anahtar kelimeli parametrelerle daha açık API sözleşmeleri” için o gün geçerli olan hangi sınırlamalar hâlâ önemli?

Editörün örnek yanıtı

Dönem bilgisi yazının konu yılıyla belirtiliyor. Arşivdeki bir sonucu bugüne uygularken kaynak tarihini ve güncel sürüm koşullarını yeniden kontrol etmek gerekir.

Can Özdemir

Konuya yeni başlayanlar için kaynaklardan hangisiyle başlamayı önerirsiniz? Özellikle yazilim başlığındaki teknik terimler için kısa bir açıklama yararlı olur.

Emre Aydın

Yazıdaki sonucu farklı bir ortamda karşılaştırırken hangi değişkenleri sabit tutmak gerekir? Yalnız tek bir ölçüme bakmak eksik kalabilir.

Deniz Yalçın

Arşivde aynı konuya farklı açıdan bakan bir yazıya bağlantı eklenebilir mi? Gelişimin zaman içindeki yönünü birlikte okumak isterim.

Editörün örnek yanıtı

İlgili okumalar için yazının kaynakları ve arşiv bağlantıları başlangıç olabilir. Aynı başlık altındaki iddiaları karşılaştırırken yöntem ve kapsam farklarını da dikkate almak gerekir.

Onur Kılıç

Burada kesinleşen bulgularla henüz yanıt bekleyen soruları ayırmak faydalı. Özellikle “Ruby 2.0: anahtar kelimeli parametrelerle daha açık API sözleşmeleri” başlığındaki sonucun sınırlarını merak ediyorum.