Référence pour ultralytics/utils/downloads.py
Note
Ce fichier est disponible à l'adresse https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/utils/downloads .py. Si tu repères un problème, aide à le corriger en contribuant à une Pull Request 🛠️. Merci 🙏 !
ultralytics.utils.downloads.is_url(url, check=False)
Valide si la chaîne donnée est une URL et vérifie éventuellement si l'URL existe en ligne.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
url |
str
|
La chaîne à valider en tant qu'URL. |
requis |
check |
bool
|
Si True, effectue une vérification supplémentaire pour voir si l'URL existe en ligne. La valeur par défaut est True. |
False
|
Retourne :
Type | Description |
---|---|
bool
|
Renvoie True si l'URL est valide. Si 'check' est True, il renvoie Ă©galement True si l'URL existe en ligne. Renvoie False dans le cas contraire. |
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.delete_dsstore(path, files_to_delete=('.DS_Store', '__MACOSX'))
Supprime tous les fichiers ".DS_store" sous un répertoire spécifié.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
path |
str
|
Le chemin du répertoire où les fichiers ".DS_store" doivent être supprimés. |
requis |
files_to_delete |
tuple
|
Les fichiers Ă supprimer. |
('.DS_Store', '__MACOSX')
|
Note
".DS_store" sont créés par le système d'exploitation Apple et contiennent des métadonnées sur les dossiers et les fichiers. Ils sont des fichiers système cachés et peuvent causer des problèmes lors du transfert de fichiers entre différents systèmes d'exploitation.
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.zip_directory(directory, compress=True, exclude=('.DS_Store', '__MACOSX'), progress=True)
Zippe le contenu d'un répertoire, en excluant les fichiers contenant des chaînes de caractères dans la liste d'exclusion. Le fichier zip résultant est nommé d'après le répertoire et placé à côté de lui.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
directory |
str | Path
|
Le chemin d'accès au répertoire à zipper. |
requis |
compress |
bool
|
S'il faut compresser les fichiers lors de la compression. La valeur par défaut est True. |
True
|
exclude |
tuple
|
Un tuple de chaînes de noms de fichiers à exclure. La valeur par défaut est ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
progress |
bool
|
Affiche ou non une barre de progression. La valeur par défaut est True. |
True
|
Retourne :
Type | Description |
---|---|
Path
|
Le chemin d'accès au fichier zip résultant. |
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.unzip_file(file, path=None, exclude=('.DS_Store', '__MACOSX'), exist_ok=False, progress=True)
Décompresse un fichier *.zip dans le chemin spécifié, en excluant les fichiers contenant des chaînes de caractères dans la liste d'exclusion.
Si le fichier zip ne contient pas de répertoire de premier niveau, la fonction créera un nouveau répertoire portant le même nom que le fichier zip (sans l'extension) pour en extraire le contenu. portant le même nom que le fichier zip (sans l'extension) pour en extraire le contenu. Si aucun chemin d'accès n'est fourni, la fonction utilisera le répertoire parent du fichier zip comme chemin d'accès par défaut.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
file |
str
|
Le chemin d'accès au fichier zip à extraire. |
requis |
path |
str
|
Le chemin d'accès pour extraire le fichier zip. La valeur par défaut est None. |
None
|
exclude |
tuple
|
Un tuple de chaînes de noms de fichiers à exclure. La valeur par défaut est ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
exist_ok |
bool
|
S'il faut écraser le contenu existant s'il existe. La valeur par défaut est False. |
False
|
progress |
bool
|
Affiche ou non une barre de progression. La valeur par défaut est True. |
True
|
Augmente :
Type | Description |
---|---|
BadZipFile
|
Si le fichier fourni n'existe pas ou n'est pas un fichier zip valide. |
Retourne :
Type | Description |
---|---|
Path
|
Le chemin d'accès au répertoire où le fichier zip a été extrait. |
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.check_disk_space(url='https://ultralytics.com/assets/coco128.zip', path=Path.cwd(), sf=1.5, hard=True)
Vérifie s'il y a suffisamment d'espace disque pour télécharger et stocker un fichier.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
url |
str
|
L'URL du fichier. La valeur par défaut est 'https://ultralytics.com/assets/coco128.zip'. |
'https://ultralytics.com/assets/coco128.zip'
|
path |
str | Path
|
Le chemin ou le lecteur sur lequel vérifier l'espace libre disponible. |
cwd()
|
sf |
float
|
Facteur de sécurité, le multiplicateur de l'espace libre requis. La valeur par défaut est 2,0. |
1.5
|
hard |
bool
|
Lance ou non une erreur en cas d'espace disque insuffisant. La valeur par défaut est True. |
True
|
Retourne :
Type | Description |
---|---|
bool
|
Vrai si l'espace disque est suffisant, Faux sinon. |
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_google_drive_file_info(link)
Récupère le lien de téléchargement direct et le nom du fichier pour un lien de fichier Google Drive partageable.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
link |
str
|
Le lien partageable du fichier Google Drive. |
requis |
Retourne :
Type | Description |
---|---|
str
|
URL de téléchargement direct du fichier Google Drive. |
str
|
Nom de fichier original du fichier Google Drive. Si l'extraction du nom de fichier Ă©choue, renvoie None. |
Exemple
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.safe_download(url, file=None, dir=None, unzip=True, delete=False, curl=False, retry=3, min_bytes=1.0, exist_ok=False, progress=True)
Télécharge des fichiers à partir d'une URL, avec des options pour réessayer, décompresser et supprimer le fichier téléchargé.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
url |
str
|
L'URL du fichier à télécharger. |
requis |
file |
str
|
Le nom du fichier téléchargé. S'il n'est pas fourni, le fichier sera enregistré sous le même nom que l'URL. |
None
|
dir |
str
|
Le répertoire dans lequel enregistrer le fichier téléchargé. S'il n'est pas fourni, le fichier sera enregistré dans le répertoire de travail actuel. |
None
|
unzip |
bool
|
Indique s'il faut décompresser le fichier téléchargé. Par défaut : True. |
True
|
delete |
bool
|
S'il faut supprimer le fichier téléchargé après l'avoir décompressé. Par défaut : Faux. |
False
|
curl |
bool
|
Utiliser ou non l'outil de ligne de commande curl pour le téléchargement. Par défaut : Faux. |
False
|
retry |
int
|
Le nombre de fois où il faut réessayer le téléchargement en cas d'échec. Valeur par défaut : 3. |
3
|
min_bytes |
float
|
Le nombre minimum d'octets que le fichier téléchargé doit contenir pour que le téléchargement soit considéré comme réussi. un téléchargement réussi. Valeur par défaut : 1E0. |
1.0
|
exist_ok |
bool
|
Si le contenu existant doit être écrasé lors de la décompression. La valeur par défaut est False. |
False
|
progress |
bool
|
Affiche ou non une barre de progression pendant le téléchargement. Par défaut : True. |
True
|
Exemple
Code source dans ultralytics/utils/downloads.py
274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 |
|
ultralytics.utils.downloads.get_github_assets(repo='ultralytics/assets', version='latest', retry=False)
Récupère la balise et les actifs de la version spécifiée à partir d'un dépôt GitHub. Si la version n'est pas spécifiée, la fonction récupère les actifs de la dernière version.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
repo |
str
|
Le dépôt GitHub au format 'owner/repo'. La valeur par défaut est 'ultralytics/assets'. |
'ultralytics/assets'
|
version |
str
|
La version à partir de laquelle les actifs doivent être récupérés. La valeur par défaut est "la plus récente". |
'latest'
|
retry |
bool
|
Drapeau permettant de réessayer la demande en cas d'échec. La valeur par défaut est False. |
False
|
Retourne :
Type | Description |
---|---|
tuple
|
Un tuple contenant l'Ă©tiquette de la version et une liste de noms d'actifs. |
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.attempt_download_asset(file, repo='ultralytics/assets', release='v8.2.0', **kwargs)
Tente de télécharger un fichier à partir de GitHub release assets s'il n'est pas trouvé localement. La fonction vérifie d'abord la présence du fichier localement, puis tente de le télécharger à partir du dépôt GitHub release spécifié.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
file |
str | Path
|
Le nom ou le chemin du fichier à télécharger. |
requis |
repo |
str
|
Le dépôt GitHub au format 'owner/repo'. La valeur par défaut est 'ultralytics/assets'. |
'ultralytics/assets'
|
release |
str
|
La version spécifique à télécharger. La valeur par défaut est "v8.2.0". |
'v8.2.0'
|
**kwargs |
any
|
Arguments de mots-clés supplémentaires pour le processus de téléchargement. |
{}
|
Retourne :
Type | Description |
---|---|
str
|
Le chemin d'accès au fichier téléchargé. |
Exemple
Code source dans ultralytics/utils/downloads.py
ultralytics.utils.downloads.download(url, dir=Path.cwd(), unzip=True, delete=False, curl=False, threads=1, retry=3, exist_ok=False)
Télécharge les fichiers des URL spécifiées dans un répertoire donné. Prend en charge les téléchargements simultanés si plusieurs threads sont spécifiées.
Paramètres :
Nom | Type | Description | DĂ©faut |
---|---|---|---|
url |
str | list
|
L'URL ou la liste des URL des fichiers à télécharger. |
requis |
dir |
Path
|
Le répertoire dans lequel les fichiers seront enregistrés. La valeur par défaut est le répertoire de travail actuel. |
cwd()
|
unzip |
bool
|
Drapeau pour décompresser les fichiers après le téléchargement. La valeur par défaut est True. |
True
|
delete |
bool
|
Drapeau pour supprimer les fichiers zip après l'extraction. La valeur par défaut est False. |
False
|
curl |
bool
|
Drapeau permettant d'utiliser curl pour le téléchargement. La valeur par défaut est False. |
False
|
threads |
int
|
Nombre de threads à utiliser pour les téléchargements simultanés. La valeur par défaut est 1. |
1
|
retry |
int
|
Nombre de tentatives en cas d'échec du téléchargement. La valeur par défaut est 3. |
3
|
exist_ok |
bool
|
Si le contenu existant doit être écrasé lors de la décompression. La valeur par défaut est False. |
False
|
Code source dans ultralytics/utils/downloads.py
Créé le 2023-11-12, Mis à jour le 2024-05-08
Auteurs : Burhan-Q (1), glenn-jocher (3), Laughing-q (1)