scitex_core.dict

Scitex Core dict module.

class scitex_core.dict.DotDict(dictionary=None)

Bases: object

A dictionary-like object that allows attribute-like access (for valid identifier keys) and standard item access for all keys (including integers, etc.).

__bool__()

Truth value testing. Empty DotDict is False, non-empty is True.

__contains__(key)

Checks if the dotdict contains the specified key.

__dir__()

Provides attribute suggestions for dir() and tab completion. Includes both standard methods/attributes and the keys stored in _data.

__eq__(other)

Check equality. Supports comparison with dict, DotDict, and scalar values.

__ge__(other)

Greater than or equal.

__gt__(other)

Greater than comparison - delegate to _data or handle scalars.

__init__(dictionary=None)

__iter__()

Returns an iterator over the keys of the dictionary.

__le__(other)

Less than or equal.

__len__()

Returns the number of key-value pairs in the dictionary.

__lt__(other)

Less than comparison - delegate to _data or handle scalars.

__ne__(other)

Check inequality.

__repr__()

Returns a string representation suitable for debugging. Shows the class name and the internal data representation.

__str__()

Returns a string representation, handling non-JSON-serializable objects.

copy()

Creates a shallow copy of the DotDict object. Nested DotDicts/dicts/lists will be references, not copies. Use deepcopy for a fully independent copy.

get(key, default=None)

items()

Returns a view object displaying a list of all the items (key, value pairs).

keys()

Returns a view object displaying a list of all the keys.

pop(key, *args)

Removes the specified key and returns the corresponding value. If key is not found, default is returned if given, otherwise KeyError is raised. Accepts optional default value like dict.pop.

setdefault(key, default=None)

Returns the value of the given key. If the key does not exist, insert the key with the specified default value and return the default value.

to_dict()

Recursively converts DotDict and nested DotDict objects back to ordinary dictionaries.

update(dictionary)

Updates the dictionary with the key-value pairs from another dictionary or iterable.

values()

Returns a view object displaying a list of all the values.

scitex_core.dict.listed_dict(keys=None)

Example 1:

import random random.seed(42) d = listed_dict() for _ in range(10):

d[‘a’].append(random.randint(0, 10))

print(d) # defaultdict(<class ‘list’>, {‘a’: [10, 1, 0, 4, 3, 3, 2, 1, 10, 8]})

Example 2:

import random random.seed(42) keys = [‘a’, ‘b’, ‘c’] d = listed_dict(keys) for _ in range(10):

d[‘a’].append(random.randint(0, 10)) d[‘b’].append(random.randint(0, 10)) d[‘c’].append(random.randint(0, 10))

print(d) # defaultdict(<class ‘list’>, {‘a’: [10, 4, 2, 8, 6, 1, 8, 8, 8, 7], # ‘b’: [1, 3, 1, 1, 0, 3, 9, 3, 6, 9], # ‘c’: [0, 3, 10, 9, 0, 3, 0, 10, 3, 4]})

scitex_core.dict.pop_keys(keys_list, keys_to_pop)

Remove specified keys from a list of keys.

Parameters:

• keys_list (list) – The original list of keys.

• keys_to_pop (list) – The list of keys to remove from keys_list.

Returns:

A new list with the specified keys removed.

Return type:

list

Example

>>> keys_list = ['a', 'b', 'c', 'd', 'e', 'bde']
>>> keys_to_pop = ['b', 'd']
>>> pop_keys(keys_list, keys_to_pop)
['a', 'c', 'e', 'bde']

scitex_core.dict.replace(string, dict)

scitex_core.dict.safe_merge(*dicts)

Merges dictionaries while checking for key conflicts.

Example

>>> dict1 = {'a': 1, 'b': 2}
>>> dict2 = {'c': 3, 'd': 4}
>>> safe_merge(dict1, dict2)
{'a': 1, 'b': 2, 'c': 3, 'd': 4}

Parameters:

*dicts (Dict[_Any, _Any]) – Variable number of dictionaries to merge

Returns:

Merged dictionary

Return type:

Dict[_Any, _Any]

Raises:

ValueError – If overlapping keys are found between dictionaries

scitex_core.dict.to_str(dictionary, delimiter='_')

Convert a dictionary to a string representation.

Example

input_dict = {‘a’: 1, ‘b’: 2, ‘c’: 3} result = dict2str(input_dict) print(result) # Output: a-1_b-2_c-3

Parameters:

• dictionary (dict) – The input dictionary to be converted.

• delimiter (str, optional) – The separator between key-value pairs (default is “_”).

Returns:

A string representation of the input dictionary.

Return type:

str

scitex_core.dict.flatten(nested_dict, parent_key='', sep='_')