מודול טרנספורמציה

TIPCommon.transformation.add_prefix_to_dict

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

הוספת קידומת למפתחות של מילון נתון.

פרמטרים

פרמטרים
given_dict	dict המילון שאליו רוצים להוסיף את הקידומת.
prefix	str התחילית שמוחלת על מפתחות המילון.

מחזירה

המילון עם הקידומת שנוספה למפתחות.

סוג הערך שמוחזר

dict

TIPCommon.transformation.add_prefix_to_dict_keys

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

הוספת קידומת למפתחות של מילון נתון.

פרמטרים

פרמטרים
target_dict	dict המילון שאליו רוצים להוסיף את הקידומת.
prefix	str התחילית שמוחלת על מפתחות המילון.

מחזירה

המילון עם הקידומת שנוספה למפתחות.

סוג הערך שמוחזר

dict

TIPCommon.transformation.adjust_to_csv

TIPCommon.transformation.adjust_to_csv(value)

הפונקציה משנה ערך כך שיתאים להכללה בקובץ CSV.

פרמטרים
value	Any הערך שרוצים לשנות.

מחזירה

הערך המותאם.

סוג הערך שמוחזר

str

TIPCommon.transformation.construct_csv

TIPCommon.transformation.construct_csv(list_of_dicts)

יוצר קובץ CSV מרשימה של מילונים.

פרמטרים
list_of_dicts	list[dict] רשימת המילונים שרוצים להוסיף לקובץ ה-CSV.

מחזירה

הרשימה בפורמט CSV.

סוג הערך שמוחזר

list[str]

TIPCommon.transformation.convert_comma_separated_to_list

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

ממירה מחרוזת שמופרדת בפסיקים לרשימת ערכים.

פרמטרים
delimiter	תו המפריד לניתוח המחרוזת. ברירת המחדל היא ','.
comma_separated	str המחרוזת להמרה, שבה הערכים מופרדים בפסיקים.

מחזירה

רשימת הערכים.

סוג הערך שמוחזר

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

הופך את תוצאת ה-JSON‏ key, value לרשימת אובייקטים של תוצאות JSON ומארגן את אובייקט תוצאת ה-JSON של הישות לפורמט מוגדר.

הדוגמה הבאה מראה איך dict הופך לתוצאת JSON:

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

פרמטרים
json_result	dict[str, Any] | str תוצאת ה-JSON‏ key, value.
title_key	str המפתח שמתחתיו יופיע השם של כל מפתח.
result_key	str המפתח שמתחתיו יופיע השם של כל ערך.

דוגמאות

דוגמה לפורמט JSON של תוצאת ישות, שבה title_key='Entity' ו-results_key='EntityResult' הם ערכי ברירת המחדל:

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

מחזירה

(list[dict[str, Any]]) רשימה של אובייקטים של תוצאות JSON של ישויות

העלאות

• ‫InternalJSONDecoderError – אם json_result היא מחרוזת ולא ניתן לנתח אותה למילון באמצעות json.loads().
• ‫ValueError – אם json_result הוא לא dict (הבדיקה מתבצעת אחרי הטעינה ממחרוזת, אם צריך).

TIPCommon.transformation.convert_list_to_comma_string

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

הפונקציה ממירה רשימה של ערכים למחרוזת שבה הערכים מופרדים בפסיקים.

פרמטרים
delimiter	תו המפריד שבו יש להשתמש במחרוזת. ברירת המחדל היא ','.
values_list	list רשימת הערכים להמרה.

מחזירה

המחרוזת המופרדת בפסיקים.

סוג הערך שמוחזר

str

TIPCommon.transformation.dict_to_flat

TIPCommon.transformation.dict_to_flat(target_dict)

הפונקציה מקבלת מילון מקונן ומחזירה אותו כמילון שטוח.

פרמטרים
target_dict	dict המילון לאיחוד.

מחזירה

המילון השטוח.

סוג הערך שמוחזר

dict

TIPCommon.transformation.flat_dict_to_csv

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

הפונקציה ממירה מילון שטוח לרשימה של מחרוזות בפורמט CSV.

הארגומנטים property_header ו-value_header משמשים להתאמה אישית של הכותרת של קובץ ה-CSV.

פרמטרים
flat_dict	dict המילון להמרה לפורמט CSV.
property_header	str הכותרת של עמודת הנכס. ברירת המחדל היא מאפיין.
value_header	str הכותרת של עמודת הערך. ברירת המחדל היא Value.

מחזירה

רשימת המחרוזות בפורמט CSV.

סוג הערך שמוחזר

list

TIPCommon.transformation.get_unicode

TIPCommon.transformation.get_unicode(value)

קבלת ערך ה-Unicode של ערך.

פרמטרים
value	Any הערך להמרה ל-Unicode.

מחזירה

ייצוג ה-Unicode של הערך.

סוג הערך שמוחזר

unicode (unicode)

TIPCommon.transformation.removeprefix

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

הטמעה עצמית של str.removeprefix() שקיימת ב-Python 3.9 ובגרסאות מתקדמות יותר.

אם המחרוזת מתחילה במחרוזת התחילית, הפונקציה מחזירה את הערך string[len(prefix):]. אחרת, היא מחזירה עותק של המחרוזת המקורית.

פרמטרים
string	str המחרוזת שממנה רוצים להסיר את הקידומת.
prefix	str הקידומת שרוצים להסיר מהמחרוזת.

מחזירה

המחרוזת שמתקבלת.

TIPCommon.transformation.removesuffix

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

הטמעה עצמית של str.removesuffix() שקיימת ב-Python 3.9 ובגרסאות מתקדמות יותר.

אם המחרוזת מסתיימת במחרוזת הסיומת, השיטה מחזירה string[:-len(prefix)]. אחרת, היא מחזירה עותק של המחרוזת המקורית.

פרמטרים
string	str המחרוזת שממנה צריך להסיר את הסיומת.
suffix	str הסיומת שרוצים להסיר מהמחרוזת.

מחזירה

המחרוזת שמתקבלת.

TIPCommon.transformation.rename_dict_key

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

משנה את השם של מפתח במילון.

פרמטרים
a_dict	dict המילון שבו רוצים לשנות את השם של מפתח.
current_key	Hashable המפתח ב-a_dict שרוצים לשנות את השם שלו.
new_key	Hashable המפתח ששמו שונה.

TIPCommon.transformation.string_to_multi_value

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

הפונקציה ממירה מחרוזת שמכילה רשימה של ערכים מופרדים בפסיקים לרשימה של ערכים.

פרמטרים
string_value	str המחרוזת להמרה.
delimiter	אופציונלי str התו המפריד שבו צריך לפצל את המחרוזת. ערך ברירת המחדל הוא ','.
only_unique	אופציונלי bool אם הערך מוגדר כ-True, הפרמטר כולל רק ערכים ייחודיים ברשימה שמוחזרת. ערך ברירת המחדל הוא False.

מחזירה

רשימת הערכים.

סוג הערך שמוחזר

list

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.