Dự án và tệp .restorm
Một dự án Restorm sống trên ổ đĩa của bạn. Không có không gian làm việc từ xa, không có cơ chế đồng bộ độc quyền: bạn mở một tệp, bạn lưu nó, bạn commit nó.
Tệp .restorm
Section titled “Tệp .restorm”Một dự án Restorm là một tệp duy nhất (Tệp ▸ Mới, rồi Lưu dưới dạng),
mặc định ở dạng YAML. Có thêm hai định dạng tuần tự hóa khác: json và
json5.
Những gì dự án chứa
Section titled “Những gì dự án chứa”- cây: thư mục, thư mục biến, yêu cầu của mọi giao thức, kịch bản;
- các môi trường và biến của chúng, kể cả các môi trường con;
- các danh sách giá trị tùy chỉnh và các kiểu liệt kê đã nhập;
- các thẻ và màu của chúng;
- tài liệu API gắn với các thư mục biến;
- các cài đặt nhanh được lưu “trong dự án”;
- một định danh dự án (
_projectUuid) và một phiên bản định dạng.
Những gì dự án không chứa
Section titled “Những gì dự án không chứa”Điều này là có chủ ý, để tệp có thể chia sẻ được:
| Dữ liệu | Nơi nó nằm |
|---|---|
| Bí mật | Một tệp .env chứa bí mật đặt cạnh dự án — xem Bí mật |
| Lịch sử phản hồi | Một kho nén <projet>.responses.zip đặt cạnh dự án |
| Cài đặt nhanh “người dùng” | Các thiết lập cục bộ của bạn |
| Mục yêu thích | Bộ nhớ cục bộ của ứng dụng, đánh chỉ mục theo định danh dự án |
| Bố cục workbench | Các thiết lập cục bộ của bạn, đánh chỉ mục theo dự án |
| Thiết lập không gian làm việc | <dossier-du-projet>/.restorm/settings.json |
Hệ quả thực tế: bạn có thể commit một tệp .restorm mà không làm lộ token nào,
và đồng nghiệp của bạn cũng không nhận được bố cục tab của bạn.
Một cách tuần tự hóa dành cho git
Section titled “Một cách tuần tự hóa dành cho git”Hai bảo đảm, tồn tại chỉ để việc quản lý phiên bản dùng được:
- Thứ tự khóa chuẩn tắc. Các khóa định danh đứng đầu (
id,name,key,type,folderType,method,url), phần còn lại được sắp xếp. Riêng thứ tự trong mảng thì không bao giờ bị thay đổi: đó là thứ tự của bạn. - Định danh được suy ra một cách ổn định. Định danh của một thực thể được tính từ đường dẫn ngữ nghĩa của nó chứ không phải sinh ngẫu nhiên. Hai người thêm cùng một yêu cầu vào cùng một chỗ sẽ tạo ra cùng một định danh, nhờ đó phép hợp nhất ghép cặp các thực thể một cách chính xác.
Kết quả: mở rồi lưu lại một dự án mà không sửa gì sẽ không tạo ra diff nào. Xem Git tích hợp.
Dự án gần đây
Section titled “Dự án gần đây”Tệp ▸ Tệp gần đây liệt kê mười dự án mở gần nhất; những đường dẫn đã không còn hợp lệ sẽ tự động bị loại bỏ. Chính danh sách này cũng cấp dữ liệu cho màn hình chào mừng.