convert size package

Visão geral

O módulo de conversor de tamanho do arquivo fornece funções para converter tamanhos de arquivo entre diferentes unidades nos formatos IEC (binário) e Si (decimal). Inclui funcionalidade para obter o nome completo de uma unidade a partir de sua abreviação e tamanhos de conversão entre as unidades.

Características

• Converter tamanhos entre diferentes unidades IEC (por exemplo, bytes em kibibytes).
• Converter tamanhos entre diferentes unidades de Si (por exemplo, bytes em kilobytes).
• Recupere o nome completo de uma unidade a partir de sua abreviação.
• Suporte para sistemas de unidades IEC (binário) e Si (decimal).

Instalação

pip install wolfsoftware.convert-size

Uso

Importando o módulo

 import wolfsoftware . convert_size as fsc

Tamanhos de conversão

Para converter um tamanho entre diferentes unidades, use a função convert_size . Você pode especificar se deve usar as unidades SI definindo o parâmetro 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

Obtendo o nome completo de uma unidade

Para obter o nome completo de uma unidade a partir de sua abreviação, use a função 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 

Funções

convert_size(size: float, start_unit: str, end_unit: str, si_units: bool = False) -> float

Converta um tamanho entre as unidades, IEC ou SI.

• size (flutuação): o tamanho original.
• start_unit (str): a abreviação da unidade inicial.
• end_unit (str): a abreviação da unidade final.
• si_units (BOOL): se verdadeiro, use unidades SI; Caso contrário, use unidades IEC.
• Retorna (flutuação): o tamanho convertido.
• Aumenta ValueError : se as abreviações da unidade não forem válidas.

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

Obtenha o nome completo de uma unidade a partir de sua abreviação.

• unit (STR): A abreviação da unidade.
• si_units (BOOL): se verdadeiro, use unidades SI; Caso contrário, use unidades IEC.
• Retorna (STR): o nome completo da unidade.
• Aumenta ValueError : se a abreviação da unidade não for válida.

get_name_from_code_iec(unit: str) -> str

Obtenha o nome completo de uma unidade IEC a partir de sua abreviação.

• unit (STR): A abreviação da unidade IEC.
• Retorna (STR): o nome completo da unidade IEC.
• Aumenta ValueError : se a abreviação da unidade não for válida.

get_name_from_code_si(unit: str) -> str

Obtenha o nome completo de uma unidade SI a partir de sua abreviação.

• unit (STR): A abreviação da unidade SI.
• Retorna (STR): o nome completo da unidade SI.
• Aumenta ValueError : se a abreviação da unidade não for válida.

Manuseio de erros

O módulo levanta exceções ValueError para abreviações de unidades inválidas. Certifique -se de lidar com essas exceções em seu código:

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