Riferimento per ultralytics/utils/downloads.py
Nota
Questo file è disponibile su https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/utils/downloads .py. Se noti un problema, contribuisci a risolverlo inviando una Pull Request 🛠️. Grazie 🙏!
ultralytics.utils.downloads.is_url(url, check=False)
Convalida se la stringa data è un URL e, facoltativamente, controlla se l'URL esiste online.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
url |
str
|
La stringa da convalidare come URL. |
richiesto |
check |
bool
|
Se Vero, esegue un ulteriore controllo per verificare se l'URL esiste online. L'impostazione predefinita è Vero. |
False
|
Restituzione:
Tipo | Descrizione |
---|---|
bool
|
Restituisce True se l'URL è valido. Se 'check' è True, restituisce anche True se l'URL esiste online. Altrimenti restituisce False. |
Codice sorgente in ultralytics/utils/downloads.py
ultralytics.utils.downloads.delete_dsstore(path, files_to_delete=('.DS_Store', '__MACOSX'))
Elimina tutti i file ".DS_store" in una directory specificata.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
path |
str
|
Il percorso della directory in cui i file ".DS_store" devono essere eliminati. |
richiesto |
files_to_delete |
tuple
|
I file da eliminare. |
('.DS_Store', '__MACOSX')
|
Nota
I file ".DS_store" sono creati dal sistema operativo Apple e contengono metadati su cartelle e file. Sono sono file di sistema nascosti e possono causare problemi durante il trasferimento di file tra sistemi operativi diversi.
Codice sorgente in ultralytics/utils/downloads.py
ultralytics.utils.downloads.zip_directory(directory, compress=True, exclude=('.DS_Store', '__MACOSX'), progress=True)
Esegue lo zip del contenuto di una directory, escludendo i file che contengono stringhe nell'elenco delle esclusioni. Il file zip risultante viene chiamato con il nome della directory e posizionato accanto ad essa.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
directory |
str | Path
|
Il percorso della directory da zippare. |
richiesto |
compress |
bool
|
Se comprimere i file durante lo zippaggio. Il valore predefinito è Vero. |
True
|
exclude |
tuple
|
Una tupla di stringhe di nomi di file da escludere. Il valore predefinito è ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
progress |
bool
|
Se visualizzare una barra di avanzamento. Il valore predefinito è Vero. |
True
|
Restituzione:
Tipo | Descrizione |
---|---|
Path
|
Il percorso del file zip risultante. |
Codice sorgente in ultralytics/utils/downloads.py
ultralytics.utils.downloads.unzip_file(file, path=None, exclude=('.DS_Store', '__MACOSX'), exist_ok=False, progress=True)
Decomprime un file *.zip nel percorso specificato, escludendo i file contenenti stringhe nell'elenco di esclusione.
Se il file zip non contiene una singola directory di primo livello, la funzione creerà una nuova directory con lo stesso nome del file zip (senza estensione) per estrarne il contenuto. con lo stesso nome del file zip (senza estensione) per estrarne il contenuto. Se non viene fornito un percorso, la funzione utilizzerà la directory principale del file zip come percorso predefinito.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
file |
str
|
Il percorso del file zip da estrarre. |
richiesto |
path |
str
|
Il percorso in cui estrarre il file zip. Il valore predefinito è Nessuno. |
None
|
exclude |
tuple
|
Una tupla di stringhe di nomi di file da escludere. Il valore predefinito è ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
exist_ok |
bool
|
Se sovrascrivere o meno i contenuti esistenti. L'impostazione predefinita è False. |
False
|
progress |
bool
|
Se visualizzare una barra di avanzamento. Il valore predefinito è Vero. |
True
|
Aumenta:
Tipo | Descrizione |
---|---|
BadZipFile
|
Se il file fornito non esiste o non è un file zip valido. |
Restituzione:
Tipo | Descrizione |
---|---|
Path
|
Il percorso della directory in cui è stato estratto il file zip. |
Codice sorgente in 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)
Controlla se lo spazio su disco è sufficiente per scaricare e memorizzare un file.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
url |
str
|
L'URL del file. Il valore predefinito è 'https://ultralytics.com/assets/coco128.zip'. |
'https://ultralytics.com/assets/coco128.zip'
|
path |
str | Path
|
Il percorso o l'unità su cui controllare lo spazio libero disponibile. |
cwd()
|
sf |
float
|
Fattore di sicurezza, il moltiplicatore dello spazio libero richiesto. Il valore predefinito è 2.0. |
1.5
|
hard |
bool
|
Se lanciare o meno un errore in caso di spazio su disco insufficiente. Il valore predefinito è Vero. |
True
|
Restituzione:
Tipo | Descrizione |
---|---|
bool
|
Vero se lo spazio su disco è sufficiente, Falso altrimenti. |
Codice sorgente in ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_google_drive_file_info(link)
Recupera il link diretto per il download e il nome del file di un file condivisibile di Google Drive.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
link |
str
|
Il link condivisibile del file di Google Drive. |
richiesto |
Restituzione:
Tipo | Descrizione |
---|---|
str
|
URL di download diretto del file di Google Drive. |
str
|
Nome originale del file di Google Drive. Se l'estrazione del nome del file non riesce, restituisce Nessuno. |
Esempio
Codice sorgente in 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)
Scarica i file da un URL, con opzioni per riprovare, decomprimere ed eliminare il file scaricato.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
url |
str
|
L'URL del file da scaricare. |
richiesto |
file |
str
|
Il nome del file scaricato. Se non viene fornito, il file verrà salvato con lo stesso nome dell'URL. |
None
|
dir |
str
|
La directory in cui salvare il file scaricato. Se non viene fornita, il file verrà salvato nella directory di lavoro corrente. |
None
|
unzip |
bool
|
Se decomprimere o meno il file scaricato. Predefinito: Vero. |
True
|
delete |
bool
|
Se eliminare il file scaricato dopo la decompressione. Predefinito: Falso. |
False
|
curl |
bool
|
Se utilizzare lo strumento da riga di comando curl per il download. Predefinito: Falso. |
False
|
retry |
int
|
Il numero di volte in cui riprovare il download in caso di fallimento. Predefinito: 3. |
3
|
min_bytes |
float
|
Il numero minimo di byte che il file scaricato deve avere, per essere considerato un download riuscito. Valore predefinito: 1E0. |
1.0
|
exist_ok |
bool
|
Se sovrascrivere il contenuto esistente durante la decompressione. L'impostazione predefinita è False. |
False
|
progress |
bool
|
Se visualizzare una barra di avanzamento durante il download. Predefinito: Vero. |
True
|
Esempio
Codice sorgente in 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)
Recupera il tag e le risorse della versione specificata da un repository GitHub. Se la versione non è specificata, la funzione recupera le risorse dell'ultima versione.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
repo |
str
|
Il repository GitHub nel formato 'owner/repo'. Il valore predefinito è 'ultralytics/assets'. |
'ultralytics/assets'
|
version |
str
|
La versione della release da cui prelevare le risorse. Il valore predefinito è "latest". |
'latest'
|
retry |
bool
|
Flag per riprovare la richiesta in caso di fallimento. L'impostazione predefinita è False. |
False
|
Restituzione:
Tipo | Descrizione |
---|---|
tuple
|
Una tupla contenente il tag release e un elenco di nomi di risorse. |
Codice sorgente in ultralytics/utils/downloads.py
ultralytics.utils.downloads.attempt_download_asset(file, repo='ultralytics/assets', release='v8.2.0', **kwargs)
Tenta di scaricare un file dalle risorse di rilascio di GitHub se non viene trovato localmente. La funzione verifica la presenza del file localmente, quindi tenta di scaricarlo dalla release del repository GitHub specificato.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
file |
str | Path
|
Il nome del file o il percorso del file da scaricare. |
richiesto |
repo |
str
|
Il repository GitHub nel formato 'owner/repo'. Il valore predefinito è 'ultralytics/assets'. |
'ultralytics/assets'
|
release |
str
|
La versione specifica della release da scaricare. Il valore predefinito è "v8.2.0". |
'v8.2.0'
|
**kwargs |
any
|
Argomenti aggiuntivi per il processo di download. |
{}
|
Restituzione:
Tipo | Descrizione |
---|---|
str
|
Il percorso del file scaricato. |
Esempio
Codice sorgente in 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)
Scarica i file dagli URL specificati in una determinata directory. Supporta i download simultanei se vengono specificati più thread. specificati.
Parametri:
Nome | Tipo | Descrizione | Predefinito |
---|---|---|---|
url |
str | list
|
L'URL o l'elenco di URL dei file da scaricare. |
richiesto |
dir |
Path
|
La directory in cui verranno salvati i file. La scelta predefinita è la directory di lavoro corrente. |
cwd()
|
unzip |
bool
|
Flag per decomprimere i file dopo il download. Il valore predefinito è Vero. |
True
|
delete |
bool
|
Flag per eliminare i file zip dopo l'estrazione. L'impostazione predefinita è False. |
False
|
curl |
bool
|
Flag per utilizzare curl per il download. Il valore predefinito è False. |
False
|
threads |
int
|
Numero di thread da utilizzare per i download contemporanei. Il valore predefinito è 1. |
1
|
retry |
int
|
Numero di tentativi in caso di fallimento del download. Il valore predefinito è 3. |
3
|
exist_ok |
bool
|
Se sovrascrivere il contenuto esistente durante la decompressione. L'impostazione predefinita è False. |
False
|