Un générateur déterministe
Même modèle + mêmes templates = même sortie, sur toutes les machines. Rien n'y demande d'IA.
Modèle, template, code
Vous décrivez le domaine dans un petit modèle YAML :
aggregate_roots:
book:
properties:
title:
field_size: 200
copies: int
status: $book_status
author: author
api:
query:
get:
add:
Toute la syntaxe (types, relations, enums, value objects, services, API) : YAML spec reference dans le README (en anglais).
Un template est du code ordinaire, avec des marqueurs de boucle et des jetons. Celui-ci fait partie du jeu Mini :
#region foreach MODEL[AG]
public partial class CLASSNAME
{
public _IDENTITY_KEY_TYPE_ Id { get; set; }
#region foreach PROPERTY[S][NO][NAR]
public _SIMPLE__TYPE_ _SIMPLE__PROPERTYNAME_ { get; set; } = _DEFAULT_VALUE_;
#endregion foreach PROPERTY
}
#endregion foreach MODEL
Burgr écrit les fichiers, nommés *.g.cs :
public partial class Book
{
public Guid Id { get; set; }
public System.String Title { get; set; } = string.Empty;
public System.Int32 Copies { get; set; } = default(System.Int32);
}
Les points d'extension sont des membres partial : vous les écrivez à la main, dans des fichiers que Burgr ne touche jamais.
Jeux de templates
| Package | Génère |
|---|---|
Burgr.Templates.Mini (par défaut) | Un seul projet : Minimal API, DTO, DbContext EF Core, endpoints CRUD. Pas de framework propre. |
Burgr.Templates.Onion | Projets Domain, Application, Infrastructure, Api et Tests, un diagramme de classes, droits, règles, fabriques, événements, requêtes paginées, et un framework léger généré en *.f.cs. |
Les jeux de templates sont des packages NuGet portant le tag burgr-templates. Écrivez le vôtre pour votre architecture, dans n'importe quel langage : les templates sont du texte. Exemples : Mini, Onion.
Quand ne pas l'utiliser
- Du code ponctuel. Les templates sont rentables quand beaucoup d'entités partagent une forme. Un endpoint isolé va plus vite à la main.
- Surtout de la logique métier. Le code généré couvre la partie structurelle (entités, DTO, persistance, API). La logique écrite à la main coûte autant dans les deux cas.
- Une forme qui change à chaque entité. Si chaque entité demande un cas particulier, c'est le template qui devient la chose à maintenir.
- Une stack qu'aucun jeu de templates ne couvre, quand vous ne voulez pas en écrire un.
Comparé à
| Approche | Différence |
|---|---|
| Générateurs OpenAPI | Ils partent d'un contrat d'API ; Burgr part du domaine et peut aussi produire la persistance, le schéma et les diagrammes. |
| JHipster, scaffolding Rails | Une stack fixe. Burgr n'en impose aucune : le jeu de templates est à vous, à choisir ou à écrire. |
| Ingénierie dirigée par les modèles | La même idée, avec un modèle texte volontairement petit et des templates en texte brut. |