convert size package

概要

ファイルサイズコンバーターモジュールは、IEC（バイナリ）とSI（小数）形式の両方で異なるユニット間でファイルサイズを変換するための関数を提供します。ユニットからユニットのフルネームを取得し、ユニット間のサイズを変換する機能が含まれます。

特徴

• さまざまなIECユニット（たとえば、バイトからキビバイトなど）間でサイズを変換します。
• 異なる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ユニットを使用します。
• returns（float）：変換されたサイズ。
• Raise ValueError ：ユニットの略語が有効でない場合。

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

略語からユニットのフルネームを取得します。

• unit （str）：ユニットの略語。
• si_units （BOOL）：Trueの場合、SIユニットを使用します。それ以外の場合は、IECユニットを使用します。
• RETURNS（STR）：ユニットのフルネーム。
• Raise ValueError ：ユニットの略語が有効でない場合。

get_name_from_code_iec(unit: str) -> str

IECユニットのフルネームをその略語から取得します。

• unit （STR）：IECユニットの略語。
• RETURNS（STR）：IECユニットのフルネーム。
• Raise ValueError ：ユニットの略語が有効でない場合。

get_name_from_code_si(unit: str) -> str

略語からSIユニットのフルネームを取得します。

• unit （STR）：SIユニットの略語。
• RETURNS（STR）：SIユニットのフルネーム。
• Raise ValueError ：ユニットの略語が有効でない場合。

エラー処理

モジュールは、無効なユニットの略語のValueError例外を提起します。これらの例外をコードで処理することを確認してください。

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