StyLua impose un style de code Lua unique et déterministe à travers les projets
Formate le code source Lua dans un style déterministe à partir d'un AST analysé, produisant la même sortie indépendamment de l'espacement ou des sauts de ligne d'origine. Créé par JohnnyMorganz pour le développement de bureau, l'outil cible les projets Lua, Luau et LuaJIT et s'intègre au niveau de l'éditeur ou de l'intégration continue. Il offre une intégration LSP, une interface en ligne de commande avec des modes de vérification et de différence, et une configuration TOML par projet, ce qui le rend adapté aux développeurs et aux créateurs Roblox qui ont besoin d'un formatage prévisible et automatisé.
Ce qu'il fait et qui en bénéficie
StyLua réécrit le code Lua à partir d'une représentation analysée, de sorte que les fichiers suivent un style unique et affirmé après le formatage. Il prend en charge plusieurs dialectes Lua, y compris Luau et LuaJIT, et expose une interface en ligne de commande ainsi qu'un support du protocole de serveur de langage pour l'intégration dans les éditeurs. Les équipes qui souhaitent un style unique imposé peuvent ajouter un fichier TOML au niveau du projet ou un .editorconfig pour définir l'indentation, la largeur des colonnes et les préférences de citation.
Comment il interagit avec les systèmes de développement
L'outil est conçu pour des exécutions rapides et répétables dans des flux de travail locaux et automatisés. Son implémentation en Rust offre un formatage à faible latence adapté aux actions d'éditeur lors de l'enregistrement ou aux tâches à l'échelle du dépôt. Il fournit des modes de vérification et de différence pour l'intégration continue, et prend en charge .styluaignore pour exclure des chemins. Le formatage par plage limite les modifications aux régions de code sélectionnées, ce qui réduit le changement dans les grands fichiers lors d'éditions incrémentales.
Sécurité, configuration et facilité d'utilisation
StyLua fonctionne de manière déterministe et offre des hooks d'éditeur pour réduire les étapes manuelles. L'option LSP permet un formatage en temps réel dans les éditeurs pris en charge, tandis que les drapeaux CLI vous permettent de vérifier le style sans modifier les fichiers. La configuration via stylua.toml maintient les règles à la racine du projet, et les fichiers d'ignorance empêchent les réécritures non intentionnelles. Les utilisateurs ayant une expérience minimale de Lua peuvent s'appuyer sur les valeurs par défaut ; les utilisateurs avancés peuvent ajuster les règles via le schéma TOML.
Recommandé pour les équipes qui ont besoin d'un formatage Lua automatique et répétable
StyLua convient aux développeurs et aux créateurs Roblox qui nécessitent un formatage cohérent dans une base de code et des outils rapides pour les flux de travail d'éditeur ou de CI. Attendez-vous à un effort de configuration unique pour correspondre à votre style préféré, puis automatisez le formatage comme étape de pré-engagement ou de CI pour l'imposer. Recommandé.
