convert size package

Обзор

Модуль преобразователя размера файла предоставляет функции для преобразования размеров файлов между различными единицами в форматах IEC (бинар) и Si (десятичный). Он включает в себя функциональность для получения полного названия единицы из его аббревиатуры и преобразования размеров между единицами.

Функции

• Преобразуют размеры между различными единицами МЭК (например, байты в кибибиты).
• Преобразуют размеры между различными единицами Si (например, байты в килобиты).
• Получите полное название подразделения от его аббревиатуры.
• Поддержка как для 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; В противном случае используйте единицы МЭК.
• Возврат (float): преобразованный размер.
• Повышает ValueError : если аббревиатура единицы недействителен.

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

Получите полное название подразделения от его аббревиатуры.

• unit (Str): Сокращение подразделения.
• si_units (bool): если это правда, используйте единицы Si; В противном случае используйте единицы МЭК.
• Возврат (Str): полное название устройства.
• Повышает ValueError : если аббревиатура единицы не является действительной.

get_name_from_code_iec(unit: str) -> str

Получите полное название блока МЭК от его аббревиатуры.

• unit (Str): Сокращение блока МЭК.
• Возврат (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 )