convert size package
v0.1.2
توفر وحدة محول حجم الملف وظائف لتحويل أحجام الملفات بين الوحدات المختلفة في كل من تنسيقات IEC (ثنائية) و SI (عشرية). ويشمل وظيفة للحصول على الاسم الكامل للوحدة من اختصارها وتحويل أحجامها بين الوحدات.
pip install wolfsoftware.convert-size import wolfsoftware . convert_size as fsc لتحويل الحجم بين الوحدات المختلفة ، استخدم وظيفة convert_size . يمكنك تحديد ما إذا كنت تريد استخدام وحدات SI عن طريق تعيين معلمة si_units .
# IEC conversion example
size_in_gib = fsc . convert_size ( 1024 , 'MiB' , 'GiB' )
print ( size_in_gib ) # Output: 1.0
# SI conversion example
size_in_gb = fsc . convert_size ( 1000 , 'MB' , 'GB' , si_units = True )
print ( size_in_gb ) # Output: 1.0 للحصول على الاسم الكامل للوحدة من اختصارها ، استخدم وظيفة get_name_from_code .
# IEC unit name example
unit_name = fsc . get_name_from_code ( 'KiB' )
print ( unit_name ) # Output: Kibibyte
# SI unit name example
unit_name = fsc . get_name_from_code ( 'KB' , si_units = True )
print ( unit_name ) # Output: Kilobyte convert_size(size: float, start_unit: str, end_unit: str, si_units: bool = False) -> floatتحويل الحجم بين الوحدات ، إما IEC أو SI.
size (تعويم): الحجم الأصلي.start_unit (str): اختصار وحدة البدء.end_unit (Str): اختصار وحدة النهاية.si_units (Bool): إذا كان صحيحًا ، فاستخدم وحدات Si ؛ خلاف ذلك ، استخدم وحدات IEC.ValueError : إذا كانت اختصارات الوحدة غير صالحة. get_name_from_code(unit: str, si_units: bool = False) -> strاحصل على الاسم الكامل للوحدة من اختصارها.
unit (STR): اختصار الوحدة.si_units (Bool): إذا كان صحيحًا ، فاستخدم وحدات Si ؛ خلاف ذلك ، استخدم وحدات IEC.ValueError : إذا كان اختصار الوحدة غير صالح. get_name_from_code_iec(unit: str) -> strاحصل على الاسم الكامل لوحدة IEC من اختصارها.
unit (STR): اختصار وحدة IEC.ValueError : إذا كان اختصار الوحدة غير صالح. get_name_from_code_si(unit: str) -> strاحصل على الاسم الكامل لوحدة SI من اختصارها.
unit (STR): اختصار وحدة SI.ValueError : إذا كان اختصار الوحدة غير صالح. ترفع الوحدة استثناءات ValueError للاختصارات غير صالحة للوحدة. تأكد من التعامل مع هذه الاستثناءات في الكود الخاص بك:
try :
size_in_gib = fsc . convert_size ( 1024 , 'MiB' , 'GiB' )
except ValueError as e :
print ( e )
