.restorm projeleri ve dosyaları
Bir Restorm projesi kendi diskinizde yaşar. Uzak bir çalışma alanı, tescilli bir eşitleme yoktur: bir dosya açarsınız, kaydedersiniz, commit’lersiniz.
.restorm dosyası
Section titled “.restorm dosyası”Bir Restorm projesi tek bir dosyadır (Dosya ▸ Yeni, ardından Farklı
kaydet); varsayılan olarak YAML. İki serileştirme biçimi daha mevcuttur:
json ve json5.
Projenin içerdikleri
Section titled “Projenin içerdikleri”- ağaç: klasörler, değişken klasörleri, tüm protokollerin istekleri, senaryolar;
- ortamlar ve değişkenleri, alt ortamlar dâhil;
- özel değer listeleri ve içe aktarılan numaralandırmalar;
- etiketler ve renkleri;
- değişken klasörlerine eklenmiş API dokümantasyonu;
- “projede” kaydedilmiş hızlı ayarlar;
- bir proje tanımlayıcısı (
_projectUuid) ve bir biçim sürümü.
Projenin içermedikleri
Section titled “Projenin içermedikleri”Dosyanın paylaşılabilir olması için bilinçli olarak dışarıda bırakılanlar:
| Veri | Nerede yaşar |
|---|---|
| Gizli değerler | Projenin yanında bir .env gizli değer dosyası — bkz. Gizli değerler |
| Yanıt geçmişi | Projenin yanına konan bir <projet>.responses.zip arşivi |
| “Kullanıcı” hızlı ayarları | Yerel ayarlarınız |
| Favoriler | Uygulamanın yerel deposu, proje tanımlayıcısına göre dizinlenmiş |
| Workbench düzeni | Yerel ayarlarınız, proje başına dizinlenmiş |
| Çalışma alanı ayarları | <proje-klasörü>/.restorm/settings.json |
Pratik sonucu: bir .restorm dosyasını bir token’ı dışarı sızdırmadan
commit’leyebilirsiniz ve iş arkadaşınız sizin sekme düzeninizi almaz.
git için tasarlanmış bir serileştirme
Section titled “git için tasarlanmış bir serileştirme”Yalnızca sürüm denetiminin kullanışlı olması için var olan iki güvence:
- Kurallı anahtar sırası. Kimlik anahtarları başta gelir (
id,name,key,type,folderType,method,url), gerisi sıralanır. Dizilerin sırası ise asla değiştirilmez: o sıra sizin sıranızdır. - Kararlı biçimde türetilen tanımlayıcılar. Bir varlığın tanımlayıcısı rastgele üretilmez, anlamsal yolundan hesaplanır. Aynı isteği aynı yere ekleyen iki kişi aynı tanımlayıcıyı üretir; bu da birleştirmenin varlıkları doğru eşleştirmesini sağlar.
Sonuç: bir projeyi açıp hiçbir şey değiştirmeden yeniden kaydetmek hiçbir diff üretmez. Bkz. Yerleşik git.
Son projeler
Section titled “Son projeler”Dosya ▸ Son dosyalar en son açılan on projeyi listeler; geçersiz hâle gelen yollar otomatik olarak kaldırılır. Aynı liste karşılama ekranını da besler.