Módulo de transformación

TIPCommon.transformation.add_prefix_to_dict

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

Agrega un prefijo a las claves de un diccionario determinado.

Parámetros

Parámetros
given_dict dict

Es el diccionario al que se agregará el prefijo.

prefix str

Es el prefijo que se aplica a las claves del diccionario.

Devoluciones

Es el diccionario con el prefijo agregado a las claves.

Tipo de datos que se muestra

dict

TIPCommon.transformation.add_prefix_to_dict_keys

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

Agrega un prefijo a las claves de un diccionario determinado.

Parámetros

Parámetros
target_dict dict

Es el diccionario al que se agregará el prefijo.

prefix str

Es el prefijo que se aplica a las claves del diccionario.

Devoluciones

Es el diccionario con el prefijo agregado a las claves.

Tipo de datos que se muestra

dict

TIPCommon.transformation.adjust_to_csv

TIPCommon.transformation.adjust_to_csv(value)

Ajusta un valor para que sea adecuado para su inclusión en un CSV.

Parámetros
value Any

Es el valor que se ajustará.

Devoluciones

Es el valor ajustado.

Tipo de datos que se muestra

str

TIPCommon.transformation.construct_csv

TIPCommon.transformation.construct_csv(list_of_dicts)

Construye un CSV a partir de una lista de diccionarios.

Parámetros
list_of_dicts list[dict]

Es la lista de diccionarios que se agregarán al CSV.

Devoluciones

Es la lista con formato CSV.

Tipo de datos que se muestra

list[str]

TIPCommon.transformation.convert_comma_separated_to_list

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

Convierte una cadena separada por comas en una lista de valores.

Parámetros
delimiter Delimitador con el que se analizará la cadena.
El valor predeterminado es ','.
comma_separated str

Es la cadena separada por comas que se convertirá.

Devoluciones

Es la lista de valores.

Tipo de datos que se muestra

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

Convierte el resultado JSON de key, value en la lista de objetos de resultado JSON y organiza el objeto de resultado JSON de la entidad en un formato establecido.

El siguiente es un ejemplo de cómo se transforma un dict en el resultado JSON:

{k1: v1, k2:v2, ...} =>
[
   {
       title_key: k1,
       result_key: v1
   },
   {
       title_key: k2,
       result_key: v1
   }
   ...
]
Parámetros
json_result dict[str, Any] | str

Es el resultado JSON de key, value.

title_key str

Es la clave bajo la que se encontrará el nombre de cada clave.

result_key str

Es la clave con la que se mostrará el nombre de cada valor.

Ejemplos

El ejemplo predeterminado para el formato JSON del resultado de la entidad, donde title_key='Entity' y results_key='EntityResult', es el siguiente:

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

Devoluciones

(list[dict[str, Any]]) Es una lista de objetos de resultado JSON de la entidad.

Se genera el error

  • InternalJSONDecoderError: Si json_result es una cadena y no se pudo analizar en un diccionario con json.loads().
  • ValueError: Si json_result no es un dict (la verificación se realiza después de cargarlo desde una cadena, si es necesario).

TIPCommon.transformation.convert_list_to_comma_string

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

Convierte una lista de valores en una cadena separada por comas.

Parámetros
delimiter Delimitador que se usará en la cadena.
El valor predeterminado es ','.
values_list list

Es la lista de valores que se convertirán.

Devoluciones

Es la cadena separada por comas.

Tipo de datos que se muestra

str

TIPCommon.transformation.dict_to_flat

TIPCommon.transformation.dict_to_flat(target_dict)

Recibe un diccionario anidado y lo devuelve como un diccionario plano.

Parámetros
target_dict dict

Es el diccionario que se aplanará.

Devoluciones

Es el diccionario aplanado.

Tipo de datos que se muestra

dict

TIPCommon.transformation.flat_dict_to_csv

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

Convierte un diccionario plano en una lista de cadenas en formato CSV.

Los argumentos property_header y value_header se usan para personalizar el encabezado del CSV.

Parámetros
flat_dict dict

Es el diccionario que se convertirá al formato CSV.

property_header str

Es el encabezado de la columna de propiedad.
El valor predeterminado es Property.

value_header str

Es el encabezado de la columna de valores.
El valor predeterminado es Value.

Devoluciones

Es la lista de cadenas en formato CSV.

Tipo de datos que se muestra

list

TIPCommon.transformation.get_unicode

TIPCommon.transformation.get_unicode(value)

Obtiene el valor Unicode de un valor.

Parámetros
value Any

Es el valor que se convertirá en Unicode.

Devoluciones

Es la representación Unicode del valor.

Tipo de datos que se muestra

unicode (unicode)

TIPCommon.transformation.removeprefix

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

Es una implementación propia para str.removeprefix() que existe en Python 3.9 y versiones posteriores.

Si la cadena comienza con la cadena de prefijo, el método devuelve string[len(prefix):]. De lo contrario, devuelve una copia de la cadena original.

Parámetros
string str

Es la cadena de la que se quitará el prefijo.

prefix str

Es el prefijo que se quitará de la cadena.

Devoluciones

Es la cadena resultante.

TIPCommon.transformation.removesuffix

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

Es una implementación propia para str.removesuffix() que existe en Python 3.9 y versiones posteriores.

Si la cadena termina con la cadena de sufijo, el método devuelve string[:-len(prefix)]. De lo contrario, devuelve una copia de la cadena original.

Parámetros
string str

Es la cadena de la que se quitará el sufijo.

suffix str

Sufijo que se quitará de la cadena.

Devoluciones

Es la cadena resultante.

TIPCommon.transformation.rename_dict_key

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

Cambia el nombre de una clave en un diccionario.

Parámetros
a_dict dict

Es el diccionario en el que se cambiará el nombre de una clave.

current_key Hashable

Es la clave en a_dict a la que se le cambiará el nombre.

new_key Hashable

Es la clave a la que se le cambió el nombre.

TIPCommon.transformation.string_to_multi_value

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

Convierte una cadena que contiene una lista de valores separados por comas en una lista de valores.

Parámetros
string_value str

Es la cadena que se convertirá.

delimiter Optional

str

Delimitador para dividir la cadena.

El valor predeterminado es ','.

only_unique Optional

bool

Si se establece en True, el parámetro solo incluye valores únicos en la lista devuelta.

El valor predeterminado es False.

Devoluciones

Es la lista de valores.

Tipo de datos que se muestra

list

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.