Módulo de transformación

TIPCommon.transformation.add_prefix_to_dict

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

Añade un prefijo a las claves de un diccionario determinado.

Parámetros

Parámetros
given_dict dict

El diccionario al que se añadirá el prefijo.

prefix str

El prefijo aplicado a las claves del diccionario.

Devoluciones

El diccionario con el prefijo añadido a las claves.

Tipo de devolución

dict

TIPCommon.transformation.add_prefix_to_dict_keys

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

Añade un prefijo a las claves de un diccionario determinado.

Parámetros

Parámetros
target_dict dict

El diccionario al que se añadirá el prefijo.

prefix str

El prefijo aplicado a las claves del diccionario.

Devoluciones

El diccionario con el prefijo añadido a las claves.

Tipo de devolución

dict

TIPCommon.transformation.adjust_to_csv

TIPCommon.transformation.adjust_to_csv(value)

Ajusta un valor para que se pueda incluir en un archivo CSV.

Parámetros
value Any

Valor que se va a ajustar.

Devoluciones

Valor ajustado.

Tipo de devolución

str

TIPCommon.transformation.construct_csv

TIPCommon.transformation.construct_csv(list_of_dicts)

Crea un archivo CSV a partir de una lista de diccionarios.

Parámetros
list_of_dicts list[dict]

Lista de diccionarios que se añadirán al archivo CSV.

Devoluciones

La lista en formato CSV.

Tipo de devolución

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

Cadena separada por comas que se va a convertir.

Devoluciones

Lista de valores.

Tipo de devolución

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 determinado.

A continuación se muestra 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

El resultado JSON key, value.

title_key str

La clave en la que se incluirá el nombre de cada clave.

result_key str

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

Ejemplos

El ejemplo predeterminado del formato JSON de resultado de entidad donde title_key='Entity', 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]]) Lista de objetos JSON de resultados de entidades

Aumentos

  • InternalJSONDecoderError – si json_result es una cadena y no se ha podido analizar como diccionario con json.loads().
  • ValueError: si json_result no es un dict (la comprobació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 va a usar en la cadena.
El valor predeterminado es ','.
values_list list

Lista de valores que se van a convertir.

Devoluciones

Cadena separada por comas.

Tipo de devolución

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

El diccionario que se va a combinar.

Devoluciones

El diccionario aplanado.

Tipo de devolución

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 archivo CSV.

Parámetros
flat_dict dict

El diccionario que se va a convertir al formato CSV.

property_header str

Encabezado de la columna de la propiedad.
El valor predeterminado es Property.

value_header str

Encabezado de la columna de valores.
El valor predeterminado es Value.

Devoluciones

La lista de cadenas en formato CSV.

Tipo de devolución

list

TIPCommon.transformation.get_unicode

TIPCommon.transformation.get_unicode(value)

Obtiene el unicode de un valor.

Parámetros
value Any

Valor que se va a convertir en Unicode.

Devoluciones

Representación Unicode del valor.

Tipo de devolución

unicode (unicode)

TIPCommon.transformation.removeprefix

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

Implementación automática de str.removeprefix() que existe en Python 3.9 y versiones posteriores.

Si la cadena empieza por 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

Cadena de la que se va a quitar el prefijo.

prefix str

Prefijo que se va a quitar de la cadena.

Devoluciones

La cadena resultante.

TIPCommon.transformation.removesuffix

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

Implementación automática de 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

Cadena de la que se va a quitar el sufijo.

suffix str

Sufijo que se va a quitar de la cadena.

Devoluciones

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 de un diccionario.

Parámetros
a_dict dict

El diccionario en el que se va a cambiar el nombre de una clave.

current_key Hashable

Es la clave de a_dict cuyo nombre se va a cambiar.

new_key Hashable

La clave cuyo nombre se ha cambiado.

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

La cadena que se va a convertir.

delimiter Optional

str

Delimitador por el que se va a dividir la cadena.

El valor predeterminado es ',' (ADMITE VALORES NULL).

only_unique Optional

bool

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

El valor predeterminado es False (ADMITE VALORES NULL).

Devoluciones

Lista de valores.

Tipo de devolución

list

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.