convert size package

Überblick

Das Dateigrößenkonvertermodul bietet Funktionen zum Konvertieren von Dateigrößen zwischen verschiedenen Einheiten sowohl in IEC (binär) als auch in SI (Dezimal). Es enthält Funktionen, um den vollständigen Namen einer Einheit aus der Abkürzung und der Umwandlung von Größen zwischen Einheiten zu erhalten.

Merkmale

• Konvertieren Sie Größen zwischen verschiedenen IEC -Einheiten (z. B. Bytes in Kibibyten).
• Konvertieren Sie die Größen zwischen verschiedenen Si -Einheiten (z. B. Bytes in Kilobytes).
• Rufen Sie den vollständigen Namen einer Einheit von seiner Abkürzung ab.
• Unterstützung sowohl für IEC (binäre) als auch für SI (Dezimal-) Einheitssysteme.

Installation

pip install wolfsoftware.convert-size

Verwendung

Importieren des Moduls

 import wolfsoftware . convert_size as fsc

Umwandlung von Größen

Verwenden Sie zur Konvertierung einer Größe zwischen verschiedenen Einheiten die Funktion convert_size . Sie können angeben, ob Sie SI -Einheiten verwenden sollen, indem Sie den Parameter si_units einstellen.

 # 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

Erhalten Sie den vollständigen Namen einer Einheit

Um den vollständigen Namen einer Einheit aus seiner Abkürzung zu erhalten, verwenden Sie die Funktion 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 

Funktionen

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

Konvertieren Sie eine Größe zwischen Einheiten, entweder IEC oder SI.

• size (Schwimmer): Die ursprüngliche Größe.
• start_unit (STR): Die Abkürzung der Starteinheit.
• end_unit (STR): Die Abkürzung der Endeinheit.
• si_units (bool): Wenn wahr, verwenden Sie SI -Einheiten; Ansonsten verwenden Sie IEC -Einheiten.
• Rückgabe (float): die konvertierte Größe.
• Erhöht ValueError : Wenn die Abkürzungen der Einheit nicht gültig sind.

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

Holen Sie sich den vollständigen Namen einer Einheit aus seiner Abkürzung.

• unit (STR): Die Abkürzung der Einheit.
• si_units (bool): Wenn wahr, verwenden Sie SI -Einheiten; Ansonsten verwenden Sie IEC -Einheiten.
• Gibt (STR) zurück: Der vollständige Name der Einheit.
• Erhöht ValueError : Wenn die Abkürzung der Einheit nicht gültig ist.

get_name_from_code_iec(unit: str) -> str

Holen Sie sich den vollständigen Namen einer IEC -Einheit von seiner Abkürzung.

• unit (STR): Die Abkürzung der IEC -Einheit.
• Gibt (STR) zurück: Der vollständige Name der IEC -Einheit.
• Erhöht ValueError : Wenn die Abkürzung der Einheit nicht gültig ist.

get_name_from_code_si(unit: str) -> str

Holen Sie sich den vollständigen Namen einer SI -Einheit von seiner Abkürzung.

• unit (STR): Die Abkürzung der Si -Einheit.
• Rückgabe (STR): Der vollständige Name der Si -Einheit.
• Erhöht ValueError : Wenn die Abkürzung der Einheit nicht gültig ist.

Fehlerbehandlung

Das Modul erhöht ValueError -Ausnahmen für ungültige Abkürzungen für ungültige Einheiten. Stellen Sie sicher, dass Sie diese Ausnahmen in Ihrem Code behandeln:

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