مرجع ل ultralytics/utils/downloads.py
ملاحظه
هذا الملف متاح في https://github.com/ultralytics/ultralytics/ نقطة / الرئيسية /ultralytics/ المرافق / downloads.py. إذا اكتشفت مشكلة ، فيرجى المساعدة في إصلاحها من خلال المساهمة في طلب 🛠️ سحب. شكرا لك 🙏!
ultralytics.utils.downloads.is_url(url, check=False)
يتحقق مما إذا كانت السلسلة المحددة عبارة عن عنوان URL ويتحقق اختياريا مما إذا كان عنوان URL موجودا عبر الإنترنت.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
url |
str
|
السلسلة المراد التحقق من صحتها كعنوان URL. |
مطلوب |
check |
bool
|
إذا كان True ، يقوم بإجراء فحص إضافي لمعرفة ما إذا كان عنوان URL موجودا عبر الإنترنت. الإعدادات الافتراضية إلى صواب. |
False
|
ارجاع:
نوع | وصف |
---|---|
bool
|
إرجاع True لعنوان URL صالح. إذا كان "check" هو True ، إرجاع True أيضا إذا كان عنوان URL موجودا عبر الإنترنت. إرجاع false خلاف ذلك. |
شفرة المصدر في ultralytics/utils/downloads.py
ultralytics.utils.downloads.delete_dsstore(path, files_to_delete=('.DS_Store', '__MACOSX'))
حذف جميع ملفات ".DS_store" ضمن دليل محدد.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
path |
str
|
مسار الدليل حيث يجب حذف ملفات ".DS_store". |
مطلوب |
files_to_delete |
tuple
|
الملفات المراد حذفها. |
('.DS_Store', '__MACOSX')
|
ملاحظه
يتم إنشاء ملفات ".DS_store" بواسطة نظام التشغيل Apple وتحتوي على بيانات وصفية حول المجلدات والملفات. هم هي ملفات نظام مخفية ويمكن أن تسبب مشكلات عند نقل الملفات بين أنظمة التشغيل المختلفة.
شفرة المصدر في ultralytics/utils/downloads.py
ultralytics.utils.downloads.zip_directory(directory, compress=True, exclude=('.DS_Store', '__MACOSX'), progress=True)
ضغط محتويات دليل، باستثناء الملفات التي تحتوي على سلاسل في قائمة الاستبعاد. الملف المضغوط الناتج هو سميت على اسم الدليل ووضعت بجانبه.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
directory |
str | Path
|
المسار إلى الدليل المراد ضغطه. |
مطلوب |
compress |
bool
|
سواء لضغط الملفات أثناء الضغط. الافتراضي هو صواب. |
True
|
exclude |
tuple
|
مجموعة من سلاسل اسم الملف المراد استبعادها. الإعدادات الافتراضية هي ('.DS_Store'، '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
progress |
bool
|
ما إذا كنت تريد عرض شريط تقدم. الإعدادات الافتراضية إلى صواب. |
True
|
ارجاع:
نوع | وصف |
---|---|
Path
|
المسار إلى الملف المضغوط الناتج. |
شفرة المصدر في ultralytics/utils/downloads.py
ultralytics.utils.downloads.unzip_file(file, path=None, exclude=('.DS_Store', '__MACOSX'), exist_ok=False, progress=True)
يفك ضغط ملف *.zip إلى المسار المحدد، باستثناء الملفات التي تحتوي على سلاسل في قائمة الاستبعاد.
إذا كان الملف المضغوط لا يحتوي على دليل واحد من المستوى الأعلى ، فستقوم الوظيفة بإنشاء ملف جديد دليل يحمل نفس اسم الملف المضغوط (بدون الامتداد) لاستخراج محتوياته. إذا لم يتم توفير مسار ، فستستخدم الوظيفة الدليل الأصل للملف المضغوط كمسار افتراضي.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
file |
str
|
المسار إلى الملف المضغوط المراد استخراجه. |
مطلوب |
path |
str
|
مسار استخراج الملف المضغوط إليه. الإعدادات الافتراضية إلى لا شيء. |
None
|
exclude |
tuple
|
مجموعة من سلاسل اسم الملف المراد استبعادها. الإعدادات الافتراضية هي ('.DS_Store'، '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
exist_ok |
bool
|
ما إذا كنت تريد الكتابة فوق المحتويات الموجودة إذا كانت موجودة. الإعدادات الافتراضية إلى خطأ. |
False
|
progress |
bool
|
ما إذا كنت تريد عرض شريط تقدم. الإعدادات الافتراضية إلى صواب. |
True
|
يثير:
نوع | وصف |
---|---|
BadZipFile
|
إذا كان الملف المقدم غير موجود أو لم يكن ملفا مضغوطا صالحا. |
ارجاع:
نوع | وصف |
---|---|
Path
|
المسار إلى الدليل حيث تم استخراج الملف المضغوط. |
شفرة المصدر في 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)
تحقق مما إذا كانت هناك مساحة قرص كافية لتنزيل ملف وتخزينه.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
url |
str
|
عنوان URL للملف. الإعدادات الافتراضية إلى 'https://ultralytics.com / الأصول / coco128.zip". |
'https://ultralytics.com/assets/coco128.zip'
|
path |
str | Path
|
المسار أو محرك الأقراص للتحقق من المساحة الخالية المتوفرة على. |
cwd()
|
sf |
float
|
عامل الأمان ، المضاعف للمساحة الحرة المطلوبة. الإعدادات الافتراضية هي 2.0. |
1.5
|
hard |
bool
|
سواء لرمي خطأ أم لا على مساحة القرص غير كافية. الإعدادات الافتراضية إلى صواب. |
True
|
ارجاع:
نوع | وصف |
---|---|
bool
|
صحيح إذا كان هناك مساحة كافية على القرص ، خطأ خلاف ذلك. |
شفرة المصدر في ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_google_drive_file_info(link)
يسترجع رابط التنزيل المباشر واسم الملف لرابط ملف Google Drive قابل للمشاركة.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
link |
str
|
الرابط القابل للمشاركة لملف Google Drive. |
مطلوب |
ارجاع:
نوع | وصف |
---|---|
str
|
عنوان URL للتنزيل المباشر لملف Google Drive. |
str
|
اسم الملف الأصلي لملف Google Drive. إذا فشل استخراج اسم الملف، ترجع بلا. |
مثل
شفرة المصدر في 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)
تنزيل الملفات من عنوان URL، مع خيارات لإعادة محاولة الملف الذي تم تنزيله وفك ضغطه وحذفه.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
url |
str
|
عنوان URL للملف المراد تنزيله. |
مطلوب |
file |
str
|
اسم ملف الملف الذي تم تنزيله. إذا لم يتم توفيره ، حفظ الملف بنفس اسم عنوان URL. |
None
|
dir |
str
|
الدليل لحفظ الملف الذي تم تنزيله. إذا لم يتم توفيره ، حفظ الملف في دليل العمل الحالي. |
None
|
unzip |
bool
|
ما إذا كنت تريد فك ضغط الملف الذي تم تنزيله. الافتراضي: صحيح. |
True
|
delete |
bool
|
ما إذا كنت تريد حذف الملف الذي تم تنزيله بعد فك ضغطه. الافتراضي: خطأ. |
False
|
curl |
bool
|
ما إذا كنت تريد استخدام أداة سطر الأوامر curl للتنزيل. الافتراضي: خطأ. |
False
|
retry |
int
|
عدد مرات إعادة محاولة التنزيل في حالة الفشل. الافتراضي: 3. |
3
|
min_bytes |
float
|
الحد الأدنى لعدد البايتات التي يجب أن يحتوي عليها الملف الذي تم تنزيله ، ليتم النظر فيه تنزيل ناجح. الافتراضي: 1E0. |
1.0
|
exist_ok |
bool
|
ما إذا كنت تريد الكتابة فوق المحتويات الموجودة أثناء فك الضغط. الإعدادات الافتراضية إلى خطأ. |
False
|
progress |
bool
|
ما إذا كنت تريد عرض شريط تقدم أثناء التنزيل. الافتراضي: صحيح. |
True
|
مثل
شفرة المصدر في ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_github_assets(repo='ultralytics/assets', version='latest', retry=False)
استرجع علامة الإصدار المحدد وأصوله من مستودع GitHub. إذا لم يتم تحديد الإصدار، فسيظهر الرمز وظيفة جلب أحدث أصول الإصدار.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
repo |
str
|
مستودع GitHub بتنسيق "المالك / الريبو". الإعدادات الافتراضية ل 'ultralytics/ الأصول'. |
'ultralytics/assets'
|
version |
str
|
نسخة الإصدار لجلب الأصول من. الإعدادات الافتراضية إلى "الأحدث". |
'latest'
|
retry |
bool
|
ضع علامة لإعادة محاولة الطلب في حالة حدوث فشل. الإعدادات الافتراضية إلى خطأ. |
False
|
ارجاع:
نوع | وصف |
---|---|
tuple
|
مجموعة تحتوي على علامة الإصدار وقائمة بأسماء الأصول. |
شفرة المصدر في ultralytics/utils/downloads.py
ultralytics.utils.downloads.attempt_download_asset(file, repo='ultralytics/assets', release='v8.2.0', **kwargs)
حاول تنزيل ملف من أصول إصدار GitHub إذا لم يتم العثور عليه محليا. تتحقق الوظيفة من الملف محليا أولا ، ثم يحاول تنزيله من إصدار مستودع GitHub المحدد.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
file |
str | Path
|
اسم الملف أو مسار الملف المراد تنزيله. |
مطلوب |
repo |
str
|
مستودع GitHub بتنسيق "المالك / الريبو". الإعدادات الافتراضية ل 'ultralytics/ الأصول'. |
'ultralytics/assets'
|
release |
str
|
إصدار الإصدار المحدد المراد تنزيله. الإعدادات الافتراضية هي "v8.2.0". |
'v8.2.0'
|
**kwargs |
any
|
وسيطات كلمات رئيسية إضافية لعملية التنزيل. |
{}
|
ارجاع:
نوع | وصف |
---|---|
str
|
المسار إلى الملف الذي تم تنزيله. |
شفرة المصدر في 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)
تنزيل الملفات من عناوين URL المحددة إلى دليل معين. يدعم التنزيلات المتزامنة إذا كانت سلاسل رسائل متعددة المحدد.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
url |
str | list
|
عنوان URL أو قائمة عناوين URL للملفات المراد تنزيلها. |
مطلوب |
dir |
Path
|
الدليل حيث سيتم حفظ الملفات. الإعدادات الافتراضية لدليل العمل الحالي. |
cwd()
|
unzip |
bool
|
ضع علامة لفك ضغط الملفات بعد التنزيل. الإعدادات الافتراضية إلى صواب. |
True
|
delete |
bool
|
ضع علامة لحذف الملفات المضغوطة بعد الاستخراج. الإعدادات الافتراضية إلى خطأ. |
False
|
curl |
bool
|
وضع علامة لاستخدام curl للتنزيل. الإعدادات الافتراضية إلى خطأ. |
False
|
threads |
int
|
عدد سلاسل الرسائل المراد استخدامها للتنزيلات المتزامنة. الإعدادات الافتراضية إلى 1. |
1
|
retry |
int
|
عدد مرات إعادة المحاولة في حالة فشل التنزيل. الإعدادات الافتراضية إلى 3. |
3
|
exist_ok |
bool
|
ما إذا كنت تريد الكتابة فوق المحتويات الموجودة أثناء فك الضغط. الإعدادات الافتراضية إلى خطأ. |
False
|