Menu
Intégration du code open-source
Le format ISOF est ouvert et documenté. Cette page présente le package Python officiel, les règles d'implémentation pour un lecteur tiers, et les ressources disponibles.
Le format ISOF est un standard ouvert. IsoFind SAS publie les outils nécessaires à son intégration dans des logiciels tiers, sans nécessiter de licence IsoFind ni d'accord commercial.
Le package Python isof
Le package isof est publié sur PyPI sous licence MIT. Il permet de lire, vérifier et exporter des fichiers .isof depuis n'importe quel environnement Python.
pip install isof
# Avec support pandas pour l'export DataFrame
pip install isof[pandas]
Source : github.com/ColinFerrari/isof : licence MIT, contributions bienvenues.
Fonctions principales
| Fonction / méthode | Description |
|---|---|
| isof.load(path) | Charge un fichier .isof depuis le disque. |
| isof.loads(json_str) | Charge depuis une chaîne JSON (API, base de données). |
| report.verify() | Retourne un objet VerificationResult avec valid, level, signer, signed_at, reason. |
| report.is_authentic() | Retourne True si la signature est valide (niveau 1 ou 2). |
| report.to_pandas() | Retourne un DataFrame tidy (une ligne par mesure isotopique). |
| report.to_csv(path) | Exporte les données en CSV. |
| report.samples | Liste des échantillons (dicts). |
| report.methods | Dictionnaire des méthodes analytiques. |
| report.created_by | Métadonnées de création (logiciel, opérateur, organisation). |
Exceptions
| Exception | Cause |
|---|---|
| ISOfParseError | JSON invalide ou structure ISOF non reconnue. |
| ISOfVersionError | Version du format non supportée par cette version du package. |
| ISOfSignatureError | Erreur lors de la vérification de signature (distinct d'une signature invalide). |
Implémenter un lecteur ISOF
N'importe quel logiciel peut implémenter un lecteur ISOF sans dépendance au package Python. Le format est du JSON standard avec les règles suivantes :
Les champs isof_version, created_at et samples sont les seuls obligatoires. Tous les autres champs sont optionnels. Les champs inconnus doivent être ignorés (extensibilité future). L'encodage est UTF-8 obligatoire. Les nombres flottants suivent la représentation JSON standard (pas de virgule décimale locale, pas de guillemets).
Vérification niveau 1 en 4 lignes Python
import json, hashlib
doc = json.loads(raw_text)
sig = doc["signature"]
scope = sig["scope"]
payload = {k: doc[k] for k in scope if k in doc}
digest = hashlib.sha256(
json.dumps(payload, sort_keys=True, separators=(",", ":"), ensure_ascii=False).encode("utf-8")
).hexdigest()
valid = digest == sig["hash"]
La sérialisation canonique doit utiliser sort_keys=True et separators=(",", ":") (sans espaces). Un espace de trop ou un ordre de clés différent produit un hash différent et invalide la signature.
Spécification technique
La spécification complète du format ISOF v1.0 est disponible sur isofind.tech/isof-spec. Elle couvre la structure JSON, les types de données, le format des blocs samples, methods, purification et signature, les règles de canonicalisation, et la feuille de route des versions futures.
Pour signaler un problème de compatibilité entre votre implémentation et IsoFind, ou proposer une extension au format, ouvrir une issue sur github.com/ColinFerrari/isof ou contacter colin.ferrari@isofind.tech.