Jeux de templates
Un jeu de templates est un package NuGet qui dit à Burgr quel code générer à partir d'un modèle. Le jeu décide de l'architecture, du langage et du harness pour agents IA. Burgr, lui, n'en a aucun.
Catalogue
Burgr.Templates.Mini
Le jeu par défaut
Un seul projet : Minimal API ASP.NET Core, DTO, DbContext EF Core, endpoints CRUD. Pas de framework propre. Uniquement des packages publics.
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.
La liste est lue sur l'API de recherche NuGet pour le tag burgr-templates. Les jeux sont listés d'après leur tag, sans relecture par SolidOps. Un jeu, ce sont des templates en texte et un manifeste : Burgr ne prend rien d'autre dans le package, et ne charge du code de générateur que depuis les assemblies que vous configurez vous-même. Mais un jeu décide de ce qui est écrit dans votre dépôt : le code que vous compilerez et exécuterez, et, avec /harness:, un script de hook pour votre agent IA. Lisez un jeu avant de l'utiliser.
En utiliser un
Sans aucune configuration, Burgr utilise Mini. Pour choisir un autre jeu, ou épingler une version, nommez le package dans burgr.json :
{
"ProjectName": "Library",
"NamespaceName": "Acme",
"BuildingDirectory": "../src/",
"TemplatePackage": { "Id": "Burgr.Templates.Onion", "Version": "1.10.3" }
}
Burgr télécharge le package une fois, depuis nuget.org, et lit son dossier templates/. dotnet burgr specs/ /harness:. installe aussi le harness IA que le jeu livre. Un modèle qui utilise une fonctionnalité que le jeu ne prend pas en charge est refusé, en nommant la fonctionnalité.
Écrire le vôtre
- Un jeu est un dossier de templates et un
burgr.yamlpar dossier, qui associe des noms logiques à des fichiers source et à des destinations. Les templates sont du code ordinaire avec des marqueurs de boucle et des jetons, dans n'importe quel langage. - Un
burgr-templates.jsonà sa racine le décrit : description, fonctionnalités du modèle prises en charge, packages dont le code généré a besoin, dossier du harness, fichier de projet. - Packagez-le en NuGet et donnez-lui le tag
burgr-templates: il apparaît alors dans le catalogue ci-dessus. - Choisissez une licence qui laisse les utilisateurs posséder le code généré. Les jeux publiés sont sous MIT-0, qui n'exige aucune mention.
- Respectez le partage entre code généré et framework : le code généré porte ce qui varie d'un modèle à l'autre, le framework ce qui est identique pour toutes les entités. Le partage et le harness en détail.
Référence : Writing templates et Template sources dans le README (en anglais). Les sources de Mini et d'Onion sont dans le dépôt.