> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# File
export const GitHubLink = ({url}) =>
Source GitHub
;
## 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 :**
* `service_api`: L’instance de l’API de service à utiliser pour interroger W\&B.
* `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`
```python theme={null}
delete() → None
```
Supprimez le fichier du serveur W\&B.
***
### méthode `File.download`
```python theme={null}
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`.