.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.

İki depolama modu

Tek .restorm dosyası

Varsayılan mod (Dosya ▸ Yeni, ardından Farklı kaydet). Projenin tamamı tek bir dosyaya sığar; varsayılan olarak YAML. İki serileştirme biçimi daha mevcuttur: json ve json5.

Klasör modu

Dosya ▸ Klasör aç. Proje disk üzerinde bir ağaca dağıtılır; bu da büyük projelerde çok daha ince diff’ler verir:

• kökte, yalnızca biçimi taşıyan bir restorm.conf yapılandırma dosyası (format: yaml | json | json5);
• dizin başına bir dizin dosyası (index.yaml, index.json…);
• <index> - <ad> biçiminde adlandırılan klasörler ve dosyalar; ekrandaki sıra diskteki sıra olsun diye indeks, kardeş sayısının genişliğine göre sıfırlarla tamamlanır. Yasak karakterler (<>:"/\|?*) _ ile değiştirilir ve ad 100 karakterde kesilir.

Klasör modunda Ctrl+S yalnızca etkin sekmenin alt ağacını yazar; Ctrl+Shift+S (Tümünü kaydet) tamamını yazar.

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

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

Yalnızca sürüm denetiminin kullanışlı olması için var olan iki güvence:

1. 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.
2. 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

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.