Bölüm 18 · Araştırma kodundan güvenilir API'ye
Prof. Dr. Bahadır Yüzbaşı · Kod sürümü 2026-09-27
Tüm bölümler · Tam kod arşivi (ZIP)
Konular
- Çalışan kod ile güvenilir arayüz aynı şey değildir
- Dört sorumluluk katmanı
- Girdi sözleşmesini tam yazmak
- Çıktı sözleşmesi ve sunumdan ayrılma
- Hata da arayüzün parçasıdır
- Yan etkilerin bütçesi
- Geriye dönük uyumluluğun yüzeyleri
- Bölüm laboratuvarı
Ön koşullar ve çalıştırma
Gerekli kurulu bileşenler: jsonlite, digest, knitr, testthat, roxygen2.
Bu komut Bölüm 18–24 ortak test grubunu çalıştırır; tek dosyanın bağımsız çalıştığı iddiası değildir. Yardımcı işlevler ve girdiler birlikte yüklenir.
Önce tam arşivi açın. Aşağıdaki yolu arşivden çıkan R_programlama dizininin gerçek tam yoluyla değiştirin. Rscript PATH üzerinde bulunmalıdır.
macOS/Linux (Terminal):
cd /absolute/path/to/R_programlama
PACKAGE_ENGINEERING_RUN_ID=okur-bolum-18-01 Rscript --vanilla scripts/run_package_engineering_smoke.R
Windows (PowerShell):
cd "C:/path/to/R_programlama"
$env:PACKAGE_ENGINEERING_RUN_ID="okur-bolum-18-01"
Rscript --vanilla scripts/run_package_engineering_smoke.R
Test grubunu yeniden çalıştırırken 01 son ekini 02 yapın; önceki sonuçlar korunur. Grup sonuçları validation/v0.1/<run-id>/ altında, sürüm ve bütünlük kayıtlarıyla saklanır.
Beklenen sonuç
Komut sıfır çıkış koduyla tamamlanır; test raporunda tüm kapılar PASS/TRUE olmalıdır. Eksik paket/derleyici durumunda başarı varsayılmaz; hata iletisini izleyin.
Bölüm dosyaları
Tek dosya bağlantıları inceleme içindir. Çalıştırmak için tam arşiv önerilir; ortak saf-R referansı ve diğer bölüm dosyaları gerekebilir.