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ó.
Hai chế độ lưu trữ
Section titled “Hai chế độ lưu trữ”Tệp đơn .restorm
Section titled “Tệp đơn .restorm”Đây là chế độ mặc định (Tệp ▸ Mới, rồi Lưu dưới dạng). Toàn bộ dự án
gói gọn trong một tệp duy nhất, mặc định ở dạng YAML. Có thêm hai định dạng
tuần tự hóa khác: json và json5.
Chế độ thư mục
Section titled “Chế độ thư mục”Tệp ▸ Mở thư mục. Dự án được trải ra thành cây thư mục trên ổ đĩa, cho ra những bản diff mịn hơn nhiều trên các dự án lớn:
- một tệp cấu hình
restorm.confở thư mục gốc, chỉ chứa định dạng (format: yaml | json | json5); - một tệp chỉ mục cho mỗi thư mục (
index.yaml,index.json…); - các thư mục và tệp được đặt tên
<index> - <nom>, với chỉ số được đệm số 0 theo độ rộng của nhóm anh em, để thứ tự trên màn hình đúng bằng thứ tự trên ổ đĩa. Các ký tự bị cấm (<>:"/\|?*) được thay bằng_và tên bị cắt còn 100 ký tự.
Ở chế độ thư mục, Ctrl+S chỉ ghi cây con của tab đang mở; Ctrl+Shift+S
(Lưu tất cả) ghi toàn bộ.
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.