Démarrage rapide

1) Installation

dotnet tool install -g coders

Détails d'installation/usage

Initialiser le workspace

Exécutez coders init pour générer la configuration par défaut et un ensemble d'exemples .jssp.

• Sans -f|--force, la commande s'arrête si config.yml existe.
• -v|--verbose étend les logs console au niveau information.
• --force écrase les fichiers existants avec le nouveau template.

Les valeurs par défaut de config.yml sont :

llmOptions:
  # Fournisseur LLM à utiliser
  provider: "ollama"
  # Nom du modèle utilisé lors du build
  model: "gpt-oss-safeguard:20b"
  # Endpoint LLM et identifiants
  url: "http://localhost:11434"
  apiKey: "OLLAMA_API_KEY"
  timeoutSeconds: 300
  stream: true
entry: main.jssp
projects: []

llmOptions gère le fournisseur, le modèle, l'endpoint, l'auth, le timeout et le streaming nécessaires aux appels LLM. projects définit les sorties par plateforme; ajoutez des entrées via coders platform add puis modifiez-les.

Gestion des plateformes

• coders platform list [-v]: affiche les clés de plateforme enregistrées et les infos de cible/langue par défaut.
• coders platform add <platform> [-v]: ajoute la configuration projet par défaut de la plateforme indiquée à config.yml. Modifiez l'entrée/le chemin de sortie et les options selon besoin.
• coders platform remove <platform> [-v]: sous-commande réservée.

Build des sources

coders build <platform> [-v] analyse .jssp et génère le code pour la plateforme indiquée.

• platform doit correspondre à une clé dans projects de config.yml.
• Sans config.yml, le build s'arrête; si le fichier d'entrée manque, une erreur survient.
• Le dossier de sortie est créé automatiquement s'il n'existe pas.

Extraction de prompts

coders extract <target> <platform> [-o|--output <path>] [-v] extrait les prompts et autres ressources.

• target est la cible d'extraction (ex: prompt), et platform est la clé de plateforme.
• Vous pouvez changer le dossier de sortie avec --output; sinon, l'emplacement courant est utilisé.

Flux type

coders init
coders platform add <platform>
coders build <platform> -v

Après l'initialisation, ajoutez la plateforme requise à la configuration, puis lancez le build avec la même clé.

2) Initialiser le workspace

coders init

Fichiers de base générés :

• config.yml
• main.jssp

3) Ajouter des plateformes

coders platform add springboot
coders platform add reactjs
coders platform add mysql

Des entrées projects sont ajoutées à config.yml.

4) Écrire le DSL

Écrivez le DSL Coders dans main.jssp.

domain Email string(320);

table user {
  user_id int64 auto;
  email Email unique;
  key(user_id);
}

5) Build

coders build springboot

Les sorties sont générées dans outPath de config.yml.

Exemples de build par plateforme

coders build springboot
coders build reactjs
coders build mysql

Chaque plateforme est générée dans un dossier de sortie séparé selon les paramètres de projects.

Build de plusieurs plateformes en une seule exécution

Répétez les clés de plateforme ou regroupez-les dans un script.

coders build springboot
coders build reactjs
coders build mysql

L'outil CLI actuel ne propose pas de build multi-plateformes en lot; exécutez-les séquentiellement.

6) Extraction de prompts (optionnel)

coders extract prompt springboot

Utile pour vérifier les règles de transformation spécifiques aux plateformes.

Checklist

• La plateforme est-elle enregistrée dans projects de config.yml ?
• Le fichier entry existe-t-il ?
• Les réglages LLM (llmOptions) sont-ils corrects ?

Erreurs fréquentes

• Oublier la clé de plateforme lors de coders build
• entry est différent de main.jssp et n'a pas été mis à jour
• Le nom du fournisseur/modèle LLM ne correspond pas au service réel