Test ve CI

Testler, CI, release ve belge doğrulama

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Her ürün dalının kaynak sahipliği ve workflow'u ayrıdır. Bir bileşenin green sonucu diğer bileşenin doğrulandığı anlamına gelmez. Workflow tanımı ile gerçekten tamamlanmış CI run sonucunu ayırın.

Sunucu

python -m pip install -e ".[dev]"
forge validate
forge doctor
pytest -q
python -m build
python -m twine check dist/*

Testlerin çalışması için kendi .env/canlı veritabanınızı test ortamına taşımayın. PostgreSQL/Redis/Mongo canlı entegrasyon testleri için workflow'un servis sözleşmesi uygulanır. Unit test green olması gerçek sürücü entegrasyonunu yerine getirmez.

Bileşen bazında kapılar

Bileşen	Kontrol alanları
main	Python 3.10–3.14, coverage, SQL/Redis/Mongo, package, TypeScript, Docker, CodeQL, manifest
python-library	Çok platform Python testleri, paket/typing metadata, reproducibility, main ile contract test
Editor	Altı native hedef, warnings-as-errors, Qt testleri, packaged screenshot, ZIP + IFW installer
exampleApps	25 uygulamanın ayrı runtime checkout'unda schema/CRUD/RPC/realtime/graph smoke'ları

SDK/Editor/examples workflow'ları artifact üretir; bunları otomatik PyPI yayını veya GitHub Release yayını olarak anlatmayın. Resmi sürüm yayını ayrı işletmeci adımıdır. MANIFEST.sha256, tracked kaynak bütünlüğü içindir; release arşivinin .sha256 sidecar'ı başka dosyadır.

Davranış odaklı test örnekleri

• İkinci tenant aynı resource ID'sini göremiyor mu?
• Aynı idempotency anahtarı aynı side effect'i iki kez üretmiyor mu?
• Bozuk JSON reload son geçerli app'i koruyor mu?
• Expired Editor session yetkiyi kaybediyor ve kaydedilmemiş belge korunuyor mu?
• Aynı belgenin eski SHA'sı ile save 409 oluşturuyor mu?
• Cursor kaynağı offset iterator'ına yanlış bağlanmış mı?
• Artifact içindeki Qt bağımlılıkları temiz makinede bulunuyor mu?

Bu Wiki'nin doğrulama yöntemi

Wiki'de kullanılan kaynak commitleri Sürüm ve uyumluluk sayfasında sabitlenmiştir. Alan ve API referansları schema/AST üzerinden üretilir. Başlangıç komutları ve CRUD/RPC/hook örnekleri geçici, ayrı test dizininde çalıştırılır. Paket içindeki VERIFICATION.md yapılan gerçek kontrolleri ve platform sınırlarını listeler.

Bir Wiki doğrulaması, bütün resmi CI matrisinin yeniden çalıştırılması değildir. Gelecekteki sürüm incelemesinde değişen davranışın ilgili testlerini yeniden çalıştırın; eski raporları güncel sürüm sertifikası gibi kullanmayın.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/.github/workflows/ci.yml
• python-library/.github/workflows/python-library.yml
• Editor/.github/workflows/editor-build.yml
• exampleApps/.github/workflows/example-apps.yml

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım