Commençons par un exemple simple qui affiche un message sur la console. Créez un fichier appelé luarc dans le répertoire de configuration de Ansel (généralement $HOME/.config/Ansel/) et ajoutez-y la ligne suivante :

1print("Hello World !")

Lancez Ansel et vous verrez la phrase « Hello World ! » s’afficher sur la console. Rien d’extraordinaire, mais c’est un début.

À ce stade, il n’y a rien de spécifique à Ansel dans le script. Nous utilisons simplement la fonction d’affichage standard de Lua, permettant d’afficher une chaîne de caractère. C’est bien beau, mais nous pouvons faire mieux. Ainsi pour accéder à l’API Ansel, vous devez d’abord la demander (require) et enregistrer le résultat dans une variable. Depuis cette variable, vous pouvez accéder à toute l’API Ansel en appelant des sous-champs. Tout est documenté dans le manuel de l’ API Lua

1local Ansel = require "Ansel"
2Ansel.print_error("Hello World !")

Exécutez le script et… rien de ne s’affiche ! La fonction Ansel.print_error est comme le print classique mais affiche le message uniquement si vous avez activé les traces Lua en lançant Ansel avec la commande « Ansel -d lua ». C’est la méthode recommandée pour afficher des traces dans un script Lua de Ansel.