Exemples standalone

Ces scripts s'exécutent directement avec la CLI. Ils conviennent aux traitements autonomes qui utilisent les fonctions déjà exposées par Catnip. Pour intégrer des bibliothèques, un contexte métier ou une politique d'accès, voir les exemples d'embedding.

Catalogue

Script	Concepts
`01_calculate.cat`	fonctions mathématiques et récursion
`02_filter_data.cat`	filtrage, mapping et composition
`03_transform_csv.cat`	transformation de données tabulaires
`04_config_validator.cat`	règles de validation et statut de sortie
`05_data_report.cat`	agrégations et rapport texte

catnip docs/examples/run/01_calculate.cat

Scripts exécutables

Un shebang permet de lancer le fichier comme une commande :

#!/usr/bin/env catnip

data = list(1, 2, 3)
print(sum(data))

chmod +x script.cat
./script.cat

Une exécution réussie renvoie le statut 0, quelle que soit la valeur finale du script. Utiliser sys.exit(code) pour demander un autre statut. La référence des règles et des options se trouve dans CLI.

Choisir standalone ou embedding

Besoin	Forme
calcul ou transformation autonome	script `.cat`
exécution depuis cron ou CI	script `.cat` avec statut explicite
fonctions Python contrôlées	contexte embarqué
règles stockées ou éditées par une application	DSL embarqué
accès à des modules autorisés	chargement de module avec policy

La taille du fichier n'est pas le critère décisif. La frontière utile est l'autorité : un script standalone possède le contexte du processus ; un DSL embarqué ne reçoit que les opérations injectées par l'hôte.

Le même programme peut être un script ou une règle métier. La différence tient dans la personne qui possède le processus et dans la liste des choses qu'elle accepte de lui confier.