convert size package

概述

文件大小轉換器模塊提供了用於在IEC（二進制）和SI（十進制）格式中不同單元之間轉換文件大小的功能。它包括功能，用於從其縮寫中獲取單元的全名並在單元之間轉換大小。

特徵

• 在不同的IEC單元之間轉換尺寸（例如，字節為kibibytes）。
• 在不同的SI單元之間轉換尺寸（例如，字節為千字節）。
• 從其縮寫中檢索單元的全名。
• 支持IEC（二進制）和SI（十進制）單位系統。

安裝

pip install wolfsoftware.convert-size

用法

導入模塊

 import wolfsoftware . convert_size as fsc

轉換尺寸

要在不同單元之間轉換大小，請使用convert_size函數。您可以通過設置si_units參數來指定是否使用SI單元。

 # 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）：如果為true，請使用si單位；否則，請使用IEC單元。
• 返回（浮點）：轉換的大小。
• 提高ValueError ：如果單位縮寫無效。

get_name_from_code(unit: str, si_units: bool = False) -> str

從縮寫中獲取一個單元的全名。

• unit （str）：單位縮寫。
• si_units （bool）：如果為true，請使用si單位；否則，請使用IEC單元。
• 返回（str）：單元的全名。
• 提高ValueError ：如果單位縮寫無效。

get_name_from_code_iec(unit: str) -> str

從其縮寫中獲取IEC單元的全名。

• unit （str）：IEC單元縮寫。
• 返回（str）：IEC單元的全名。
• 提高ValueError ：如果單位縮寫無效。

get_name_from_code_si(unit: str) -> str

從其縮寫中獲取SI單元的全名。

• unit （str）：SI單元縮寫。
• 返回（str）：SI單元的全名。
• 提高ValueError ：如果單位縮寫無效。

錯誤處理

該模塊提高了無效單位縮寫的ValueError例外。確保您在代碼中處理這些例外：

 try :
    size_in_gib = fsc . convert_size ( 1024 , 'MiB' , 'GiB' )
except ValueError as e :
    print ( e )