Proyek dan file .restorm

Proyek Restorm hidup di disk Anda. Tidak ada ruang kerja jarak jauh, tidak ada sinkronisasi berpemilik: Anda membuka sebuah file, menyimpannya, lalu melakukan commit terhadapnya.

Dua mode penyimpanan

File tunggal .restorm

Mode bawaan (File ▸ Baru, lalu Simpan sebagai). Seluruh proyek muat dalam satu file, YAML secara bawaan. Dua format serialisasi lain juga tersedia: json dan json5.

Mode folder

File ▸ Buka folder. Proyek dipecah menjadi struktur folder di disk, yang menghasilkan diff jauh lebih halus pada proyek besar:

• sebuah file konfigurasi restorm.conf di akar, yang hanya memuat format (format: yaml | json | json5);
• sebuah file indeks per direktori (index.yaml, index.json…);
• folder dan file yang dinamai <index> - <nom>, dengan indeks yang dilengkapi nol sesuai lebar kelompok saudaranya, agar urutan di layar sama dengan urutan di disk. Karakter terlarang (<>:"/\|?*) diganti dengan _ dan namanya dipotong pada 100 karakter.

Dalam mode folder, Ctrl+S hanya menulis sub-pohon tab yang aktif; Ctrl+Shift+S (Simpan semua) menulis keseluruhannya.

Apa yang dimuat proyek

• pohonnya: folder, folder variabel, permintaan dari semua protokol, skenario;
• lingkungan beserta variabelnya, termasuk sub-lingkungan;
• daftar nilai kustom dan enumerasi hasil impor;
• tag beserta warnanya;
• dokumentasi API yang terlampir pada folder variabel;
• pengaturan cepat yang disimpan “di dalam proyek”;
• sebuah pengenal proyek (_projectUuid) dan versi formatnya.

Apa yang tidak dimuat proyek

Secara sengaja, agar filenya dapat dibagikan:

Data	Tempatnya
Rahasia	Sebuah file .env berisi rahasia di samping proyek — lihat Rahasia
Riwayat respons	Arsip <projet>.responses.zip yang diletakkan di samping proyek
Pengaturan cepat “pengguna”	Setelan lokal Anda
Favorit	Penyimpanan lokal aplikasi, terindeks menurut pengenal proyek
Tata letak workbench	Setelan lokal Anda, terindeks per proyek
Setelan ruang kerja	<dossier-du-projet>/.restorm/settings.json

Konsekuensi praktisnya: Anda dapat melakukan commit sebuah .restorm tanpa membocorkan token, dan rekan Anda tidak menerima tata letak tab Anda.

Serialisasi yang dirancang untuk git

Dua jaminan, yang ada semata-mata agar pemversian dapat dipakai:

1. Urutan kunci yang kanonis. Kunci identitas berada di depan (id, name, key, type, folderType, method, url), sisanya diurutkan. Urutan larik justru tidak pernah diubah: itu adalah urutan Anda.
2. Pengenal yang diturunkan secara stabil. Pengenal sebuah entitas dihitung dari jalur semantiknya, bukan diundi secara acak. Dua orang yang menambahkan permintaan yang sama di tempat yang sama menghasilkan pengenal yang sama, sehingga penggabungan dapat memasangkan entitas dengan benar.

Hasilnya: membuka lalu menyimpan ulang sebuah proyek tanpa mengubah apa pun tidak menghasilkan diff sama sekali. Lihat Git bawaan.

Proyek terbaru

File ▸ File terbaru mendaftar sepuluh proyek terakhir yang dibuka; jalur yang menjadi tidak valid dihapus secara otomatis. Daftar yang sama mengisi layar sambutan.