Modules

Les modules BERKIOS : vue d'ensemble

Un module (ou bibliothèque) ajoute de nouvelles commandes au code de vos composants : générer un identifiant unique, calculer une date relative, fabriquer un PDF, appeler une API, tirer un nombre au hasard…

Vous l'installez en quelques clics depuis le Studio, puis vous utilisez ses commandes comme celles de BERKIOS CODE.

Installer un module

Ouvrez le Studio, puis Code → Bibliothèques.
Choisissez une bibliothèque dans le catalogue et installez-la. Le Studio vérifie l'empreinte SHA-256 du fichier avant de l'enregistrer.
Cliquez sur Ajouter au projet. La définition est copiée dans votre projet : il reste ouvrable sans connexion, et l'application générée est autonome.
Utilisez les commandes dans le code d'un composant.

Avant l'ajout, le Studio affiche les permissions demandées par la bibliothèque (réseau, fichiers, impression…). Une bibliothèque qui utilise une permission non déclarée est refusée.

Utiliser une commande

quand clic
  uuid4 "$id"                  # génère un identifiant unique
  uuid-valide "$id" "$ok"      # true
  dans-jours "Echeance" 30     # date d'aujourd'hui + 30 jours

Une commande s'écrit par son nom court (uuid4) ou son nom qualifié (uuid.uuid4).
Si deux bibliothèques utilisent le même nom, ou si le nom existe déjà dans BERKIOS CODE, utilisez la forme qualifiée.
Une commande de bibliothèque commence une ligne : on ne l'imbrique pas après si … alors ou repeter.
La plupart des bibliothèques proposent leurs commandes en français, anglais, espagnol et swahili.

Deux familles de modules

Famille	Principe	Exemples
Bibliothèques `.bkl`	Des macros écrites en BERKIOS CODE. Elles n'exécutent rien d'autre que ce que BERKIOS CODE sait déjà faire : l'aperçu et l'application finale se comportent de la même façon.	`datetime`, `uuid`, `randomy`, `golib`, `requeto`, `pdflab`, `video`, `mygame`, `easyapi`
Modules natifs	Du code exécuté par le Bridge de BERKIOS, pour les fonctions qu'une macro ne peut pas faire (cryptographie, réseau, appareils).	Passo, Berkrypt, ftpLab, KConnect, KPartage

Les bibliothèques fournies

Bibliothèque	Contenu
`systeme`	Copier une valeur, exporter un texte, sauvegarder et restaurer une valeur.
`datetime`	Date et heure, dates relatives, jours restants, durées lisibles, chronomètre (13 commandes).
`randomy`	Nombres aléatoires, dans l'esprit du module `random` de Python (30 commandes).
`uuid`	Identifiants uniques (12 commandes).
`golib`	Chemins de fichiers, dans l'esprit de `pathlib` (37 commandes).
`requeto`	Requêtes HTTP GET avec extraction JSON et cache (8 commandes).
`pdflab`	Génération de PDF (39 commandes).
`pdfreader`	Lecture de PDF.
`video`	Lecteur vidéo (24 commandes).
`mygame`	Jeux 2D : canevas, sprites, collisions, scores.
`easyapi`	Créer des API REST en BERKIOS CODE.
`fichiers`	Fichiers virtuels et réels dans le dossier de travail confiné.

Permissions

Les permissions possibles pour une bibliothèque .bkl sont : reseau, fichiers, presse-papiers, impression, audio et stockage. Le Studio les déduit des commandes utilisées et refuse une bibliothèque qui n'en déclare pas assez.

Limites actuelles

Les bibliothèques .bkl sont des macros : elles ne peuvent pas ajouter de code Dart ni de plugins.
Le catalogue n'est pas signé. L'empreinte SHA-256 protège contre un fichier modifié, pas contre un catalogue malveillant : installez uniquement des bibliothèques de sources de confiance.

Créer votre propre bibliothèque

Une bibliothèque est un simple fichier JSON. Le format .bkl explique comment en écrire une.

Cette page en Markdown · llms.txt · documentation complète pour les IA