convert size package

Descripción general

El módulo convertidor de tamaño de archivo proporciona funciones para convertir los tamaños de archivo entre diferentes unidades en formatos IEC (binarios) y SI (decimal). Incluye la funcionalidad para obtener el nombre completo de una unidad de sus tamaños de abreviatura y conversión entre unidades.

Características

• Convierta tamaños entre diferentes unidades IEC (por ejemplo, bytes a kibibytes).
• Convierta tamaños entre diferentes unidades SI (por ejemplo, bytes a kilobytes).
• Recupere el nombre completo de una unidad de su abreviatura.
• Soporte para sistemas de unidades IEC (binarios) y SI (decimales).

Instalación

pip install wolfsoftware.convert-size

Uso

Importando el módulo

 import wolfsoftware . convert_size as fsc

Tamaños de conversión

Para convertir un tamaño entre diferentes unidades, use la función convert_size . Puede especificar si se debe usar unidades SI configurando el 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

Obtener el nombre completo de una unidad

Para obtener el nombre completo de una unidad desde su abreviatura, use la función 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 

Funciones

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

Convierta un tamaño entre unidades, ya sea IEC o SI.

• size (flotador): el tamaño original.
• start_unit (STR): la abreviatura de la unidad de inicio.
• end_unit (STR): la abreviatura de la unidad final.
• si_units (bool): si es verdadero, use unidades SI; De lo contrario, use unidades IEC.
• Devuelve (Float): el tamaño convertido.
• Aumenta ValueError : si las abreviaturas de la unidad no son válidas.

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

Obtenga el nombre completo de una unidad de su abreviatura.

• unit (STR): la abreviatura de la unidad.
• si_units (bool): si es verdadero, use unidades SI; De lo contrario, use unidades IEC.
• Devuelve (STR): el nombre completo de la unidad.
• Aumenta ValueError : si la abreviatura de la unidad no es válida.

get_name_from_code_iec(unit: str) -> str

Obtenga el nombre completo de una unidad IEC de su abreviatura.

• unit (STR): la abreviatura de la unidad IEC.
• Devuelve (STR): el nombre completo de la unidad IEC.
• Aumenta ValueError : si la abreviatura de la unidad no es válida.

get_name_from_code_si(unit: str) -> str

Obtenga el nombre completo de una unidad SI de su abreviatura.

• unit (STR): la abreviatura de la unidad SI.
• Devuelve (STR): el nombre completo de la unidad SI.
• Aumenta ValueError : si la abreviatura de la unidad no es válida.

Manejo de errores

El módulo aumenta las excepciones ValueError para abreviaturas de unidades no válidas. Asegúrese de manejar estas excepciones en su código:

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