Aller au contenu
EN FR

Adaptateur de processus STDIO

Statut documentaire : architecture — voir Maturité et preuves.

Rôle

Un adaptateur STDIO connecte logiCells à un processus enfant ou à un moteur externe via l'entrée et la sortie standard. Il est utile lorsque le programme externe expose déjà un protocole orienté flux, par exemple JSON-RPC ou un protocole de type language server.

Architecture

capacité logiCells
    -> adaptateur de processus
    -> framing stdin/stdout
    -> processus externe

Règles de conception

  • STDIO n'est qu'un flux d'octets/texte : définir explicitement framing et corrélation des requêtes ;
  • séparer le cycle de vie du processus de celui des objets métier ;
  • propager la cancellation lorsque le protocole externe la supporte ;
  • séparer stderr du stdout protocolaire lorsque c'est possible ;
  • distinguer crash du processus, sortie malformée, timeout et erreur de protocole ;
  • ne pas supposer que JSON-RPC, LSP ou un autre protocole est implicite du seul fait d'utiliser STDIO.

Statut

Le contrat architectural public est la frontière processus/flux. Les noms de moteurs, identifiants serveur et clés de configuration sont propres aux adaptateurs et doivent être validés contre le module installé.