Analysez des arguments CLI selon une spécification

Fournissez les éléments ainsi qu’une spécification compacte qui nomme chaque indicateur booléen et chaque option exigeant une valeur. L’analyseur associe les alias aux noms canoniques, conserve les arguments positionnels, identifie les indicateurs inconnus, accepte les options longues avec un signe égal et arrête l’interprétation après le marqueur conventionnel à deux tirets. Les spécifications incorrectes, les arguments répétés et les options privées de leur valeur obligatoire produisent des erreurs de saisie explicites.

Décrivez l’interface de commande sous forme de données

Commencez par les éléments d’argument tels que l’environnement d’exécution les fournit, après retrait du nom de l’exécutable et de celui du script. Définissez ensuite chaque argument accepté dans la spécification. Chaque entrée possède un nom canonique, un ou plusieurs alias et un type. Utilisez flag pour un indicateur dont la présence signifie vrai, tel que <code>--verbose</code>. Utilisez option lorsque l’écriture doit être suivie d’une valeur, comme <code>--output result.json</code>. Les alias permettent aux formes courte et longue d’alimenter la même propriété : <code>-o</code> et <code>--output</code> peuvent ainsi produire <code>output</code>. Les noms canoniques emploient des lettres minuscules, des chiffres et des traits de soulignement afin que l’objet retourné soit exploitable sans renommage supplémentaire. Les alias doivent commencer par un ou deux tirets. L’analyseur refuse les noms canoniques et alias en double, car ces collisions rendraient le résultat dépendant de l’ordre de déclaration. Activez <code>multiple</code> uniquement si la répétition est prévue par l’interface ; les valeurs suivent alors leur ordre d’apparition.

Comprenez l’analyse des éléments et le résultat

Le résultat distingue les valeurs reconnues, les éléments positionnels et les indicateurs inconnus. Un indicateur reconnu devient vrai sous son nom canonique, tandis qu’une option enregistre l’élément suivant. Une option longue peut aussi porter sa valeur dans le même élément, comme <code>--format=json</code>. La correspondance est exacte : les groupes courts tels que <code>-abc</code> ne sont pas décomposés, sauf si cette écriture complète est déclarée comme alias. Tout élément inconnu commençant par un tiret rejoint <code>unknown_flags</code> ; vous pouvez ainsi le refuser, afficher un avertissement ou le transmettre volontairement. Les autres éléments inconnus deviennent des valeurs positionnelles. Un <code>--</code> isolé met fin au traitement des options, puis chaque élément est positionnel, même s’il commence par un tiret. Cet échappement conventionnel évite toute ambiguïté pour un fichier comme <code>-draft.txt</code>. L’analyseur ne crée aucune valeur par défaut et ne convertit pas les chaînes en nombres, car ces choix relèvent de l’application et pourraient masquer une erreur. Le résultat reste déterministe et ordonné.

Gérez sûrement les valeurs absentes et les répétitions

Toute entrée de type option exige une valeur non vide chaque fois qu’un de ses alias apparaît. Si cet alias est le dernier élément, précède le marqueur de fin des options ou est suivi d’un autre élément ayant la forme d’un indicateur, l’analyse échoue avec une erreur de saisie qui nomme l’alias concerné. La même règle vaut pour une forme jointe vide telle que <code>--output=</code>. Ce comportement strict empêche qu’un indicateur ultérieur soit absorbé silencieusement comme donnée et traite directement l’une des erreurs d’analyse les plus dangereuses. Un tiret seul peut néanmoins servir de valeur, ce qui convient aux programmes représentant l’entrée ou la sortie standard par <code>-</code>. Par défaut, répéter un argument reconnu provoque également une erreur. Déclarez <code>multiple: true</code> lorsque la répétition est légitime, par exemple pour plusieurs chemins d’inclusion ou étiquettes ; le nom canonique contiendra alors toujours une liste. Les indicateurs inconnus sont signalés sans causer d’échec, afin que vous gardiez la maîtrise des règles de compatibilité et de transmission.