ConfigDict

class mmengine.config.ConfigDict(*args, **kwargs)

A dictionary for config which has the same interface as python’s built- in dictionary and can be used as a normal dictionary.

The Config class would transform the nested fields (dictionary-like fields) in config file into ConfigDict.

If the class attribute lazy is False, users will get the object built by LazyObject or LazyAttr, otherwise users will get the LazyObject or LazyAttr itself.

The lazy should be set to True to avoid building the imported object during configuration parsing, and it should be set to False outside the Config to ensure that users do not experience the LazyObject.

build_lazy(value)

If class attribute lazy is False, the LazyObject will be built and returned.

Parameters

value (Any) – The value to be built.

Returns

The built value.

Return type

Any

copy() → a shallow copy of D

get(key, default=None)

Get the value of the key. If class attribute lazy is True, the LazyObject will be built and returned.

Parameters

• key (str) – The key.

• default (any, optional) – The default value. Defaults to None.

Returns

The value of the key.

Return type

Any

items()

Yield the keys and values of the dictionary.

If class attribute lazy is False, the value of LazyObject or LazyAttr will be built and returned.

merge(other)

Merge another dictionary into current dictionary.

Parameters

other (dict) – Another dictionary.

pop(key, default=None)

Pop the value of the key. If class attribute lazy is True, the LazyObject will be built and returned.

Parameters

• key (str) – The key.

• default (any, optional) – The default value. Defaults to None.

Returns

The value of the key.

Return type

Any

to_dict()

Convert the ConfigDict to a normal dictionary recursively, and convert the LazyObject or LazyAttr to string.

update(*args, **kwargs)

Override this method to make sure the LazyObject will not be built during updating.

Return type

None

values()

Yield the values of the dictionary.

If class attribute lazy is False, the value of LazyObject or LazyAttr will be built and returned.