Transformationsmodul

TIPCommon.transformation.add_prefix_to_dict

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

Fügt den Schlüsseln eines bestimmten Dictionarys ein Präfix hinzu.

Parameter

Parameter
given_dict	dict Das Wörterbuch, dem das Präfix hinzugefügt werden soll.
prefix	str Das Präfix, das auf die Wörterbuchschlüssel angewendet wird.

Gibt Folgendes zurück:

Das Dictionary mit dem Präfix, das den Schlüsseln hinzugefügt wurde.

Rückgabetyp

dict

TIPCommon.transformation.add_prefix_to_dict_keys

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

Fügt den Schlüsseln eines bestimmten Dictionarys ein Präfix hinzu.

Parameter

Parameter
target_dict	dict Das Wörterbuch, dem das Präfix hinzugefügt werden soll.
prefix	str Das Präfix, das auf die Wörterbuchschlüssel angewendet wird.

Gibt Folgendes zurück:

Das Dictionary mit dem Präfix, das den Schlüsseln hinzugefügt wurde.

Rückgabetyp

dict

TIPCommon.transformation.adjust_to_csv

TIPCommon.transformation.adjust_to_csv(value)

Passt einen Wert an, damit er in eine CSV-Datei aufgenommen werden kann.

Parameter
value	Any Der anzupassende Wert.

Gibt Folgendes zurück:

Der angepasste Wert.

Rückgabetyp

str

TIPCommon.transformation.construct_csv

TIPCommon.transformation.construct_csv(list_of_dicts)

Erstellt eine CSV-Datei aus einer Liste von Dictionaries.

Parameter
list_of_dicts	list[dict] Die Liste der dem CSV hinzuzufügenden Wörterbücher.

Gibt Folgendes zurück:

Die Liste im CSV-Format.

Rückgabetyp

list[str]

TIPCommon.transformation.convert_comma_separated_to_list

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

Konvertiert einen durch Kommas getrennten String in eine Liste von Werten.

Parameter
delimiter	Das Trennzeichen, mit dem der String geparst werden soll. Der Standardwert ist ','.
comma_separated	str Der durch Kommas getrennte String, der konvertiert werden soll.

Gibt Folgendes zurück:

Die Liste der Werte.

Rückgabetyp

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')

Konvertiert das key, value-JSON-Ergebnis in die JSON-Ergebnisobjektliste und organisiert das JSON-Ergebnisobjekt der Entität in einem festgelegten Format.

Das Beispiel für die Umwandlung von dict in das JSON-Ergebnis sieht so aus:

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

Parameter
json_result	dict[str, Any] | str Das key, value-JSON-Ergebnis.
title_key	str Der Schlüssel, unter dem sich der Name jedes Schlüssels befindet.
result_key	str Der Schlüssel, unter dem der Name jedes Werts steht.

Beispiele

Das Standardbeispiel für das JSON-Format des Entitätsergebnisses, wobei title_key='Entity' und results_key='EntityResult' wie folgt definiert sind:

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

Gibt Folgendes zurück:

(list[dict[str, Any]]) Eine Liste von JSON-Ergebnisobjekten für Entitäten

Löst aus

• InternalJSONDecoderError: wenn json_result ein String ist und nicht mit json.loads() in ein Dictionary geparst werden konnte.
• ValueError: wenn json_result kein dict ist (die Prüfung erfolgt nach dem Laden aus einem String, falls erforderlich).

TIPCommon.transformation.convert_list_to_comma_string

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

Konvertiert eine Liste von Werten in einen durch Kommas getrennten String.

Parameter
delimiter	Das Trennzeichen, das im String verwendet werden soll. Der Standardwert ist ','.
values_list	list Die Liste der zu konvertierenden Werte.

Gibt Folgendes zurück:

Der durch Kommas getrennte String.

Rückgabetyp

str

TIPCommon.transformation.dict_to_flat

TIPCommon.transformation.dict_to_flat(target_dict)

Empfängt ein verschachteltes Dictionary und gibt es als flaches Dictionary zurück.

Parameter
target_dict	dict Das Dictionary, das zusammengefasst werden soll.

Gibt Folgendes zurück:

Das vereinfachte Dictionary.

Rückgabetyp

dict

TIPCommon.transformation.flat_dict_to_csv

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

Wandelt ein einfaches Dictionary in eine Liste von Strings im CSV-Format um.

Mit den Argumenten property_header und value_header wird die CSV-Kopfzeile angepasst.

Parameter
flat_dict	dict Das Dictionary, das in das CSV-Format konvertiert werden soll.
property_header	str Die Überschrift für die Spalte „Property“. Der Standardwert ist Property.
value_header	str Die Überschrift für die Spalte „Wert“. Der Standardwert ist Value.

Gibt Folgendes zurück:

Die Liste der Strings im CSV-Format.

Rückgabetyp

list

TIPCommon.transformation.get_unicode

TIPCommon.transformation.get_unicode(value)

Ruft den Unicode-Wert eines Werts ab.

Parameter
value	Any Der Wert, der in Unicode konvertiert werden soll.

Gibt Folgendes zurück:

Die Unicode-Darstellung des Werts.

Rückgabetyp

unicode (unicode)

TIPCommon.transformation.removeprefix

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

Selbstimplementierung für str.removeprefix(), die in Python 3.9 und höher vorhanden ist.

Wenn der String mit dem Präfixstring beginnt, gibt die Methode string[len(prefix):] zurück. Andernfalls wird eine Kopie des ursprünglichen Strings zurückgegeben.

Parameter
string	str Die Zeichenfolge, aus der das Präfix entfernt werden soll.
prefix	str Das Präfix, das aus dem String entfernt werden soll.

Gibt Folgendes zurück:

Der resultierende String.

TIPCommon.transformation.removesuffix

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

Selbstimplementierung für str.removesuffix(), die in Python 3.9 und höher vorhanden ist.

Wenn der String mit dem Suffixstring endet, gibt die Methode string[:-len(prefix)] zurück. Andernfalls wird eine Kopie des ursprünglichen Strings zurückgegeben.

Parameter
string	str Die Zeichenfolge, aus der das Suffix entfernt werden soll.
suffix	str Das Suffix, das aus dem String entfernt werden soll.

Gibt Folgendes zurück:

Der resultierende String.

TIPCommon.transformation.rename_dict_key

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

Benennt einen Schlüssel in einem Dictionary um.

Parameter
a_dict	dict Das Dictionary, in dem ein Schlüssel umbenannt werden soll.
current_key	Hashable Der Schlüssel in a_dict, der umbenannt werden soll.
new_key	Hashable Der umbenannte Schlüssel.

TIPCommon.transformation.string_to_multi_value

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

Konvertiert einen String mit einer durch Kommas getrennten Liste von Werten in eine Liste von Werten.

Parameter
string_value	str Der zu konvertierende String.
delimiter	Optional str Das Trennzeichen, anhand dessen der String aufgeteilt werden soll. Standardwert ist ','.
only_unique	Optional bool Wenn der Parameter auf True festgelegt ist, enthält die zurückgegebene Liste nur eindeutige Werte. Standardwert ist False.

Gibt Folgendes zurück:

Die Liste der Werte.

Rückgabetyp

list

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten