Module de transformation

TIPCommon.transformation.add_prefix_to_dict

TIPCommon.transformation.add_prefix_to_dict(given_dict: dict, prefix: str) → dict

Ajoute un préfixe aux clés d'un dictionnaire donné.

Paramètres

Paramètres
given_dict	dict Dictionnaire auquel ajouter le préfixe.
prefix	str Préfixe appliqué aux clés du dictionnaire.

Renvoie

Dictionnaire avec le préfixe ajouté aux clés.

Type renvoyé

dict

TIPCommon.transformation.add_prefix_to_dict_keys

TIPCommon.transformation.add_prefix_to_dict_keys(target_dict: dict, prefix: str) → dict

Ajoute un préfixe aux clés d'un dictionnaire donné.

Paramètres

Paramètres
target_dict	dict Dictionnaire auquel ajouter le préfixe.
prefix	str Préfixe appliqué aux clés du dictionnaire.

Renvoie

Dictionnaire avec le préfixe ajouté aux clés.

Type renvoyé

dict

TIPCommon.transformation.adjust_to_csv

TIPCommon.transformation.adjust_to_csv(value)

Ajuste une valeur pour qu'elle puisse être incluse dans un fichier CSV.

Paramètres
value	Any Valeur à ajuster.

Renvoie

Valeur ajustée.

Type renvoyé

str

TIPCommon.transformation.construct_csv

TIPCommon.transformation.construct_csv(list_of_dicts)

Crée un fichier CSV à partir d'une liste de dictionnaires.

Paramètres
list_of_dicts	list[dict] Liste des dictionnaires à ajouter au fichier CSV.

Renvoie

Liste au format CSV.

Type renvoyé

list[str]

TIPCommon.transformation.convert_comma_separated_to_list

TIPCommon.transformation.convert_comma_separated_to_list(comma_separated, delimiter=',')

Convertit une chaîne de caractères séparée par des virgules en liste de valeurs.

Paramètres
delimiter	Délimiteur à utiliser pour analyser la chaîne. La valeur par défaut est ','.
comma_separated	str Chaîne séparée par des virgules à convertir.

Renvoie

Liste des valeurs.

Type renvoyé

list

TIPCommon.transformation.convert_dict_to_json_result_dict

TIPCommon.transformation.convert_dict_to_json_result_dict(json_result, title_key='Entity', results_key='EntityResult')

Convertit le résultat JSON key, value en liste d'objets de résultat JSON et organise l'objet de résultat JSON d'entité dans un format défini.

Voici un exemple de transformation d'un dict en résultat JSON :

{k1: v1, k2:v2, ...} =>
[
   {
       title_key: k1,
       result_key: v1
   },
   {
       title_key: k2,
       result_key: v1
   }
   ...
]

Paramètres
json_result	dict[str, Any] | str Résultat JSON key, value.
title_key	str Clé sous laquelle se trouve le nom de chaque clé.
result_key	str Clé sous laquelle le nom de chaque valeur sera indiqué.

Exemples

L'exemple par défaut pour le format JSON du résultat de l'entité où title_key='Entity' et results_key='EntityResult' est le suivant :

[
   {
       'Entity': 'key1 in json_result',
       'EntityResult: {
           json_result['key1']
       }
   },
   {
       'Entity': 'key2 in json_result',
       'EntityResult: {
           json_result['key2']
       }
   }
]

Renvoie

(list[dict[str, Any]]) : liste d'objets de résultat JSON d'entité

Génère

• InternalJSONDecoderError : si json_result est une chaîne et n'a pas pu être analysée en dictionnaire à l'aide de json.loads().
• ValueError : si json_result n'est pas un dict (la vérification est effectuée après le chargement à partir d'une chaîne, si nécessaire).

TIPCommon.transformation.convert_list_to_comma_string

TIPCommon.transformation.convert_list_to_comma_string(values_list, delimiter=',')

Convertit une liste de valeurs en chaîne séparée par des virgules.

Paramètres
delimiter	Délimiteur à utiliser dans la chaîne. La valeur par défaut est ','.
values_list	list Liste des valeurs à convertir.

Renvoie

Chaîne séparée par une virgule.

Type renvoyé

str

TIPCommon.transformation.dict_to_flat

TIPCommon.transformation.dict_to_flat(target_dict)

Reçoit un dictionnaire imbriqué et le renvoie sous forme de dictionnaire plat.

Paramètres
target_dict	dict Dictionnaire à aplatir.

Renvoie

Dictionnaire aplati.

Type renvoyé

dict

TIPCommon.transformation.flat_dict_to_csv

TIPCommon.transformation.flat_dict_to_csv(flat_dict, property_header='Property', value_header='Value')

Convertit un dictionnaire plat en liste de chaînes au format CSV.

Les arguments property_header et value_header sont utilisés pour personnaliser l'en-tête CSV.

Paramètres
flat_dict	dict Dictionnaire à convertir au format CSV.
property_header	str En-tête de la colonne des propriétés. La valeur par défaut est Propriété.
value_header	str En-tête de la colonne de valeurs. La valeur par défaut est Value.

Renvoie

Liste de chaînes au format CSV.

Type renvoyé

list

TIPCommon.transformation.get_unicode

TIPCommon.transformation.get_unicode(value)

Récupère l'unicode d'une valeur.

Paramètres
value	Any Valeur à convertir en Unicode.

Renvoie

Représentation Unicode de la valeur.

Type renvoyé

unicode (unicode)

TIPCommon.transformation.removeprefix

TIPCommon.transformation.removeprefix(string: str, prefix: str) → str

Implémentation automatique pour str.removeprefix() qui existe dans Python 3.9 et versions ultérieures.

Si la chaîne commence par la chaîne de préfixe, la méthode renvoie string[len(prefix):]. Sinon, renvoie une copie de la chaîne d'origine.

Paramètres
string	str Chaîne à partir de laquelle supprimer le préfixe.
prefix	str Préfixe à supprimer de la chaîne.

Renvoie

Chaîne résultante.

TIPCommon.transformation.removesuffix

TIPCommon.transformation.removesuffix(string: str, suffix: str) → str

Implémentation automatique pour str.removesuffix() qui existe dans Python 3.9 et versions ultérieures.

Si la chaîne se termine par la chaîne de suffixe, la méthode renvoie string[:-len(prefix)]. Sinon, renvoie une copie de la chaîne d'origine.

Paramètres
string	str Chaîne à partir de laquelle supprimer le suffixe.
suffix	str Suffixe à supprimer de la chaîne.

Renvoie

Chaîne résultante.

TIPCommon.transformation.rename_dict_key

TIPCommon.transformation.rename_dict_key(a_dict: dict, current_key: Hashable,new_key: Hashable) → None

Renomme une clé dans un dictionnaire.

Paramètres
a_dict	dict Dictionnaire dans lequel renommer une clé.
current_key	Hashable Clé à renommer dans a_dict.
new_key	Hashable Clé renommée.

TIPCommon.transformation.string_to_multi_value

TIPCommon.transformation.string_to_multi_value(string_value, delimiter=',', only_unique=False)

Convertit une chaîne contenant une liste de valeurs séparées par des virgules en liste de valeurs.

Paramètres
string_value	str Chaîne à convertir.
delimiter	Optional str Délimiteur pour diviser la chaîne. La valeur par défaut est ','.
only_unique	Optional bool Si la valeur est définie sur True, le paramètre n'inclut que les valeurs uniques dans la liste renvoyée. La valeur par défaut est False.

Renvoie

Liste des valeurs.

Type renvoyé

list

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.