convert size package

Ringkasan

Modul konverter ukuran file menyediakan fungsi untuk mengonversi ukuran file antara berbagai unit dalam format IEC (biner) dan Si (desimal). Ini termasuk fungsionalitas untuk mendapatkan nama lengkap unit dari singkatannya dan mengonversi ukuran antar unit.

Fitur

• Konversi ukuran antara unit IEC yang berbeda (misalnya, byte ke kibibytes).
• Konversi ukuran antara unit SI yang berbeda (misalnya, byte menjadi kilobytes).
• Ambil nama lengkap unit dari singkatannya.
• Dukungan untuk sistem unit IEC (biner) dan SI (desimal).

Instalasi

pip install wolfsoftware.convert-size

Penggunaan

Mengimpor modul

 import wolfsoftware . convert_size as fsc

Mengonversi ukuran

Untuk mengonversi ukuran antara unit yang berbeda, gunakan fungsi convert_size . Anda dapat menentukan apakah akan menggunakan unit SI dengan mengatur parameter 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

Mendapatkan nama lengkap unit

Untuk mendapatkan nama lengkap unit dari singkatannya, gunakan fungsi 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 

Fungsi

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

Konversi ukuran antar unit, baik IEC atau SI.

• size (float): Ukuran aslinya.
• start_unit (str): Singkatan unit awal.
• end_unit (str): Singkatan unit akhir.
• si_units (bool): Jika benar, gunakan unit SI; Jika tidak, gunakan unit IEC.
• Returns (float): Ukuran yang dikonversi.
• Meningkatkan ValueError : Jika singkatan unit tidak valid.

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

Dapatkan nama lengkap unit dari singkatannya.

• unit (STR): Singkatan unit.
• si_units (bool): Jika benar, gunakan unit SI; Jika tidak, gunakan unit IEC.
• Returns (str): Nama lengkap unit.
• Meningkatkan ValueError : Jika singkatan unit tidak valid.

get_name_from_code_iec(unit: str) -> str

Dapatkan nama lengkap unit IEC dari singkatannya.

• unit (STR): Singkatan unit IEC.
• Returns (str): Nama lengkap unit IEC.
• Meningkatkan ValueError : Jika singkatan unit tidak valid.

get_name_from_code_si(unit: str) -> str

Dapatkan nama lengkap unit SI dari singkatannya.

• unit (STR): Singkatan unit SI.
• Returns (str): Nama lengkap unit SI.
• Meningkatkan ValueError : Jika singkatan unit tidak valid.

Penanganan kesalahan

Modul ini meningkatkan pengecualian ValueError untuk singkatan unit yang tidak valid. Pastikan Anda menangani pengecualian ini dalam kode Anda:

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