Συνταγές σε δύο λεπτά

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

Μια συνταγή (recipe) είναι ένα επώνυμο μπλοκ ενεργειών. Μπορεί να εξαρτάται από άλλες συνταγές και να χρησιμοποιεί τα αποτελέσματά τους. Τις συνταγές τις γράφουν οι χρήστες· δεν υπάρχουν ενσωματωμένες «συνταγές συστήματος». Ενσωματωμένο είναι ένα σύνολο εντολών και προσαρμογέων εργαλείων (build, git, αρχεία, dat), όμως μια εντολή δεν είναι από μόνη της συνταγή.

Από τι αποτελείται μια συνταγή

• Ένα όνομα. Ελεύθερης μορφής. Οι άλλες συνταγές αναφέρονται σε αυτό.
• Εξαρτήσεις. Ποιες συνταγές πρέπει να εκτελεστούν πρώτες.
• Ένα σώμα. Τι κάνει η συνταγή: παίρνει δεδομένα, τα μετασχηματίζει και βάζει το αποτέλεσμα κάπου.

Μια συνταγή δουλεύει με αντικείμενα, όχι με συμβολοσειρές

Στο Anchor Code, τα server και client είναι αντικείμενα με τύπο. Δεν είναι διαδρομές αρχείων ούτε ένα σύνολο ρυθμίσεων σε JSON. Το επιλεγμένο έργο παρέχεται αυτόματα, γι’ αυτό μια συνταγή δεν γράφει ποτέ project..

// ΠΡΟΧΕΙΡΟ. Δείχνει την ιδέα, δεν εκτελείται.
recipe BuildLcoin {
    dependsOn(GenerateShops);

    GenerateShops.output
        .select(server.shops.lcoin.id)
        .replaceIn(client.dat.shopProducts);
}

Πώς διαβάζεται: το GenerateShops πρέπει να ολοκληρωθεί πρώτο. Έπειτα, από το αποτέλεσμά του λαμβάνεται το κατάστημα που είναι συνδεδεμένο ως L-Coin στο επιλεγμένο έργο και γράφεται στον αντίστοιχο πίνακα του client.

Πρόχειρο. Η λέξη-κλειδί recipe χωρίς εισαγωγικά, η μορφή dependsOn(...), η ιδιότητα output, οι μέθοδοι select και replaceIn και το όνομα shopProducts δεν έχουν εγκριθεί. Πρόκειται για σκαρίφημα του νοήματος, όχι για συμβόλαιο και όχι για εκτελέσιμο κώδικα.

Τι είναι ήδη εγγυημένο

• Η ορατότητα δεν είναι εξουσιοδότηση. Μια συνταγή που μπορεί να διαβάσει δεδομένα δεν αποκτά με αυτό το δικαίωμα να τα αλλάξει.
• Πρώτα η προεπισκόπηση, μετά η ενέργεια. Τίποτα στον server, στον client, στο Git ή στην παραγωγή δεν αλλάζει αθόρυβα.
• Αν ο στόχος είναι διφορούμενος, προκύπτει σφάλμα με εξήγηση, όχι εικασία.

Επόμενο: Η πρώτη σας συνταγή.