glom

Restructuring data, the Python way.

glom is a new approach to working with data in Python, featuring:

• Path-based access for nested structures

• Declarative data transformation using lightweight, Pythonic specifications

• Readable, meaningful error messages

• Built-in debugging features

• Plus, deep assignment, streaming, data validation, and more!

While it may sound like a lot, glom’s straightforward approach becomes second-nature very quickly. Get started with a few minutes on the tutorial!

Installation

glom is pure Python, and tested on Python 3.7+, as well as PyPy3. Installation is easy:

pip install glom

Then you’re ready to get glomming!

from glom import glom

target = {'a': {'b': {'c': 'd'}}}
glom(target, 'a.b.c')  # returns 'd'

There’s much, much more to glom, check out the glom Tutorial and API reference!

Just glom it! ☄️

Learning glom

• glom Tutorial
• Frequently Asked Questions
• glom by Analogy
• Examples & Snippets
• glom Command-Line Interface

API Reference

• Core glom API
  • The glom Function
  • Basic Specifiers
  • Object-Oriented Access and Method Calls with T
  • Defaults with Coalesce
  • Calling Callables with Invoke
  • Self-Referential Specs
  • The glom Scope
  • Core Exceptions
  • Setup and Registration
• Assignment & Mutation
  • Assignment
  • Deletion
  • Exceptions
• Streaming & Iteration
  • Iter
• Reduction & Grouping
  • Combining iterables with Flatten and Merge
  • Exceptions
• Matching & Validation
  • Validation with Match
  • Optional and required dict key matching
  • M Expressions
  • Boolean operators and matching
  • String matching
  • Control flow with Switch
  • Exceptions
  • Validation with Check
• Exceptions & Debugging
  • Exceptions
  • Reading a glom Exception
  • Reading Branched Exceptions
  • Debugging

Extending glom

• Writing a custom Specifier Type
• glom Modes