"""

Anonymize the given string with special handling for eMail addresses and the possibility to truncate the output.

>>> anonymize('Foo Bar')

'Fxx_Xxr'

>>> anonymize('This is a Test 123 Foo Bar #+"-! End')

'Txxx_xx_x_Xxxx_###_Xxx_Xxx_______Xxd'

>>> anonymize('[email protected]')

'[email protected]'

>>> anonymize('[email protected]', handle_email=False)

'a_xxxx_xxxxxxx_xxxx_xxd'

>>> anonymize('[email protected]', max_length=10)

'a_xxxx_xx…'

"""

assert isinstance(value, str)

if handle_email and '@' in value:

value, at, domain = value.partition('@')

if len(value) < 2:

value = value + at + domain

value = value[:1] + _RE_OTHER.sub('@', value[1:-1].translate(_ANONYMIZATION_TRANS)) + value[-1:] + at + domain

else:

value = f'{value[:1]}{value[1:-1].translate(_ANONYMIZATION_TRANS)}{value[-1:]}'

if max_length is not None and max_length > 0:

return truncate(value, max_length)

data: dict,

secret_keys: frozenset[str] = frozenset({'secret', 'password', 'token'}), # These keys will be anonymized

max_length: int | None = None,

) -> dict:

"""

Returns a new dict with anonymized values for keys containing one of the given keywords.

>>> anonymize_dict({'client_id': '123', 'client_secret': 'This is really secret'})

{'client_id': '123', 'client_secret': 'Txxx_xx_xxxxxx_xxxxxt'}

>>> anonymize_dict({'client_id': '123', 'client_secret': 'This is really secret'}, frozenset({'Client_Secret'}))

{'client_id': '123', 'client_secret': 'Txxx_xx_xxxxxx_xxxxxt'}

>>> anonymize_dict({'client_id': '123', 'client_secret': 'This is really secret'}, frozenset({'Secret'}))

{'client_id': '123', 'client_secret': 'Txxx_xx_xxxxxx_xxxxxt'}

>>> anonymize_dict({'client_id': '123', 'client_secret': 'This is really secret'}, max_length=10)

{'client_id': '123', 'client_secret': 'Txxx_xx_x…'}

"""

anonymized_data = data.copy() # Don't modify the original data!

lowercase_secret_keys = [key.lower() for key in secret_keys]

for key, value in anonymized_data.items():

if value:

if isinstance(value, str) and any(k in key.lower() for k in lowercase_secret_keys):

anonymized_data[key] = anonymize(value, max_length=max_length)

elif isinstance(value, dict):

anonymized_data[key] = anonymize_dict(value, secret_keys, max_length=max_length)