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 )