Awesome Open Source
Awesome Open Source


|Version| |Status| |Coverage| |License|

FlatDict and FlatterDict are a dict classes that allows for single level, delimited key/value pair mapping of nested dictionaries. You can interact with FlatDict and FlatterDict like a normal dictionary and access child dictionaries as you normally would or with the composite key.

For example:

.. code-block:: python

value = flatdict.FlatDict({'foo': {'bar': 'baz', 'qux': 'corge'}})

would be the same as:

.. code-block:: python

value == {'foo:bar': 'baz', 'foo:qux': 'corge'}

values can be accessed as:

.. code-block:: python


# or


Additionally, lists and tuples are also converted into dicts using enumerate(), using the FlatterDict class.

For example:

.. code-block:: python

value = flatdict.FlatterDict({'list': ['a', 'b', 'c']})

will be the same as:

.. code-block:: python

value == {'list:0': 'a', 'list:1': 'b', 'list:2': 'c'}


Documentation is available at


This package attempts to use semantic versioning. API changes are indicated by the major version, non-breaking improvements by the minor, and bug fixes in the revision.

It is recommended that you pin your targets to greater or equal to the current version and less than the next major version.


.. code-block:: bash

$ pip install flatdict

Note that as of 4.0, setuptools 39.2 or higher is required for installation.

.. |Version| image:: :target:

.. |Status| image:: :target: :alt: Build Status

.. |Coverage| image:: :target:

.. |License| image:: :target:

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (52,053
hacktoberfest (4,195
python3 (1,572
dict (23

Find Open Source By Browsing 7,000 Topics Across 59 Categories