Codegeneratie
Vanuit de sectie Code genereert Restorm de code van uw applicatie op basis van uw ontwerp. De generatie steunt op Cookiecutter/Copier-compatibele templates: uw eigen, of die aangeboden door Restorm.
Een project genereren
Section titled “Een project genereren”- Voeg een of meer templates toe — via de templatebibliotheek.
- Kies een uitvoermap (absoluut of relatief ten opzichte van het project).
- Klik op Het project genereren.
De generatie wordt gerenderd in een sandbox en vervolgens geproduceerd als een voorbeeld: Restorm toont u de boom van de gegenereerde bestanden en schrijft niets zolang u niet hebt bevestigd. U kunt dan In de uitvoermap schrijven of Afbreken. (De generatie is geblokkeerd zolang er validatieproblemen resteren.)
De vragen van het template
Section titled “De vragen van het template”Een template kan vragen declareren (in de zin van Copier — bijvoorbeeld een
project_slug), die u beantwoordt op het moment van genereren. Uw antwoorden
worden opgeslagen in een bestand .copier-answers.yml in de wortel van de
uitvoer, en herladen bij de volgende generatie.
De gegenereerde code bijwerken
Section titled “De gegenereerde code bijwerken”De generatie is geen eenrichtingsverkeer. Opnieuw genereren vervult de rol van
een copier update: Restorm onthoudt een basis en voert een
driewegs-merge uit tussen de nieuwe uitvoer van het template en uw lokale
wijzigingen — uw wijzigingen worden dus niet overschreven. U laat uw ontwerp
(of het template) evolueren, u genereert opnieuw, en de code werkt zich bij met
behoud van uw werk.
Waar een template vandaan komt
Section titled “Waar een template vandaan komt”De templatebibliotheek biedt vier bronnen:
- Officieel — de door Restorm onderhouden templates, zichtbaar voor iedereen.
- Organisatie — de binnen uw organisatie gedeelde templates, privé voor haar leden. Dat is een Enterprise-functie: een admin — of een lid met het recht templates beheren — voegt ze toe of verwijdert ze (repository-URL + beschrijving), vanuit het tabblad Templates <organisatie> van de bibliotheek of vanuit het administratie-dashboard. Zie Officiële en organisatietemplates.
- Repository — een GitHub-repository
eigenaar/naam(typisch een fork van een officieel template dat u hebt aangepast). - Lokale map — een template in ontwikkeling, zonder netwerk.
De structuur van een template en de officiële catalogus worden beschreven op de pagina Officiële templates. Wat een template ontvangt van uw ontwerp (modellen, routes en hun vlaggen) wordt uitgebreid beschreven in De context van het template, en de template-eigen instellingen in Generatievariabelen.