Passer au contenu principal

​
class File

Fichier enregistré dans W&B. Représente un fichier unique stocké dans W&B. Donne accès aux métadonnées du fichier. Les fichiers sont associés à un run spécifique et peuvent inclure des fichiers texte, des poids de modèle, des jeux de données, des visualisations et d’autres Artifacts. Vous pouvez télécharger le fichier, le supprimer et accéder à ses propriétés. Spécifiez un ou plusieurs attributs dans un dictionnaire pour identifier un fichier spécifique enregistré dans un run spécifique. Vous pouvez effectuer une recherche à l’aide des clés suivantes :
  • id (str) : ID du run qui contient le fichier
  • name (str) : nom du fichier
  • url (str) : chemin vers le fichier
  • direct_url (str) : chemin vers le fichier dans le bucket
  • sizeBytes (int) : taille du fichier en octets
  • md5 (str) : md5 du fichier
  • mimetype (str) : type MIME du fichier
  • updated_at (str) : horodatage de la dernière mise à jour
  • path_uri (str) : chemin vers le fichier dans le bucket, actuellement disponible uniquement pour les objets S3 et les fichiers de référence
Arguments :
  • client: L’objet run qui contient le fichier
  • attrs (dict): Un dictionnaire d’attributs qui définissent le fichier
  • run: L’objet run qui contient le fichier

​
propriété File.path_uri

Renvoie le chemin URI du fichier dans le bucket de stockage. Retourne :
  • str : L’URI S3 (par ex., ‘s3://bucket/path/to/file’) si le fichier est stocké dans S3, l’URL directe s’il s’agit d’un fichier de référence, ou une chaîne vide s’il est indisponible.
Retourne :
  • str : La valeur de propriété path_uri.

​
propriété File.size

Renvoie la taille du fichier en octets. Retourne :
  • int: La valeur de la propriété size.

​
méthode File.delete

delete() → None
Supprimez le fichier du serveur W&B.

​
méthode File.download

download(
    root: 'str' = '.',
    replace: 'bool' = False,
    exist_ok: 'bool' = False,
    api: 'Api | None' = None
) → io.TextIOWrapper
Télécharge un fichier précédemment enregistré par un run depuis le serveur wandb. Arguments :
  • root : Répertoire local où enregistrer le fichier. La valeur par défaut est le répertoire de travail actuel (”.”).
  • replace : Si True, le téléchargement écrase un fichier local s’il existe. La valeur par défaut est False.
  • exist_ok : Si True, ne déclenche pas de ValueError si le fichier existe déjà et ne le retélécharge pas, sauf si replace=True. La valeur par défaut est False.
  • api : Si spécifié, l’instance Api utilisée pour télécharger le fichier.
Exceptions levées : ValueError si le fichier existe déjà, replace=False et exist_ok=False.