Referans için ultralytics/utils/downloads.py
Not
Bu dosya https://github.com/ultralytics/ultralytics/blob/main/ ultralytics/utils/downloads .py adresinde mevcuttur. Bir sorun tespit ederseniz lütfen bir Çekme İsteği 🛠️ ile katkıda bulunarak düzeltilmesine yardımcı olun. Teşekkürler 🙏!
ultralytics.utils.downloads.is_url(url, check=False)
Verilen dizenin bir URL olup olmadığını doğrular ve isteğe bağlı olarak URL'nin çevrimiçi olarak var olup olmadığını kontrol eder.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
url |
str
|
URL olarak doğrulanacak dize. |
gerekli |
check |
bool
|
True ise, URL'nin çevrimiçi olarak mevcut olup olmadığını görmek için ek bir kontrol gerçekleştirir. Varsayılan değer True'dur. |
False
|
İade:
Tip | Açıklama |
---|---|
bool
|
Geçerli bir URL için True döndürür. 'check' True ise, URL çevrimiçi olarak mevcutsa True döndürür. Aksi takdirde False döndürür. |
Kaynak kodu ultralytics/utils/downloads.py
ultralytics.utils.downloads.delete_dsstore(path, files_to_delete=('.DS_Store', '__MACOSX'))
Belirtilen bir dizin altındaki tüm ".DS_store" dosyalarını siler.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
path |
str
|
".DS_store" dosyalarının silinmesi gereken dizin yolu. |
gerekli |
files_to_delete |
tuple
|
Silinecek dosyalar. |
('.DS_Store', '__MACOSX')
|
Not
".DS_store" dosyaları Apple işletim sistemi tarafından oluşturulur ve klasörler ve dosyalar hakkında meta veriler içerir. Onlar gizli sistem dosyalarıdır ve farklı işletim sistemleri arasında dosya aktarırken sorunlara neden olabilir.
Kaynak kodu ultralytics/utils/downloads.py
ultralytics.utils.downloads.zip_directory(directory, compress=True, exclude=('.DS_Store', '__MACOSX'), progress=True)
Dışlama listesindeki dizeleri içeren dosyaları hariç tutarak bir dizinin içeriğini zipler. Sonuçta ortaya çıkan zip dosyası dizinin adını alır ve dizinin yanına yerleştirilir.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
directory |
str | Path
|
Sıkıştırılacak dizinin yolu. |
gerekli |
compress |
bool
|
Sıkıştırma sırasında dosyaların sıkıştırılıp sıkıştırılmayacağı. Varsayılan değer True'dur. |
True
|
exclude |
tuple
|
Hariç tutulacak dosya adı dizelerinin bir demeti. Varsayılan değer ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
progress |
bool
|
İlerleme çubuğu görüntülenip görüntülenmeyeceği. Varsayılan değer True'dur. |
True
|
İade:
Tip | Açıklama |
---|---|
Path
|
Ortaya çıkan zip dosyasının yolu. |
Kaynak kodu ultralytics/utils/downloads.py
ultralytics.utils.downloads.unzip_file(file, path=None, exclude=('.DS_Store', '__MACOSX'), exist_ok=False, progress=True)
Dışlama listesindeki dizeleri içeren dosyaları hariç tutarak bir *.zip dosyasını belirtilen yola açar.
Eğer zip dosyası tek bir üst düzey dizin içermiyorsa, fonksiyon yeni bir içeriğini ayıklamak için zip dosyasıyla aynı ada sahip (uzantısı olmayan) dizin. Bir yol belirtilmezse, fonksiyon varsayılan yol olarak zip dosyasının üst dizinini kullanır.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
file |
str
|
Çıkarılacak zip dosyasının yolu. |
gerekli |
path |
str
|
Zip dosyasının çıkarılacağı yol. Varsayılan değer Yok'tur. |
None
|
exclude |
tuple
|
Hariç tutulacak dosya adı dizelerinin bir demeti. Varsayılan değer ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
exist_ok |
bool
|
Mevcut içerik varsa üzerine yazılıp yazılmayacağı. Varsayılan değer False'dir. |
False
|
progress |
bool
|
İlerleme çubuğu görüntülenip görüntülenmeyeceği. Varsayılan değer True'dur. |
True
|
Zamlar:
Tip | Açıklama |
---|---|
BadZipFile
|
Sağlanan dosya mevcut değilse veya geçerli bir zip dosyası değilse. |
İade:
Tip | Açıklama |
---|---|
Path
|
Zip dosyasının çıkarıldığı dizinin yolu. |
Kaynak kodu 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)
Bir dosyayı indirmek ve saklamak için yeterli disk alanı olup olmadığını kontrol edin.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
url |
str
|
Dosyanın URL'si. Varsayılan değer 'https://ultralytics.com/assets/coco128.zip' şeklindedir. |
'https://ultralytics.com/assets/coco128.zip'
|
path |
str | Path
|
Kullanılabilir boş alanın kontrol edileceği yol veya sürücü. |
cwd()
|
sf |
float
|
Güvenlik faktörü, gerekli boş alan için çarpan. Varsayılan değer 2,0'dır. |
1.5
|
hard |
bool
|
Yetersiz disk alanı durumunda hata verilip verilmeyeceği. Varsayılan değer True'dur. |
True
|
İade:
Tip | Açıklama |
---|---|
bool
|
Yeterli disk alanı varsa True, aksi takdirde False. |
Kaynak kodu ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_google_drive_file_info(link)
Paylaşılabilir bir Google Drive dosya bağlantısı için doğrudan indirme bağlantısını ve dosya adını alır.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
link |
str
|
Google Drive dosyasının paylaşılabilir bağlantısı. |
gerekli |
İade:
Tip | Açıklama |
---|---|
str
|
Google Drive dosyası için doğrudan indirme URL'si. |
str
|
Google Drive dosyasının orijinal dosya adı. Dosya adı çıkarma işlemi başarısız olursa None döndürür. |
Örnek
Kaynak kodu 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)
İndirilen dosyayı yeniden deneme, sıkıştırmayı açma ve silme seçenekleriyle birlikte bir URL'den dosya indirir.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
url |
str
|
İndirilecek dosyanın URL'si. |
gerekli |
file |
str
|
İndirilen dosyanın dosya adı. Sağlanmazsa, dosya URL ile aynı adla kaydedilecektir. |
None
|
dir |
str
|
İndirilen dosyanın kaydedileceği dizin. Belirtilmezse, dosya geçerli çalışma dizinine kaydedilir. |
None
|
unzip |
bool
|
İndirilen dosyanın açılıp açılmayacağı. Varsayılan değer: Doğru. |
True
|
delete |
bool
|
İndirilen dosyanın açıldıktan sonra silinip silinmeyeceği. Varsayılan değer: Yanlış. |
False
|
curl |
bool
|
İndirme için curl komut satırı aracının kullanılıp kullanılmayacağı. Varsayılan değer: False. |
False
|
retry |
int
|
Başarısızlık durumunda indirmenin yeniden deneneceği sayı. Varsayılan: 3. |
3
|
min_bytes |
float
|
İndirilen dosyanın dikkate alınması için sahip olması gereken minimum bayt sayısı başarılı bir indirme. Varsayılan: 1E0. |
1.0
|
exist_ok |
bool
|
Açma sırasında mevcut içeriğin üzerine yazılıp yazılmayacağı. Varsayılan değer False'dir. |
False
|
progress |
bool
|
İndirme sırasında bir ilerleme çubuğu görüntülenip görüntülenmeyeceği. Varsayılan değer: Doğru. |
True
|
Örnek
Kaynak kodu 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)
Belirtilen sürümün etiketini ve varlıklarını bir GitHub deposundan alır. Sürüm belirtilmemişse işlevi en son sürüm varlıklarını getirir.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
repo |
str
|
GitHub deposu 'owner/repo' biçiminde. Varsayılan olarak 'ultralytics/assets'. |
'ultralytics/assets'
|
version |
str
|
Varlıkların getirileceği sürüm. Varsayılan değer 'en son'. |
'latest'
|
retry |
bool
|
Başarısızlık durumunda isteği yeniden denemek için bayrak. Varsayılan değer False'dir. |
False
|
İade:
Tip | Açıklama |
---|---|
tuple
|
Sürüm etiketini ve varlık adlarının listesini içeren bir tuple. |
Kaynak kodu ultralytics/utils/downloads.py
ultralytics.utils.downloads.attempt_download_asset(file, repo='ultralytics/assets', release='v8.2.0', **kwargs)
Yerel olarak bulunamazsa GitHub sürüm varlıklarından bir dosya indirmeyi deneyin. Fonksiyon dosyayı kontrol eder önce yerel olarak, ardından belirtilen GitHub deposu sürümünden indirmeye çalışır.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
file |
str | Path
|
İndirilecek dosya adı veya dosya yolu. |
gerekli |
repo |
str
|
GitHub deposu 'owner/repo' biçiminde. Varsayılan olarak 'ultralytics/assets'. |
'ultralytics/assets'
|
release |
str
|
İndirilecek belirli sürüm versiyonu. Varsayılan olarak 'v8.2.0'. |
'v8.2.0'
|
**kwargs |
any
|
İndirme işlemi için ek anahtar kelime argümanları. |
{}
|
İade:
Tip | Açıklama |
---|---|
str
|
İndirilen dosyanın yolu. |
Kaynak kodu 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)
Dosyaları belirtilen URL'lerden belirli bir dizine indirir. Birden fazla iş parçacığı varsa eşzamanlı indirmeleri destekler belirtilmiş.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
url |
str | list
|
İndirilecek dosyaların URL'si veya URL'lerin listesi. |
gerekli |
dir |
Path
|
Dosyaların kaydedileceği dizin. Varsayılan değer geçerli çalışma dizinidir. |
cwd()
|
unzip |
bool
|
İndirdikten sonra dosyaları açmak için bayrak. Varsayılan değer True'dur. |
True
|
delete |
bool
|
Çıkarma işleminden sonra zip dosyalarını silmek için bayrak. Varsayılan değer False'dir. |
False
|
curl |
bool
|
İndirme için curl kullanma bayrağı. Varsayılan değer False'dir. |
False
|
threads |
int
|
Eşzamanlı indirmeler için kullanılacak iş parçacığı sayısı. Varsayılan değer 1'dir. |
1
|
retry |
int
|
İndirme başarısızlığı durumunda yeniden deneme sayısı. Varsayılan değer 3'tür. |
3
|
exist_ok |
bool
|
Açma sırasında mevcut içeriğin üzerine yazılıp yazılmayacağı. Varsayılan değer False'dir. |
False
|
Kaynak kodu ultralytics/utils/downloads.py
Oluşturuldu 2023-11-12, Güncellendi 2024-05-08
Yazarlar: Burhan-Q (1), glenn-jocher (3), Laughing-q (1)