convert size package

Aperçu

Le module de convertisseur de taille de fichier fournit des fonctions de conversion de tailles de fichiers entre différentes unités dans les formats IEC (binaire) et SI (décimal). Il comprend des fonctionnalités pour obtenir le nom complet d'une unité de son abréviation et de la conversion des tailles entre les unités.

Caractéristiques

• Convertir les tailles entre différentes unités IEC (par exemple, octets en kibibytes).
• Convertir les tailles entre différentes unités SI (par exemple, octets en kilo-kilobytes).
• Récupérez le nom complet d'une unité de son abréviation.
• Prise en charge des systèmes d'unité IEC (binaire) et SI (décimal).

Installation

pip install wolfsoftware.convert-size

Usage

Importation du module

 import wolfsoftware . convert_size as fsc

Tailles de conversion

Pour convertir une taille entre différentes unités, utilisez la fonction convert_size . Vous pouvez spécifier si vous devez utiliser des unités SI en définissant le paramètre 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

Obtenir le nom complet d'une unité

Pour obtenir le nom complet d'une unité à partir de son abréviation, utilisez la fonction 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 

Fonctions

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

Convertissez une taille entre les unités, IEC ou SI.

• size (flotteur): la taille d'origine.
• start_unit (str): l'abréviation de l'unité de départ.
• end_unit (str): l'abréviation de l'unité de fin.
• si_units (bool): si vrai, utilisez des unités SI; Sinon, utilisez des unités IEC.
• Retour (flottant): la taille convertie.
• Augmente ValueError : si les abréviations unitaires ne sont pas valides.

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

Obtenez le nom complet d'une unité de son abréviation.

• unit (STR): l'unité d'abréviation.
• si_units (bool): si vrai, utilisez des unités SI; Sinon, utilisez des unités IEC.
• Renvoie (STR): le nom complet de l'unité.
• Augmente ValueError : si l'abréviation de l'unité n'est pas valide.

get_name_from_code_iec(unit: str) -> str

Obtenez le nom complet d'une unité IEC depuis son abréviation.

• unit (STR): l'abréviation de l'unité IEC.
• Renvoie (STR): le nom complet de l'unité IEC.
• Augmente ValueError : si l'abréviation de l'unité n'est pas valide.

get_name_from_code_si(unit: str) -> str

Obtenez le nom complet d'une unité SI depuis son abréviation.

• unit (STR): l'abréviation de l'unité SI.
• Renvoie (STR): le nom complet de l'unité SI.
• Augmente ValueError : si l'abréviation de l'unité n'est pas valide.

Gestion des erreurs

Le module augmente les exceptions ValueError pour les abréviations unitaires non valides. Assurez-vous de gérer ces exceptions dans votre code:

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