nelson-format
Formateur de source Nelson en ligne de commande.
📝Syntaxe
nelson-format [--include-subfolders true|false] [--indent-size n] [--full-format true|false] [--config file] [--check] path ...
📄Description

nelson-format formate les fichiers source Nelson depuis la ligne de commande.

Les fichiers sont formates sur place par defaut. Le formateur traite uniquement les fichiers avec l'extension .m.

--include-subfolders active le formatage recursif quand un dossier est passe en entree.

--indent-size definit la taille d'indentation. La valeur par defaut est 2.

--full-format active ou desactive le formatage complet. La valeur par defaut est true. Mettre false pour modifier uniquement l'indentation de debut de ligne.

--config charge un fichier de configuration JSON. Sans cette option, nelson-format cherche nelson-format.json depuis les chemins d'entree puis depuis le dossier courant.

--check signale les fichiers qui changeraient sans les ecrire.

Les blocs sur une seule ligne conservent leurs instructions d'ouverture et de fermeture sans modifier l'indentation des lignes suivantes. Les indexations utilisant end restent distinctes des fermetures de blocs.

Les clauses catch sur une ligne conservent le separateur apres la variable d'exception facultative, notamment dans catch err, value = err.message;.

Les cles de configuration supportees sont indentSize, fullFormat, includeSubfolders et excludePathContains. Les options de ligne de commande remplacent les valeurs chargees depuis JSON.

Les fichiers listes par nelson-format-ignore.json ou par excludePathContains dans nelson-format.json sont ignores.

Le code retour 0 signifie succes ou aucun changement requis, 1 signifie que --check a trouve des fichiers qui changeraient, et 2 signifie une erreur d'usage, d'entree, de lecture/ecriture ou interne.

Le formatage complet preserve les references aux packages, aux membres et aux champs dynamiques comme package.function(value.(name)). Les noms contextuels des blocs de classe restent des identifiants ordinaires dans les instructions executables.

💡Exemples
Formatter recursivement tous les fichiers Nelson d'un dossier.
nelson-format --include-subfolders true modules/interpreter/functions
Verifier qu'un fichier est deja formate.
nelson-format --check myfile.m
Formatter avec un fichier de configuration explicite.
nelson-format --config nelson-format.json modules/interpreter/functions
Used Functions
smartindent
🕔Historique des versions
Version Description
2.0.0 version initiale
Modifier cette page sur GitHub