Dépôts .ok

depots

Suivi des dépôts de fichiers et de leurs marqueurs .ok.

Protocole : l'émetteur dépose le .xml, puis, une fois celui-ci écrit intégralement, un fichier .ok vide de même nom. Le destinataire ne traite un .xml qu'une fois son .ok présent. Avec fichier_ok=True, les fonctions write_* appliquent ce protocole ; read_*(..., exiger_ok=True) ne lit que les dépôts terminés.

suivi_depots

suivi_depots(
    fichiers: Sources,
    *,
    extension_ok: str = ".ok",
    backend: str = "polars",
) -> Table

État des dépôts : quels .xml ont leur .ok, lesquels sont encore incomplets.

Côté émetteur, la fonction vérifie que tout a été déposé ; côté destinataire, elle indique ce qui est prêt à être traité.

Parameters:

Name	Type	Description	Default
fichiers	Sources	dossier, motif glob ou liste de .xml.	required
extension_ok	str	extension des fichiers marqueurs.	'.ok'
backend	str	"polars" ou "pandas".	'polars'

Returns:

Type	Description
Table	Une ligne par fichier, avec evt_id (nom sans extension, même clé que les
Table	tables de lecture), fichier, date_xml, complet (le .ok est
Table	présent) et date_ok (dates de modification des fichiers). Les .ok d'un
Table	dossier qui n'ont pas de .xml correspondant sont ajoutés avec fichier nul
Table	et complet faux.