Skip to content

transfert

diapason.mesh.transfert

Le transfert de fichiers entre appareils : le cœur, sans réseau.

Spatial Mesh, phase 3 — 25 août 2026. Le maillage était un maillage de COMMANDES : des enveloppes sans état, courtes, qui expirent. Un fichier ne rentre pas là-dedans, et le cahier des charges l'interdit explicitement — ajouter un champ à l'enveloppe signée invaliderait toutes les signatures du client mobile. Le transfert a donc sa propre session, son propre cycle de vie, ses propres routes.

Ce module ne parle à personne : il décrit un transfert, découpe, vérifie, assainit, et recoud. Tout ce qui touche au réseau ou au disque est injecté ou vit ailleurs, pour que la logique se teste sans machine en face.

Trois règles qui viennent de vraies erreurs :

  1. Jamais tout en mémoire. Un fichier d'un gigaoctet lu d'un bloc, c'est un gigaoctet de RAM sur une machine qui fait tourner un modèle de langue.
  2. Le nom reçu est une donnée hostile, pas un chemin. « ../../.ssh/ authorized_keys » est un nom de fichier parfaitement valide côté émetteur.
  3. Rien n'est visible avant d'être entier. Un fichier partiel qui porte déjà son nom final sera ouvert par quelqu'un, un jour, au milieu d'un transfert.

Manifeste dataclass

Ce qu'on annonce AVANT d'envoyer un octet.

Le récepteur décide sur cette annonce seule : trop gros, nom refusé, déjà présent. Refuser après coup, c'est avoir déjà payé le transfert.

Reception dataclass

Un transfert en cours de réception, repris là où il s'était arrêté.

Les morceaux vont dans un fichier « .partiel » qui ne porte PAS le nom final : rien n'est visible avant d'être entier et vérifié.

manquants property

Ce que l'émetteur doit (re)envoyer — la reprise tient là-dedans.

ecrire(index, octets)

Poser un morceau à sa place. Rejouer le même morceau est inoffensif.

finaliser()

Vérifier l'intégrité, puis rendre le fichier visible d'un seul coup.

L'empreinte est recalculée sur ce qui est RÉELLEMENT sur le disque : faire confiance au compte des morceaux reviendrait à croire l'émetteur sur parole.

RefusDeTransfert

Bases: ValueError

Le transfert est refusé, et le message dit pourquoi à un humain.

assainir_nom(brut)

Un nom de fichier sûr, dérivé d'un nom reçu qu'on suppose hostile.

« ../../.ssh/authorized_keys » est un nom parfaitement valide pour l'émetteur : c'est au récepteur de refuser d'y croire.

decrire_fichier(chemin, *, taille_morceau=TAILLE_MORCEAU)

Le manifeste d'un fichier local — lu par blocs, jamais d'un coup.

deja_present(manifeste, dossier, *, taille_morceau=TAILLE_MORCEAU)

Le fichier est-il déjà là, au même contenu ? (§45, déduplication.)

Compare les empreintes, jamais les noms : deux fichiers de même nom peuvent différer, et deux noms différents porter le même contenu.

lire_morceaux(chemin, *, taille_morceau=TAILLE_MORCEAU)

(index, octets) — un fichier ne passe jamais entièrement en mémoire.

nom_libre(dossier, nom)

Un chemin qui n'écrase rien : « photo.jpg », puis « photo (2).jpg ».

Écraser un fichier existant serait une perte de données décidée par quelqu'un d'autre que son propriétaire.

ouvrir_reception(manifeste, dossier, *, session_id, taille_max=TAILLE_MAX_DEFAUT, taille_morceau=TAILLE_MORCEAU)

Préparer la réception d'un fichier annoncé — refus avant tout octet.

verifier_le_manifeste(manifeste, *, taille_max=TAILLE_MAX_DEFAUT)

Tout ce qu'on peut refuser AVANT le premier octet.