Galerie

Outil en ligne de commande

Trois commandes (saluer, calculer, compter) avec arguments, options, conditions et boucles.

Télécharger l'exempleFichier .zip depuis la dernière release GitHub.

Type : BERKIOS Code · Niveau : intermédiaire · Fichier : outils.fr.bk

Ce que vous allez apprendre

Créer un programme qui s'utilise dans un terminal, sans interface graphique.
Déclarer des arguments, des options et des valeurs par défaut.
Utiliser si, sinon, répéter, des calculs et des codes de sortie.

Avant de commencer

L'outil berkios doit être installé et réglé sur le français (berkios --lg --fr).

Étape 1 : le code

langue français

application "Outils"
  type commande
  version 1.0
  description "Petits outils en ligne de commande"

commande saluer
  description "Dit bonjour"
  argument nom : texte, obligatoire
  option répétitions : nombre entier, par défaut 1
  option fort : booléen
  action
    répéter répétitions fois
      si fort alors
        afficher "BONJOUR " et nom
      sinon
        afficher "Bonjour " et nom

commande calculer
  description "Applique une opération à deux nombres"
  argument premier : nombre décimal, obligatoire
  argument opération : texte, obligatoire
  argument second : nombre décimal, obligatoire
  action
    si opération est égal à "+" alors
      afficher premier + second
    sinon
      si opération est égal à "*" alors
        afficher premier * second
      sinon
        si opération est égal à "/" alors
          si second est égal à 0 alors
            afficher une erreur "Division par zéro"
            arrêter avec le code 1
          afficher premier / second
        sinon
          afficher une erreur "Opération inconnue : " et opération
          arrêter avec le code 2

commande compter
  description "Compte jusqu'à un nombre"
  argument limite : nombre entier, obligatoire
  action
    définir total comme 0
    répéter limite fois
      définir total comme total + 1
      afficher "Étape " et total et " sur " et limite
    afficher "Terminé : " et (total * 2) et " points"

Étape 2 : vérifier et afficher l'aide

berkios valider outils.fr.bk
berkios lancer outils.fr.bk --aide

Outils 1.0.0
Petits outils en ligne de commande

Utilisation : outils <command> [options]

Commandes :
  saluer    Dit bonjour
  calculer  Applique une opération à deux nombres
  compter   Compte jusqu'à un nombre

L'aide est générée automatiquement à partir de vos descriptions.

Étape 3 : essayer les trois commandes

berkios lancer outils.fr.bk saluer Amina --répétitions 2 --fort

BONJOUR Amina
BONJOUR Amina

berkios lancer outils.fr.bk calculer 6 "*" 7

berkios lancer outils.fr.bk compter 3

Étape 1 sur 3
Étape 2 sur 3
Étape 3 sur 3
Terminé : 6 points

Pensez à mettre le * entre guillemets : sans eux, le terminal le remplace par la liste des fichiers du dossier.

Étape 4 : les erreurs

berkios lancer outils.fr.bk calculer 5 "/" 0

Le programme affiche Division par zéro et s'arrête avec le code de sortie 1. Une opération inconnue (par exemple "^") affiche Opération inconnue : ^ et s'arrête avec le code 2. Ces codes permettent à d'autres programmes de savoir si l'outil a réussi.

Étape 5 : en faire un fichier autonome

berkios exporter outils.fr.bk -o outils.mjs
node outils.mjs compter 2

Le fichier outils.mjs fonctionne avec Node.js seul, sans installer BERKIOS.

Le code expliqué

Instruction	Rôle
`type commande`	L'application est un outil de terminal.
`commande saluer`	Une commande, avec sa description.
`argument nom : texte, obligatoire`	Une valeur que l'utilisateur doit fournir.
`option répétitions : nombre entier, par défaut 1`	Un réglage facultatif (`--répétitions 2`), avec sa valeur par défaut.
`option fort : booléen`	Un interrupteur : présent ou absent (`--fort`).
`répéter répétitions fois`	Une boucle.
`si … alors` / `sinon`	Une condition. On peut en imbriquer, comme pour `calculer`.
`afficher … et …`	Colle plusieurs morceaux de texte ou de nombres.
`définir total comme …`	Crée ou modifie une variable.
`arrêter avec le code 1`	Termine le programme avec un code d'erreur.

À vous de jouer

Ajoutez une commande carre qui affiche le carré d'un nombre :

commande carre
  description "Affiche le carré d'un nombre"
  argument nombre : nombre décimal, obligatoire
  action
    afficher nombre * nombre

Puis : berkios lancer outils.fr.bk carre 9.

Pour aller plus loin

Exemple suivant : Échéances et chronomètre
Leçon : Outils en ligne de commande

Cette page en Markdown · llms.txt · documentation complète pour les IA