Μετάβαση στο περιεχόμενο

Έργα και αρχεία .restorm

Ένα έργο Restorm ζει στον δίσκο σας. Δεν υπάρχει απομακρυσμένος χώρος εργασίας, ούτε ιδιόκτητος συγχρονισμός: ανοίγετε ένα αρχείο, το αποθηκεύετε, το κάνετε commit.

Δύο τρόποι αποθήκευσης

Section titled “Δύο τρόποι αποθήκευσης”

Η προεπιλεγμένη λειτουργία (Αρχείο ▸ Νέο, έπειτα Αποθήκευση ως). Ολόκληρο το έργο χωράει σε ένα μόνο αρχείο, σε YAML εξ ορισμού. Δύο ακόμη μορφές σειριοποίησης είναι διαθέσιμες: json και json5.

Αρχείο ▸ Άνοιγμα φακέλου. Το έργο αναπτύσσεται σε δενδρική δομή στον δίσκο, πράγμα που δίνει πολύ πιο λεπτομερή diff στα μεγάλα έργα:

  • ένα αρχείο διαμόρφωσης restorm.conf στη ρίζα, που φέρει μόνο τη μορφή (format: yaml | json | json5
  • ένα αρχείο ευρετηρίου ανά κατάλογο (index.yaml, index.json…)·
  • οι φάκελοι και τα αρχεία ονομάζονται <index> - <nom>, με τον δείκτη συμπληρωμένο με μηδενικά στο πλάτος των αδελφών κόμβων, ώστε η σειρά στην οθόνη να είναι η σειρά στον δίσκο. Οι απαγορευμένοι χαρακτήρες (<>:"/\|?*) αντικαθίστανται με _ και το όνομα περικόπτεται στους 100 χαρακτήρες.

Σε λειτουργία φακέλου, το Ctrl+S γράφει μόνο το υποδέντρο της ενεργής καρτέλας· το Ctrl+Shift+S (Αποθήκευση όλων) γράφει το σύνολο.

Ένα έργο ανοιγμένο σε λειτουργία φακέλου: το δέντρο αριστερά αναπαράγει την ιεραρχία του φακέλου, και η γραμμή κατάστασης δείχνει έναν φάκελο — όχι ένα αρχείο .restorm.

  • το δέντρο: φακέλους, φακέλους μεταβλητών, αιτήματα όλων των πρωτοκόλλων, σενάρια·
  • τα περιβάλλοντα και τις μεταβλητές τους, μαζί με τα υποπεριβάλλοντα·
  • τις προσαρμοσμένες λίστες τιμών και τις εισαγόμενες απαριθμήσεις·
  • τις ετικέτες και τα χρώματά τους·
  • την τεκμηρίωση API που είναι συνδεδεμένη με τους φακέλους μεταβλητών·
  • τις γρήγορες ρυθμίσεις που αποθηκεύτηκαν «στο έργο»·
  • ένα αναγνωριστικό έργου (_projectUuid) και μια έκδοση μορφής.

Τι δεν περιέχει το έργο

Section titled “Τι δεν περιέχει το έργο”

Σκόπιμα, ώστε το αρχείο να μπορεί να μοιραστεί:

ΔεδομένοΠού ζει
ΜυστικάΈνα αρχείο .env μυστικών δίπλα στο έργο — δείτε Μυστικά
Ιστορικό αποκρίσεωνΈνα αρχείο συμπίεσης <projet>.responses.zip τοποθετημένο δίπλα στο έργο
Γρήγορες ρυθμίσεις «χρήστη»Οι τοπικές σας ρυθμίσεις
ΑγαπημέναΟ τοπικός χώρος αποθήκευσης της εφαρμογής, ευρετηριασμένος ανά αναγνωριστικό έργου
Διάταξη του workbenchΟι τοπικές σας ρυθμίσεις, ευρετηριασμένες ανά έργο
Ρυθμίσεις χώρου εργασίας<dossier-du-projet>/.restorm/settings.json

Πρακτική συνέπεια: μπορείτε να κάνετε commit ένα .restorm χωρίς να διαρρεύσετε ένα token, και ο συνάδελφός σας δεν παραλαμβάνει τη δική σας διάταξη καρτελών.

Μια σειριοποίηση φτιαγμένη για το git

Section titled “Μια σειριοποίηση φτιαγμένη για το git”

Δύο εγγυήσεις, που υπάρχουν αποκλειστικά για να είναι χρήσιμος ο έλεγχος εκδόσεων:

  1. Κανονική σειρά κλειδιών. Τα κλειδιά ταυτότητας έρχονται πρώτα (id, name, key, type, folderType, method, url), τα υπόλοιπα ταξινομούνται. Η σειρά των πινάκων, αντίθετα, δεν μεταβάλλεται ποτέ: είναι η δική σας σειρά.
  2. Αναγνωριστικά που παράγονται με σταθερό τρόπο. Το αναγνωριστικό μιας οντότητας υπολογίζεται από τη σημασιολογική της διαδρομή, δεν επιλέγεται τυχαία. Δύο άτομα που προσθέτουν το ίδιο αίτημα στο ίδιο σημείο παράγουν το ίδιο αναγνωριστικό, πράγμα που επιτρέπει στη συγχώνευση να αντιστοιχίσει σωστά τις οντότητες.

Αποτέλεσμα: το άνοιγμα και η εκ νέου αποθήκευση ενός έργου χωρίς καμία αλλαγή δεν παράγει καμία διαφορά. Δείτε Ενσωματωμένο git.

Το Αρχείο ▸ Πρόσφατα αρχεία παραθέτει τα δέκα τελευταία έργα που ανοίξατε· οι διαδρομές που έχουν πάψει να ισχύουν αφαιρούνται αυτόματα. Η ίδια λίστα τροφοδοτεί την οθόνη υποδοχής.