Skip to main content

Access messy nested data structures

Project description

This module is intended to ease access to nested data structures—in any combination of key or attribue access to each level of a hierarchy—where many paths in the tree may be missing. Typically, such data is encountered in semi-structured formats like JSON, YAML, or some XML, that is deserialized into Python data structures.

PEP 505 attempts to address this need with the addition of a number of new syntactic operators for attribute or item access where a special type of failure mode “coalesces” None values. Other libraries such as PyMaybe ( perform a similar operation, and are more mature and robust.

On the other hand, by utilizing wrapt.ObjectProxy, this simple module manages to do some pretty neat stuff that even PyMaybe does not.

In this library, I simply want to provide simple wrapper classes that provide both what I think is more useful behavior and behavior that is semantically equivalent to PEP 505.



Wrap an object so that nested attribute and item access simply does not fail, but propagates a wrapped object across such nested access.


Wrap an object so that encountering a None (or other indicated sentinel) at any level stops accessing further attributes and unboxes as a None (or other sentinel).

Aliased as NoneCoalesce

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for coalescing, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size coalescing-0.1.1.tar.gz (2.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page