pg.object_utils#

Utility library that provides common traits for objects in Python.

Overview#

pg.object_utils sits at the bottom of all PyGlove modules and empowers other modules with the following features:

Functionality

API

Formatting

pg.Formattable,

pg.format,

pg.print,

pg.object_utils.kvlist_str,

pg.object_utils.quote_if_str,

pg.object_utils.message_on_path

Serialization

pg.JSONConvertible,

pg.registered_types,

pg.object_utils.to_json,

pg.object_utils.from_json,

Partial construction

pg.MaybePartial,

pg.MISSING_VALUE.

Hierarchical key representation

pg.KeyPath

Hierarchical object traversal

pg.object_utils.traverse

Hierarchical object transformation

pg.object_utils.transform,

pg.object_utils.merge,

pg.object_utils.canonicalize,

pg.object_utils.flatten

Code generation

pg.object_utils.make_function

Docstr handling

pg.docstr,

Error handling | pg.catch_errors,

Objects#

MISSING_VALUE

Classes#